{ "aboutHtml": "

Rýchly variant H3 upravený dodatočným tréningom

MiniMax H3 Max je variant základného modelu MiniMax H3 upravený dodatočným tréningom, optimalizovaný na rýchlejšie generovanie, dodržiavanie zadania a audiovizuálnu kvalitu. Variant vyvinul fal Research prostredníctvom dodatočného tréningu. Zachováva jednotný multimodálny kontext a natívne synchronizovaný obraz a zvuk. Rýchlosť je prioritou návrhu, nie pevnou dobou dokončenia pre každé zadanie, dĺžku či aplikáciu.

Rozlišujte Max od pôvodného systému H3 aj od samostatného variantu Max Turbo. Aktuálne rozhranie MiniMax uvádza pre Max rozlíšenie 480P alebo 768P, predvolené 768P, 24 snímok za sekundu a celočíselnú dĺžku od 5 do 15 sekúnd. Jeho dokumentovaný postup pre Max neponúka rozlíšenie 2K pôvodného systému H3 ani štvorsekundový výstup.

Od zadania k záberu

Každé generovanie obsahuje neprázdne textové zadanie, najviac 7 000 znakov na jednu textovú položku. Opíšte subjekt, úvodnú kompozíciu, akciu a výsledok, potom jasne určte pokyny pre kameru a zvuk. Pri krátkom odhalení predmetu určte, čo má divák vidieť ako prvé, ako sa predmet dostane do záberu a ako sa má záber skončiť.

Užitočné päťsekundové zadanie môže opisovať keramickú šálku na drevenom stole, ruku ukladajúcu vedľa nej tanierik, mierny nájazd kamery a zvuk keramiky pri dotyku s drevom. Akciu udržte dostatočne jednoduchú, aby sa zmestila do zvolenej dĺžky, a overte, či výsledný pohyb a zvuk sledujú tú istú udalosť.

Tvorba vedená snímkami

Výrobca dokumentuje úvodnú snímku, záverečnú snímku alebo obe. Prvý obrázok určuje začiatok klipu; posledný obrázok určuje konečný vizuálny stav. Vysvetlite pohyb, ktorý ich spája, vrátane zmien pózy, polohy predmetu, kamery alebo osvetlenia. Pri prechode medzi dvoma snímkami sa vyhnite zadaniu, ktoré medzi koncovými bodmi zavádza nezlučiteľnú scénu.

Výstup vedený snímkami odvodzuje pomer strán od vstupného obrázka. Pri práci iba s textom zvoľte konkrétny pomer 21:9, 16:9, 4:3, 1:1, 3:4 alebo 9:16. Práca vedená referenciami môže použiť adaptívny pomer alebo jednu z dokumentovaných explicitných možností. Referenciu alebo písanú scénu komponujte pre cieľový formát namiesto predpokladu, že rovnaké usporiadanie funguje rovnako dobre na výšku aj na šírku.

Multimodálne referencie

Aktuálna schéma generovania Max od MiniMax dokumentuje aj referenčné obrázky, video a zvuk. Uveďte, čo má každý podklad ovplyvniť: identitu postavy, prostredie, pohybový vzor, dráhu kamery, farbu hlasu alebo zvukovú vlastnosť. Úlohy prvej/poslednej snímky a referenčných médií sa v tomto rozhraní vzájomne vylučujú.

Pri zábere postavy určte referenciu vzhľadu a referenciu pohybu oddelene a potom zadajte cieľovú akciu a hovorenú repliku. Hlasová referencia určujúca spôsob prednesu sa líši od kopírovania celého zvukového signálu. V zadaní jasne určte vlastnosti, ktoré treba zachovať, a zmeny, ktoré treba vykonať, a skutočný audiovizuálny klip porovnajte s každou úlohou referencie.

Rozšírenie zadania

Nastavenie rozšírenia špecifické pre Max ponúka možnosti disabled, balanced a quality, pričom predvolená je balanced. Zvoľte disabled, keď má dodané zadanie prejsť bez rozšírenia; dokumentovaný režim rozšírenia použite, keď je žiaduca dodatočná interpretácia. Uchovajte pôvodné zadanie, aby bolo možné odlíšiť zmenu zavedenú pri rozšírení od požadovaného obsahu.

Zvuk opíšte ako súčasť scény. Určte fyzické zvuky, atmosféru a všetky hovorené slová a oddeľte ich od hudobného podkladu počuteľného iba pre publikum. Uveďte presnú repliku a zamýšľaného hovoriaceho namiesto požiadavky na neurčený dialóg. Výsledok si vypočujte aj pozrite; presvedčivý obraz nepotvrdzuje správnosť hovoreného znenia ani časovania.

Príprava vstupov a limity

Aktuálna schéma výrobcu prijíma obrázky JPG, JPEG, PNG, WebP, HEIC alebo HEIF, každý najviac 30 MB, so stranami od 256 do 5 760 pixelov a pomerom strán od 0.4 do 2.5. Úvodná aj záverečná úloha povoľujú po jednom obrázku; referenčný režim povoľuje až deväť obrázkov. Zachovajte jasný pohľad na subjekt a detaily, ktoré musia zostať identifikovateľné.

Referenčné video povoľuje až tri klipy MP4 alebo MOV, každý v dĺžke 2–15 sekúnd a spolu najviac 15 sekúnd, s limitom 50 MB na súbor. Dokumentuje video H.264 alebo H.265, zvuk AAC alebo MP3, strany od 256 do 5 760 pixelov, pomer strán od 0.4 do 2.5 a snímkovú frekvenciu od 23.976 do 60. Referenčný zvuk povoľuje až tri klipy WAV alebo MP3, každý najviac 15 MB a 2–15 sekúnd, spolu najviac 15 sekúnd. Telo požiadavky má samostatný limit 64 MB.

Používajte iba referencie, ktoré prispievajú k záberu, a každý príspevok určte v texte. Krátky relevantný klip pohybu je ako usmernenie užitočnejší než dlhá zbierka nesúvisiacich udalostí. Zamýšľanú dĺžku a výstupné rozlíšenie uveďte výslovne, aby sa výsledok dal porovnať s tým istým zadaním.

Dokončený výsledok

Asynchrónny postup výrobcu vracia identitu úlohy skôr, než je dostupné dokončené video. Jeho rozhranie na zisťovanie stavu úloh načítava úlohy z predchádzajúcich siedmich dní. Pre úpravy alebo ďalšie posudzovanie si uložte skutočný výsledný klip aj jeho špecifikáciu; identifikátor úlohy nie je audiovizuálny výstup. Adresy na stiahnutie sú časovo obmedzené, preto pri uchovaní vybraného výsledku uložte samotný súbor.

Kontrolujte kontinuitu subjektu, pohyb, viditeľný text, dialóg a časovanie zvuku vo veľkosti, v akej sa bude klip používať. Pre ďalšie tvorivé zadanie použite konkrétnu spätnú väzbu: gesto, ktoré sa zmenilo, vynechanú repliku alebo kompozíciu vyžadujúcu úpravu. Užitočným výsledkom je krátky audiovizuálny záber naviazaný na dodaný obsah a jeho výslovné referenčné vzťahy.

", "aboutText": "Rýchly variant H3 upravený dodatočným tréningom\n\nMiniMax H3 Max je variant základného modelu MiniMax H3 upravený dodatočným tréningom, optimalizovaný na rýchlejšie generovanie, dodržiavanie zadania a audiovizuálnu kvalitu. Variant vyvinul fal Research prostredníctvom dodatočného tréningu. Zachováva jednotný multimodálny kontext a natívne synchronizovaný obraz a zvuk. Rýchlosť je prioritou návrhu, nie pevnou dobou dokončenia pre každé zadanie, dĺžku či aplikáciu.\n\nRozlišujte Max od pôvodného systému H3 aj od samostatného variantu Max Turbo. Aktuálne rozhranie MiniMax uvádza pre Max rozlíšenie 480P alebo 768P, predvolené 768P, 24 snímok za sekundu a celočíselnú dĺžku od 5 do 15 sekúnd. Jeho dokumentovaný postup pre Max neponúka rozlíšenie 2K pôvodného systému H3 ani štvorsekundový výstup.\n\nOd zadania k záberu\n\nKaždé generovanie obsahuje neprázdne textové zadanie, najviac 7 000 znakov na jednu textovú položku. Opíšte subjekt, úvodnú kompozíciu, akciu a výsledok, potom jasne určte pokyny pre kameru a zvuk. Pri krátkom odhalení predmetu určte, čo má divák vidieť ako prvé, ako sa predmet dostane do záberu a ako sa má záber skončiť.\n\nUžitočné päťsekundové zadanie môže opisovať keramickú šálku na drevenom stole, ruku ukladajúcu vedľa nej tanierik, mierny nájazd kamery a zvuk keramiky pri dotyku s drevom. Akciu udržte dostatočne jednoduchú, aby sa zmestila do zvolenej dĺžky, a overte, či výsledný pohyb a zvuk sledujú tú istú udalosť.\n\nTvorba vedená snímkami\n\nVýrobca dokumentuje úvodnú snímku, záverečnú snímku alebo obe. Prvý obrázok určuje začiatok klipu; posledný obrázok určuje konečný vizuálny stav. Vysvetlite pohyb, ktorý ich spája, vrátane zmien pózy, polohy predmetu, kamery alebo osvetlenia. Pri prechode medzi dvoma snímkami sa vyhnite zadaniu, ktoré medzi koncovými bodmi zavádza nezlučiteľnú scénu.\n\nVýstup vedený snímkami odvodzuje pomer strán od vstupného obrázka. Pri práci iba s textom zvoľte konkrétny pomer 21:9, 16:9, 4:3, 1:1, 3:4 alebo 9:16. Práca vedená referenciami môže použiť adaptívny pomer alebo jednu z dokumentovaných explicitných možností. Referenciu alebo písanú scénu komponujte pre cieľový formát namiesto predpokladu, že rovnaké usporiadanie funguje rovnako dobre na výšku aj na šírku.\n\nMultimodálne referencie\n\nAktuálna schéma generovania Max od MiniMax dokumentuje aj referenčné obrázky, video a zvuk. Uveďte, čo má každý podklad ovplyvniť: identitu postavy, prostredie, pohybový vzor, dráhu kamery, farbu hlasu alebo zvukovú vlastnosť. Úlohy prvej/poslednej snímky a referenčných médií sa v tomto rozhraní vzájomne vylučujú.\n\nPri zábere postavy určte referenciu vzhľadu a referenciu pohybu oddelene a potom zadajte cieľovú akciu a hovorenú repliku. Hlasová referencia určujúca spôsob prednesu sa líši od kopírovania celého zvukového signálu. V zadaní jasne určte vlastnosti, ktoré treba zachovať, a zmeny, ktoré treba vykonať, a skutočný audiovizuálny klip porovnajte s každou úlohou referencie.\n\nRozšírenie zadania\n\nNastavenie rozšírenia špecifické pre Max ponúka možnosti disabled, balanced a quality, pričom predvolená je balanced. Zvoľte disabled, keď má dodané zadanie prejsť bez rozšírenia; dokumentovaný režim rozšírenia použite, keď je žiaduca dodatočná interpretácia. Uchovajte pôvodné zadanie, aby bolo možné odlíšiť zmenu zavedenú pri rozšírení od požadovaného obsahu.\n\nZvuk opíšte ako súčasť scény. Určte fyzické zvuky, atmosféru a všetky hovorené slová a oddeľte ich od hudobného podkladu počuteľného iba pre publikum. Uveďte presnú repliku a zamýšľaného hovoriaceho namiesto požiadavky na neurčený dialóg. Výsledok si vypočujte aj pozrite; presvedčivý obraz nepotvrdzuje správnosť hovoreného znenia ani časovania.\n\nPríprava vstupov a limity\n\nAktuálna schéma výrobcu prijíma obrázky JPG, JPEG, PNG, WebP, HEIC alebo HEIF, každý najviac 30 MB, so stranami od 256 do 5 760 pixelov a pomerom strán od 0.4 do 2.5. Úvodná aj záverečná úloha povoľujú po jednom obrázku; referenčný režim povoľuje až deväť obrázkov. Zachovajte jasný pohľad na subjekt a detaily, ktoré musia zostať identifikovateľné.\n\nReferenčné video povoľuje až tri klipy MP4 alebo MOV, každý v dĺžke 2–15 sekúnd a spolu najviac 15 sekúnd, s limitom 50 MB na súbor. Dokumentuje video H.264 alebo H.265, zvuk AAC alebo MP3, strany od 256 do 5 760 pixelov, pomer strán od 0.4 do 2.5 a snímkovú frekvenciu od 23.976 do 60. Referenčný zvuk povoľuje až tri klipy WAV alebo MP3, každý najviac 15 MB a 2–15 sekúnd, spolu najviac 15 sekúnd. Telo požiadavky má samostatný limit 64 MB.\n\nPoužívajte iba referencie, ktoré prispievajú k záberu, a každý príspevok určte v texte. Krátky relevantný klip pohybu je ako usmernenie užitočnejší než dlhá zbierka nesúvisiacich udalostí. Zamýšľanú dĺžku a výstupné rozlíšenie uveďte výslovne, aby sa výsledok dal porovnať s tým istým zadaním.\n\nDokončený výsledok\n\nAsynchrónny postup výrobcu vracia identitu úlohy skôr, než je dostupné dokončené video. Jeho rozhranie na zisťovanie stavu úloh načítava úlohy z predchádzajúcich siedmich dní. Pre úpravy alebo ďalšie posudzovanie si uložte skutočný výsledný klip aj jeho špecifikáciu; identifikátor úlohy nie je audiovizuálny výstup. Adresy na stiahnutie sú časovo obmedzené, preto pri uchovaní vybraného výsledku uložte samotný súbor.\n\nKontrolujte kontinuitu subjektu, pohyb, viditeľný text, dialóg a časovanie zvuku vo veľkosti, v akej sa bude klip používať. Pre ďalšie tvorivé zadanie použite konkrétnu spätnú väzbu: gesto, ktoré sa zmenilo, vynechanú repliku alebo kompozíciu vyžadujúcu úpravu. Užitočným výsledkom je krátky audiovizuálny záber naviazaný na dodaný obsah a jeho výslovné referenčné vzťahy.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "6833e8d33abf31de715bffbdf48af8da82dab4fbab58e95aa5220f67722764ab", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sk", "methods": [ { "html": "
MM

MiniMax: H3 Max

MiniMax /minimax/hailuo-3-max

Úvod

MiniMax H3 Max je rýchly variant H3 upravený dodatočným tréningom na krátke video so synchronizovaným zvukom. Dokumentovaný postup MiniMax podporuje text, snímky a multimodálne referencie, výstup 480P alebo 768P, dĺžku 5–15 sekúnd a vlastné možnosti rozšírenia zadania.

Povolené vstupy
Text · Obrázky
Výsledky
Video
O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Rýchly variant H3 upravený dodatočným tréningom

MiniMax H3 Max je variant základného modelu MiniMax H3 upravený dodatočným tréningom, optimalizovaný na rýchlejšie generovanie, dodržiavanie zadania a audiovizuálnu kvalitu. Variant vyvinul fal Research prostredníctvom dodatočného tréningu. Zachováva jednotný multimodálny kontext a natívne synchronizovaný obraz a zvuk. Rýchlosť je prioritou návrhu, nie pevnou dobou dokončenia pre každé zadanie, dĺžku či aplikáciu.

Rozlišujte Max od pôvodného systému H3 aj od samostatného variantu Max Turbo. Aktuálne rozhranie MiniMax uvádza pre Max rozlíšenie 480P alebo 768P, predvolené 768P, 24 snímok za sekundu a celočíselnú dĺžku od 5 do 15 sekúnd. Jeho dokumentovaný postup pre Max neponúka rozlíšenie 2K pôvodného systému H3 ani štvorsekundový výstup.

Od zadania k záberu

Každé generovanie obsahuje neprázdne textové zadanie, najviac 7 000 znakov na jednu textovú položku. Opíšte subjekt, úvodnú kompozíciu, akciu a výsledok, potom jasne určte pokyny pre kameru a zvuk. Pri krátkom odhalení predmetu určte, čo má divák vidieť ako prvé, ako sa predmet dostane do záberu a ako sa má záber skončiť.

Užitočné päťsekundové zadanie môže opisovať keramickú šálku na drevenom stole, ruku ukladajúcu vedľa nej tanierik, mierny nájazd kamery a zvuk keramiky pri dotyku s drevom. Akciu udržte dostatočne jednoduchú, aby sa zmestila do zvolenej dĺžky, a overte, či výsledný pohyb a zvuk sledujú tú istú udalosť.

Tvorba vedená snímkami

Výrobca dokumentuje úvodnú snímku, záverečnú snímku alebo obe. Prvý obrázok určuje začiatok klipu; posledný obrázok určuje konečný vizuálny stav. Vysvetlite pohyb, ktorý ich spája, vrátane zmien pózy, polohy predmetu, kamery alebo osvetlenia. Pri prechode medzi dvoma snímkami sa vyhnite zadaniu, ktoré medzi koncovými bodmi zavádza nezlučiteľnú scénu.

Výstup vedený snímkami odvodzuje pomer strán od vstupného obrázka. Pri práci iba s textom zvoľte konkrétny pomer 21:9, 16:9, 4:3, 1:1, 3:4 alebo 9:16. Práca vedená referenciami môže použiť adaptívny pomer alebo jednu z dokumentovaných explicitných možností. Referenciu alebo písanú scénu komponujte pre cieľový formát namiesto predpokladu, že rovnaké usporiadanie funguje rovnako dobre na výšku aj na šírku.

Multimodálne referencie

Aktuálna schéma generovania Max od MiniMax dokumentuje aj referenčné obrázky, video a zvuk. Uveďte, čo má každý podklad ovplyvniť: identitu postavy, prostredie, pohybový vzor, dráhu kamery, farbu hlasu alebo zvukovú vlastnosť. Úlohy prvej/poslednej snímky a referenčných médií sa v tomto rozhraní vzájomne vylučujú.

Pri zábere postavy určte referenciu vzhľadu a referenciu pohybu oddelene a potom zadajte cieľovú akciu a hovorenú repliku. Hlasová referencia určujúca spôsob prednesu sa líši od kopírovania celého zvukového signálu. V zadaní jasne určte vlastnosti, ktoré treba zachovať, a zmeny, ktoré treba vykonať, a skutočný audiovizuálny klip porovnajte s každou úlohou referencie.

Rozšírenie zadania

Nastavenie rozšírenia špecifické pre Max ponúka možnosti disabled, balanced a quality, pričom predvolená je balanced. Zvoľte disabled, keď má dodané zadanie prejsť bez rozšírenia; dokumentovaný režim rozšírenia použite, keď je žiaduca dodatočná interpretácia. Uchovajte pôvodné zadanie, aby bolo možné odlíšiť zmenu zavedenú pri rozšírení od požadovaného obsahu.

Zvuk opíšte ako súčasť scény. Určte fyzické zvuky, atmosféru a všetky hovorené slová a oddeľte ich od hudobného podkladu počuteľného iba pre publikum. Uveďte presnú repliku a zamýšľaného hovoriaceho namiesto požiadavky na neurčený dialóg. Výsledok si vypočujte aj pozrite; presvedčivý obraz nepotvrdzuje správnosť hovoreného znenia ani časovania.

Príprava vstupov a limity

Aktuálna schéma výrobcu prijíma obrázky JPG, JPEG, PNG, WebP, HEIC alebo HEIF, každý najviac 30 MB, so stranami od 256 do 5 760 pixelov a pomerom strán od 0.4 do 2.5. Úvodná aj záverečná úloha povoľujú po jednom obrázku; referenčný režim povoľuje až deväť obrázkov. Zachovajte jasný pohľad na subjekt a detaily, ktoré musia zostať identifikovateľné.

Referenčné video povoľuje až tri klipy MP4 alebo MOV, každý v dĺžke 2–15 sekúnd a spolu najviac 15 sekúnd, s limitom 50 MB na súbor. Dokumentuje video H.264 alebo H.265, zvuk AAC alebo MP3, strany od 256 do 5 760 pixelov, pomer strán od 0.4 do 2.5 a snímkovú frekvenciu od 23.976 do 60. Referenčný zvuk povoľuje až tri klipy WAV alebo MP3, každý najviac 15 MB a 2–15 sekúnd, spolu najviac 15 sekúnd. Telo požiadavky má samostatný limit 64 MB.

Používajte iba referencie, ktoré prispievajú k záberu, a každý príspevok určte v texte. Krátky relevantný klip pohybu je ako usmernenie užitočnejší než dlhá zbierka nesúvisiacich udalostí. Zamýšľanú dĺžku a výstupné rozlíšenie uveďte výslovne, aby sa výsledok dal porovnať s tým istým zadaním.

Dokončený výsledok

Asynchrónny postup výrobcu vracia identitu úlohy skôr, než je dostupné dokončené video. Jeho rozhranie na zisťovanie stavu úloh načítava úlohy z predchádzajúcich siedmich dní. Pre úpravy alebo ďalšie posudzovanie si uložte skutočný výsledný klip aj jeho špecifikáciu; identifikátor úlohy nie je audiovizuálny výstup. Adresy na stiahnutie sú časovo obmedzené, preto pri uchovaní vybraného výsledku uložte samotný súbor.

Kontrolujte kontinuitu subjektu, pohyb, viditeľný text, dialóg a časovanie zvuku vo veľkosti, v akej sa bude klip používať. Pre ďalšie tvorivé zadanie použite konkrétnu spätnú väzbu: gesto, ktoré sa zmenilo, vynechanú repliku alebo kompozíciu vyžadujúcu úpravu. Užitočným výsledkom je krátky audiovizuálny záber naviazaný na dodaný obsah a jeho výslovné referenčné vzťahy.

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Video POST /v1/videos
Vstup
text, image
Výstup
video
Výstupný formát
pôvodné bajty MP4; bez normalizácie a prekódovania
PoleTypPožiadavkaHodnoty a limityPredvolené
PolemodelTypstringPožiadavkaPovinnéHodnoty a limity
minimax/hailuo-3-max
Predvolené—
PolepromptTypstringPožiadavkaPovinnéHodnoty a limityPredvolené—
PoledurationTypintegerPožiadavkaPovinnéHodnoty a limity
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maximum: 600
Predvolené—
PoleresolutionTypstringPožiadavkaVoliteľnéHodnoty a limity
768p, 480p
Predvolené—
Poleaspect_ratioTypstringPožiadavkaVoliteľnéHodnoty a limity
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Predvolené—
Polegenerate_audioTypbooleanPožiadavkaVoliteľnéHodnoty a limity
false
Predvolené—
Poleframe_imagesTyparrayPožiadavkaVoliteľnéHodnoty a limity
Minimálny počet položiek: 1
Maximálny počet položiek: 2
Vstupný obsah: Pole objektov snímok. Každý objekt má type=image_url, image_url obsahujúce url a frame_type. Použite HTTPS URL obrázka a nastavte frame_type na first_frame alebo last_frame. Každá rola snímky sa môže vyskytnúť najviac raz.
Presné kľúče: type, image_url, frame_type
Podmienky: Tieto kľúče opisujú každý objekt snímky; image_url obsahuje iba url. Pri čisto textovej požiadavke vynechajte frame_images.
Predvolené—
Poleinput_referencesTyparrayPožiadavkaVoliteľnéHodnoty a limityPredvolené—
Polecallback_urlTypstringPožiadavkaVoliteľnéHodnoty a limity
Vzor: ^https://
Predvolené—
Polesession_idTypstringPožiadavkaVoliteľnéHodnoty a limityPredvolené—
PoletraceTypobjectPožiadavkaVoliteľnéHodnoty a limityPredvolené—
PoleuserTypstringPožiadavkaVoliteľnéHodnoty a limityPredvolené—
Kombinácie vstupných podkladov

Z textu na video · Textové zadanie. · Povinné: model, prompt, duration

Zadajte prompt ako text a duration v celých sekundách. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.

model: Typ: string · minimax/hailuo-3-max

prompt: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno

Z obrázka na video · Textové zadanie a obrázok prvej snímky. · Povinné: model, prompt, duration, frame_images

frame_images je pole. Každý objekt snímky má type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použite first_frame s voliteľným last_frame. Každá rola snímky sa môže vyskytnúť najviac raz. Pre každú snímku zadajte verejnú HTTPS URL obrázka. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.

Presné kľúče: type, image_url, frame_type

model: Typ: string · minimax/hailuo-3-max

prompt: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno

Parametre a životný cyklus metódy
ParameterŠpecifikácia
Parametercontent_typeŠpecifikáciaapplication/json
ParameterrequiredŠpecifikáciamodel, prompt, duration
Parametermaterial_typesŠpecifikáciatext, image
Parameteradditional_propertiesŠpecifikáciafalse
Parameteroptional_controlsŠpecifikáciaresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

Životný cyklus: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim
Neuvedené Keď je zvolený rýchly režim
Režim Flex
Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania
Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

KonfiguráciaSadzobníkOdhadované množstvoKomponent poplatkuÚčtovacia jednotkaPodmienky účtovaniaPoplatok
KonfiguráciaZákladné sadzby za tokenySadzobníkZákladná sadzbaOdhadované množstvo—Komponent poplatku—Účtovacia jednotka—Podmienky účtovania—Poplatok
Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov
Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov
Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov
Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov
Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaVýstup videa · referenčná sadzbaSadzobník—Odhadované množstvo—Komponent poplatkureference_output_rateÚčtovacia jednotkaza sekundu výstupuPodmienky účtovania—Poplatok
Výstup · Referenčná sadzba za sekundu výstupného videa · Odhad iba na porovnanie $0.16 za sekundu výstupu
KonfiguráciaCena videaSadzobník—Odhadované množstvo—Komponent poplatku—Účtovacia jednotkaza sekundu videaPodmienky účtovaniaresolution: 480pPoplatok
Výstup · Cena videa · Odhad iba na porovnanie $0.1 za sekundu videa
KonfiguráciaCena videaSadzobník—Odhadované množstvo—Komponent poplatku—Účtovacia jednotkaza sekundu videaPodmienky účtovaniaresolution: 768pPoplatok
Výstup · Cena videa · Odhad iba na porovnanie $0.16 za sekundu videa
KonfiguráciaOdhadované náklady na generovanieSadzobník—Odhadované množstvoodhad pre jedno generovanieKomponent poplatku—Účtovacia jednotka—Podmienky účtovania—Poplatok
Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.5 odhad pred generovaním

Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Podrobnosti referenčnej tarify

Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.

Cenové referencie konfigurácií videa

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

KonfiguráciaPodmienky účtovaniaPoplatok
KonfiguráciaCena videaPodmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka.Poplatok
Výstup · Cena videa $0.16 za sekundu videa

Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.

KonfiguráciaCena videaPodmienky účtovaniaresolution: 480pPoplatok
Výstup · Cena videa $0.1 za sekundu videa

Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.

KonfiguráciaCena videaPodmienky účtovaniaresolution: 768pPoplatok
Výstup · Cena videa $0.16 za sekundu videa

Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.

Príklady požiadaviek

Ailoot Ultra · Video

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3-max","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Prijať a uložiť výsledky

Ailoot Ultra · Video

podpísané URL obsahu vo vašom vlastníctve

Skontrolovať stav úlohy
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Čítanie ďalšieho obsahu
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n    target=Path('owned-'+label+'.bin')\n    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Uchovať všetky dokončené výsledky

Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.

Zachovajte každý skutočný výstup vo vašom vlastníctve a jeho vrátené namerané metadáta.

Ak treba overiť pôvodnú odpoveď

503 result_pending_check + pôvodné id + X-Should-Retry:false; pôvodnú požiadavku nikdy znova neodosielajte

Polia odpovede
PoleTypVýznam
PoleindexTypintegerVýznamPozícia tohto videa v zozname výstupov, číslovaná od nuly.
Polecontent_urlTypstringVýznamPodpísaná HTTPS URL na stiahnutie tohto dokončeného videa.
Polesha256Typstring | nullVýznamOdtlačok SHA-256 pôvodných bajtov videa; null, ak nie je dostupný.
Polesize_bytesTypinteger | nullVýznamVeľkosť pôvodného videosúboru v bajtoch; null, ak nie je dostupná.
Poleduration_msTypinteger | nullVýznamNameraná dĺžka videa v milisekundách; null, ak nie je dostupná.
PolewidthTypinteger | nullVýznamŠírka videa v pixeloch; null, ak nie je dostupná.
PoleheightTypinteger | nullVýznamVýška videa v pixeloch; null, ak nie je dostupná.
Polevideo_codecTypstring | nullVýznamIdentifikátor video kodeku; null, ak nie je zaznamenaný.
Polehas_audioTypboolean | nullVýznamČi video obsahuje zvukovú stopu; null, ak sa to nemeralo.
Poleaudio_codecTypstring | nullVýznamIdentifikátor zvukového kodeku; null, keď nie je zaznamenaný žiadny identifikátor.
Chyby a ďalšie kroky
OdpoveďPodmienkaĎalší krok
Odpoveď404 · not_found_errorPodmienkaPrístup k videu nie je dostupný alebo sa toto ID videa nenašlo.Ďalší krokSkontrolujte prístup k videu. Pri existujúcom videu použite jeho pôvodné verejné ID a rovnaký kľúč API.
Odpoveď401 · authentication_errorPodmienkaKľúč API nezodpovedá overenému účtu.Ďalší krokPred odoslaním skontrolujte svoj kľúč API a prístup účtu.
Odpoveď400 · invalid_request_errorPodmienkaPožiadavku sa nepodarilo načítať alebo je index sťahovania neplatný.Ďalší krokOpravte telo požiadavky. Pri sťahovaní vyberte index výstupu vrátený pôvodnou úlohou.
Odpoveď422 · price_unavailablePodmienkaCenu vybranej konfigurácie videa nemožno určiť.Ďalší krokVyberte podporovanú konfiguráciu videa a pred odoslaním opravenej požiadavky vyplňte jej povinné možnosti.
Odpoveď422 · invalid_request_errorPodmienkaVstup videa alebo pôvodná úloha pokračovania sú neplatné.Ďalší krokPoužite platné vstupy HTTPS. Pri pokračovaní použite verejné ID svojho dokončeného pôvodného videa s rovnakým kľúčom API.
Odpoveď402 · billing_errorPodmienkaDostupný zostatok alebo limity neumožňujú rezerváciu.Ďalší krokPred odoslaním novej požiadavky skontrolujte dostupný zostatok a limity.
Odpoveď503 · server_errorPodmienkaOverovanie videa, úložisko alebo prístup k službe sú dočasne nedostupné.Ďalší krokPočkajte na dostupnosť služby. Ak už máte ID videa, skontrolujte pôvodnú úlohu namiesto vytvorenia ďalšieho generovania.
Odpoveď503 · result_pending_checkPodmienkaPôvodný výsledok videa a poplatok treba skontrolovať.Ďalší krokZachovajte vrátené ID videa a skontrolujte danú úlohu. Počas jej kontroly neodosielajte náhradnú požiadavku na generovanie.
Odpoveď503 · owned_result_unavailablePodmienkaStiahnutie existujúceho videa je dočasne nedostupné.Ďalší krokNeskôr skontrolujte tú istú úlohu videa a stiahnite jej existujúci výstup. Nové generovanie vytvára samostatnú operáciu.
Odpoveď409 · video_not_readyPodmienkaObsah videa nebol zverejnený.Ďalší krokSkontrolujte stav pôvodnej úlohy. Keď hlási completed, stiahnite jej výsledok; ak hlási failed, riaďte sa jej oznámením o kontrole poplatku.

Aliasy

Aliasy modelov

Ailoot Ultra minimax/hailuo-3-max

Aliasy ciest metód

Použite cesty metód uvedené vyššie.

Súvisiace ID na volanie

minimax/hailuo-3-max

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3-max", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3-max", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Zachovajte každý skutočný výstup vo vašom vlastníctve a jeho vrátené namerané metadáta.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Prístup k videu nie je dostupný alebo sa toto ID videa nenašlo.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Skontrolujte prístup k videu. Pri existujúcom videu použite jeho pôvodné verejné ID a rovnaký kľúč API.", "type": "not_found_error" }, { "condition": "Kľúč API nezodpovedá overenému účtu.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Pred odoslaním skontrolujte svoj kľúč API a prístup účtu.", "type": "authentication_error" }, { "condition": "Požiadavku sa nepodarilo načítať alebo je index sťahovania neplatný.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Opravte telo požiadavky. Pri sťahovaní vyberte index výstupu vrátený pôvodnou úlohou.", "type": "invalid_request_error" }, { "condition": "Cenu vybranej konfigurácie videa nemožno určiť.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Vyberte podporovanú konfiguráciu videa a pred odoslaním opravenej požiadavky vyplňte jej povinné možnosti.", "type": "price_unavailable" }, { "condition": "Vstup videa alebo pôvodná úloha pokračovania sú neplatné.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Použite platné vstupy HTTPS. Pri pokračovaní použite verejné ID svojho dokončeného pôvodného videa s rovnakým kľúčom API.", "type": "invalid_request_error" }, { "condition": "Dostupný zostatok alebo limity neumožňujú rezerváciu.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Pred odoslaním novej požiadavky skontrolujte dostupný zostatok a limity.", "type": "billing_error" }, { "condition": "Overovanie videa, úložisko alebo prístup k službe sú dočasne nedostupné.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Počkajte na dostupnosť služby. Ak už máte ID videa, skontrolujte pôvodnú úlohu namiesto vytvorenia ďalšieho generovania.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Pôvodný výsledok videa a poplatok treba skontrolovať.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Zachovajte vrátené ID videa a skontrolujte danú úlohu. Počas jej kontroly neodosielajte náhradnú požiadavku na generovanie.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Stiahnutie existujúceho videa je dočasne nedostupné.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Neskôr skontrolujte tú istú úlohu videa a stiahnite jej existujúci výstup. Nové generovanie vytvára samostatnú operáciu.", "type": "server_error" }, { "condition": "Obsah videa nebol zverejnený.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Skontrolujte stav pôvodnej úlohy. Keď hlási completed, stiahnite jej výsledok; ak hlási failed, riaďte sa jej oznámením o kontrole poplatku.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + pôvodné id + X-Should-Retry:false; pôvodnú požiadavku nikdy znova neodosielajte" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Zadajte prompt ako text a duration v celých sekundách. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.", "required": [ "model", "prompt", "duration" ], "required_material": "Textové zadanie." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images je pole. Každý objekt snímky má type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použite first_frame s voliteľným last_frame. Každá rola snímky sa môže vyskytnúť najviac raz. Pre každú snímku zadajte verejnú HTTPS URL obrázka. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Textové zadanie a obrázok prvej snímky." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Pozícia tohto videa v zozname výstupov, číslovaná od nuly.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Podpísaná HTTPS URL na stiahnutie tohto dokončeného videa.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Odtlačok SHA-256 pôvodných bajtov videa; null, ak nie je dostupný.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Veľkosť pôvodného videosúboru v bajtoch; null, ak nie je dostupná.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Nameraná dĺžka videa v milisekundách; null, ak nie je dostupná.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Šírka videa v pixeloch; null, ak nie je dostupná.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Výška videa v pixeloch; null, ak nie je dostupná.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identifikátor video kodeku; null, ak nie je zaznamenaný.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Či video obsahuje zvukovú stopu; null, ak sa to nemeralo.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identifikátor zvukového kodeku; null, keď nie je zaznamenaný žiadny identifikátor.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "podpísané URL obsahu vo vašom vlastníctve", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Tieto kľúče opisujú každý objekt snímky; image_url obsahuje iba url. Pri čisto textovej požiadavke vynechajte frame_images.", "content": "Pole objektov snímok. Každý objekt má type=image_url, image_url obsahujúce url a frame_type. Použite HTTPS URL obrázka a nastavte frame_type na first_frame alebo last_frame. Každá rola snímky sa môže vyskytnúť najviac raz.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Výstup videa · referenčná sadzba", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Cena videa", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Odhadované náklady na generovanie", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "minimax/hailuo-3-max", "nativeProvenance": { "input_facts_canonical_sha256": "d0ea799803ebd21c905e39558c1284e126bb671d4ce9973953119f81f8b4f503", "input_html_sha256": "32eab38858ebe431f0c519827d25192f3fb5ee46542b41b02cc6881f5a2bb8a0", "private_audit_sha256": "c9fd28dd4135c2367e93a586592f35eabea8c12a0efbbedf757d7cc6fcc4a1c7", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/sk/minimax-hailuo-3-max/", "description": "MiniMax H3 Max je rýchly variant H3 upravený dodatočným tréningom na krátke video so synchronizovaným zvukom. Dokumentovaný postup MiniMax podporuje text, snímky a multimodálne referencie, výstup 480P alebo 768P, dĺžku 5–15 sekúnd a vlastné možnosti rozšírenia zadania.", "locale": "sk", "md_url": "https://ailoot.ai/models/sk/minimax-hailuo-3-max/index.md", "title": "MiniMax: H3 Max — Ailoot", "url": "https://ailoot.ai/models/sk/minimax-hailuo-3-max/" }, "rawModel": { "about": "Rýchly variant H3 upravený dodatočným tréningom\n\nMiniMax H3 Max je variant základného modelu MiniMax H3 upravený dodatočným tréningom, optimalizovaný na rýchlejšie generovanie, dodržiavanie zadania a audiovizuálnu kvalitu. Variant vyvinul fal Research prostredníctvom dodatočného tréningu. Zachováva jednotný multimodálny kontext a natívne synchronizovaný obraz a zvuk. Rýchlosť je prioritou návrhu, nie pevnou dobou dokončenia pre každé zadanie, dĺžku či aplikáciu.\n\nRozlišujte Max od pôvodného systému H3 aj od samostatného variantu Max Turbo. Aktuálne rozhranie MiniMax uvádza pre Max rozlíšenie 480P alebo 768P, predvolené 768P, 24 snímok za sekundu a celočíselnú dĺžku od 5 do 15 sekúnd. Jeho dokumentovaný postup pre Max neponúka rozlíšenie 2K pôvodného systému H3 ani štvorsekundový výstup.\n\nOd zadania k záberu\n\nKaždé generovanie obsahuje neprázdne textové zadanie, najviac 7 000 znakov na jednu textovú položku. Opíšte subjekt, úvodnú kompozíciu, akciu a výsledok, potom jasne určte pokyny pre kameru a zvuk. Pri krátkom odhalení predmetu určte, čo má divák vidieť ako prvé, ako sa predmet dostane do záberu a ako sa má záber skončiť.\n\nUžitočné päťsekundové zadanie môže opisovať keramickú šálku na drevenom stole, ruku ukladajúcu vedľa nej tanierik, mierny nájazd kamery a zvuk keramiky pri dotyku s drevom. Akciu udržte dostatočne jednoduchú, aby sa zmestila do zvolenej dĺžky, a overte, či výsledný pohyb a zvuk sledujú tú istú udalosť.\n\nTvorba vedená snímkami\n\nVýrobca dokumentuje úvodnú snímku, záverečnú snímku alebo obe. Prvý obrázok určuje začiatok klipu; posledný obrázok určuje konečný vizuálny stav. Vysvetlite pohyb, ktorý ich spája, vrátane zmien pózy, polohy predmetu, kamery alebo osvetlenia. Pri prechode medzi dvoma snímkami sa vyhnite zadaniu, ktoré medzi koncovými bodmi zavádza nezlučiteľnú scénu.\n\nVýstup vedený snímkami odvodzuje pomer strán od vstupného obrázka. Pri práci iba s textom zvoľte konkrétny pomer 21:9, 16:9, 4:3, 1:1, 3:4 alebo 9:16. Práca vedená referenciami môže použiť adaptívny pomer alebo jednu z dokumentovaných explicitných možností. Referenciu alebo písanú scénu komponujte pre cieľový formát namiesto predpokladu, že rovnaké usporiadanie funguje rovnako dobre na výšku aj na šírku.\n\nMultimodálne referencie\n\nAktuálna schéma generovania Max od MiniMax dokumentuje aj referenčné obrázky, video a zvuk. Uveďte, čo má každý podklad ovplyvniť: identitu postavy, prostredie, pohybový vzor, dráhu kamery, farbu hlasu alebo zvukovú vlastnosť. Úlohy prvej/poslednej snímky a referenčných médií sa v tomto rozhraní vzájomne vylučujú.\n\nPri zábere postavy určte referenciu vzhľadu a referenciu pohybu oddelene a potom zadajte cieľovú akciu a hovorenú repliku. Hlasová referencia určujúca spôsob prednesu sa líši od kopírovania celého zvukového signálu. V zadaní jasne určte vlastnosti, ktoré treba zachovať, a zmeny, ktoré treba vykonať, a skutočný audiovizuálny klip porovnajte s každou úlohou referencie.\n\nRozšírenie zadania\n\nNastavenie rozšírenia špecifické pre Max ponúka možnosti disabled, balanced a quality, pričom predvolená je balanced. Zvoľte disabled, keď má dodané zadanie prejsť bez rozšírenia; dokumentovaný režim rozšírenia použite, keď je žiaduca dodatočná interpretácia. Uchovajte pôvodné zadanie, aby bolo možné odlíšiť zmenu zavedenú pri rozšírení od požadovaného obsahu.\n\nZvuk opíšte ako súčasť scény. Určte fyzické zvuky, atmosféru a všetky hovorené slová a oddeľte ich od hudobného podkladu počuteľného iba pre publikum. Uveďte presnú repliku a zamýšľaného hovoriaceho namiesto požiadavky na neurčený dialóg. Výsledok si vypočujte aj pozrite; presvedčivý obraz nepotvrdzuje správnosť hovoreného znenia ani časovania.\n\nPríprava vstupov a limity\n\nAktuálna schéma výrobcu prijíma obrázky JPG, JPEG, PNG, WebP, HEIC alebo HEIF, každý najviac 30 MB, so stranami od 256 do 5 760 pixelov a pomerom strán od 0.4 do 2.5. Úvodná aj záverečná úloha povoľujú po jednom obrázku; referenčný režim povoľuje až deväť obrázkov. Zachovajte jasný pohľad na subjekt a detaily, ktoré musia zostať identifikovateľné.\n\nReferenčné video povoľuje až tri klipy MP4 alebo MOV, každý v dĺžke 2–15 sekúnd a spolu najviac 15 sekúnd, s limitom 50 MB na súbor. Dokumentuje video H.264 alebo H.265, zvuk AAC alebo MP3, strany od 256 do 5 760 pixelov, pomer strán od 0.4 do 2.5 a snímkovú frekvenciu od 23.976 do 60. Referenčný zvuk povoľuje až tri klipy WAV alebo MP3, každý najviac 15 MB a 2–15 sekúnd, spolu najviac 15 sekúnd. Telo požiadavky má samostatný limit 64 MB.\n\nPoužívajte iba referencie, ktoré prispievajú k záberu, a každý príspevok určte v texte. Krátky relevantný klip pohybu je ako usmernenie užitočnejší než dlhá zbierka nesúvisiacich udalostí. Zamýšľanú dĺžku a výstupné rozlíšenie uveďte výslovne, aby sa výsledok dal porovnať s tým istým zadaním.\n\nDokončený výsledok\n\nAsynchrónny postup výrobcu vracia identitu úlohy skôr, než je dostupné dokončené video. Jeho rozhranie na zisťovanie stavu úloh načítava úlohy z predchádzajúcich siedmich dní. Pre úpravy alebo ďalšie posudzovanie si uložte skutočný výsledný klip aj jeho špecifikáciu; identifikátor úlohy nie je audiovizuálny výstup. Adresy na stiahnutie sú časovo obmedzené, preto pri uchovaní vybraného výsledku uložte samotný súbor.\n\nKontrolujte kontinuitu subjektu, pohyb, viditeľný text, dialóg a časovanie zvuku vo veľkosti, v akej sa bude klip používať. Pre ďalšie tvorivé zadanie použite konkrétnu spätnú väzbu: gesto, ktoré sa zmenilo, vynechanú repliku alebo kompozíciu vyžadujúcu úpravu. Užitočným výsledkom je krátky audiovizuálny záber naviazaný na dodaný obsah a jeho výslovné referenčné vzťahy.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3-max", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Úplný cenník konfigurácie nájdete v podrobnostiach." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "c3ee132fc5b4cd02f24f5c4d", "label": "Cenové referencie konfigurácií videa", "profiles": [ { "basis": "Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.", "dimensions": { "conditions": "V tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka." }, "label": "Cena videa", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.", "dimensions": { "conditions": "resolution: 480p" }, "label": "Cena videa", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.", "dimensions": { "conditions": "resolution: 768p" }, "label": "Cena videa", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3-max", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Zachovajte každý skutočný výstup vo vašom vlastníctve a jeho vrátené namerané metadáta.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Prístup k videu nie je dostupný alebo sa toto ID videa nenašlo.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Skontrolujte prístup k videu. Pri existujúcom videu použite jeho pôvodné verejné ID a rovnaký kľúč API.", "type": "not_found_error" }, { "condition": "Kľúč API nezodpovedá overenému účtu.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Pred odoslaním skontrolujte svoj kľúč API a prístup účtu.", "type": "authentication_error" }, { "condition": "Požiadavku sa nepodarilo načítať alebo je index sťahovania neplatný.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Opravte telo požiadavky. Pri sťahovaní vyberte index výstupu vrátený pôvodnou úlohou.", "type": "invalid_request_error" }, { "condition": "Cenu vybranej konfigurácie videa nemožno určiť.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Vyberte podporovanú konfiguráciu videa a pred odoslaním opravenej požiadavky vyplňte jej povinné možnosti.", "type": "price_unavailable" }, { "condition": "Vstup videa alebo pôvodná úloha pokračovania sú neplatné.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Použite platné vstupy HTTPS. Pri pokračovaní použite verejné ID svojho dokončeného pôvodného videa s rovnakým kľúčom API.", "type": "invalid_request_error" }, { "condition": "Dostupný zostatok alebo limity neumožňujú rezerváciu.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Pred odoslaním novej požiadavky skontrolujte dostupný zostatok a limity.", "type": "billing_error" }, { "condition": "Overovanie videa, úložisko alebo prístup k službe sú dočasne nedostupné.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Počkajte na dostupnosť služby. Ak už máte ID videa, skontrolujte pôvodnú úlohu namiesto vytvorenia ďalšieho generovania.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Pôvodný výsledok videa a poplatok treba skontrolovať.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Zachovajte vrátené ID videa a skontrolujte danú úlohu. Počas jej kontroly neodosielajte náhradnú požiadavku na generovanie.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Stiahnutie existujúceho videa je dočasne nedostupné.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Neskôr skontrolujte tú istú úlohu videa a stiahnite jej existujúci výstup. Nové generovanie vytvára samostatnú operáciu.", "type": "server_error" }, { "condition": "Obsah videa nebol zverejnený.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Skontrolujte stav pôvodnej úlohy. Keď hlási completed, stiahnite jej výsledok; ak hlási failed, riaďte sa jej oznámením o kontrole poplatku.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + pôvodné id + X-Should-Retry:false; pôvodnú požiadavku nikdy znova neodosielajte" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Zadajte prompt ako text a duration v celých sekundách. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.", "required": [ "model", "prompt", "duration" ], "required_material": "Textové zadanie." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images je pole. Každý objekt snímky má type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použite first_frame s voliteľným last_frame. Každá rola snímky sa môže vyskytnúť najviac raz. Pre každú snímku zadajte verejnú HTTPS URL obrázka. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Textové zadanie a obrázok prvej snímky." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Pozícia tohto videa v zozname výstupov, číslovaná od nuly.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Podpísaná HTTPS URL na stiahnutie tohto dokončeného videa.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Odtlačok SHA-256 pôvodných bajtov videa; null, ak nie je dostupný.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Veľkosť pôvodného videosúboru v bajtoch; null, ak nie je dostupná.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Nameraná dĺžka videa v milisekundách; null, ak nie je dostupná.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Šírka videa v pixeloch; null, ak nie je dostupná.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Výška videa v pixeloch; null, ak nie je dostupná.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identifikátor video kodeku; null, ak nie je zaznamenaný.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Či video obsahuje zvukovú stopu; null, ak sa to nemeralo.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identifikátor zvukového kodeku; null, keď nie je zaznamenaný žiadny identifikátor.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "podpísané URL obsahu vo vašom vlastníctve", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Tieto kľúče opisujú každý objekt snímky; image_url obsahuje iba url. Pri čisto textovej požiadavke vynechajte frame_images.", "content": "Pole objektov snímok. Každý objekt má type=image_url, image_url obsahujúce url a frame_type. Použite HTTPS URL obrázka a nastavte frame_type na first_frame alebo last_frame. Každá rola snímky sa môže vyskytnúť najviac raz.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Výstup videa · referenčná sadzba", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Cena videa", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Odhadované náklady na generovanie", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/hailuo-3-max", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" } ], "name": "MiniMax: H3 Max", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.5, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.5, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.10", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "480P" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "768P" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.1106", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "480P" }, "key": "input_video", "label": "input video", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.286", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.148", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "key": "input_image", "label": "input image", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.10", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=480p", "billing_original_currency": "USD", "billing_original_rate": "0.10", "key": "duration_seconds_480p", "label": "output second", "native_amount_usd_per_unit": "0.10", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=768p", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds_768p", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "minimax/hailuo-3-max", "short": "MiniMax H3 Max je rýchly variant H3 upravený dodatočným tréningom na krátke video so synchronizovaným zvukom. Dokumentovaný postup MiniMax podporuje text, snímky a multimodálne referencie, výstup 480P alebo 768P, dĺžku 5–15 sekúnd a vlastné možnosti rozšírenia zadania." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "MiniMax H3 Max je rýchly variant H3 upravený dodatočným tréningom na krátke video so synchronizovaným zvukom. Dokumentovaný postup MiniMax podporuje text, snímky a multimodálne referencie, výstup 480P alebo 768P, dĺžku 5–15 sekúnd a vlastné možnosti rozšírenia zadania.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "caeb8b902620ddba1c427670a5ecfb5d1c6a9d2e96810aeca934ad42205bf5ee", "renderer_sha256": "94893ba0fa4d7b7d32370787b705f436a4c2569f84ec7b33063549adc74b07e0" }, "sourceRevision": "d787c1d907d0a0d52a5f50e3707a75c4a34d6d82e0d8eb7c4cfde51598b237b8" }