{ "aboutHtml": "

Jeden audiovizuálny výsledok z multimodálneho zadania

MiniMax H3 je omnimodálny videosystém spoločnosti MiniMax. Spoločne interpretuje text, obrázky, video a zvuk a potom generuje video s natívnym stereofónnym zvukom. Výrobca ho predstavuje na krátku tvorivú prácu, napríklad produktové vizuály, reklamu, animované plagáty a koncepty filmových titulkov, pri ktorých sú vzťahy medzi referenčnými podkladmi rovnako dôležité ako opis scény.

Dokumentovaný systém vytvára video s dĺžkou 4–15 sekúnd pri 24 snímkach za sekundu so stereofónnym zvukom 32 kHz. Generovanie H3-Base pracuje v 768p; úplný postup 2K tento výsledok regeneruje pomocou pôvodného multimodálneho kontextu. Nejde iba o bežnú zmenu veľkosti: druhá etapa znovu používa model a zdrojový kontext na obnovu jemných detailov. H3 Max a H3-Context-IR majú samostatné úlohy a limity.

Tvorba z textu a vedená snímkami

Čisto textový vstup opisuje celú audiovizuálnu časovú os. Prvý obrázok ukotvuje začiatok, posledný koniec a dva obrázky môžu určiť oba. Pri zábere z úvodnej snímky vychádzajte z kompozície a identity viditeľnej na statickom obrázku a potom opíšte rozvíjajúcu sa akciu. Pri prechode od prvej k poslednej snímke opíšte pozorovateľný pohyb spájajúci oba stavy namiesto opakovania dvoch nesúvisiacich opisov obrázkov.

Praktické produktové zadanie môže určiť zatvorený obal v úvodnej snímke, ruku, ktorá ho otvára, jemný pohyb kamery a konečný stav, ktorý treba dosiahnuť. V dodaných snímkach zachovajte tvar predmetu, umiestnenie štítka a osvetlenie. Tvorba vedená snímkami a tvorba vedená referenciami sú samostatné vstupné režimy; rozhranie výrobcu v jednej požiadavke nemieša úlohy prvej/poslednej snímky s úlohami referenčných médií.

Generovanie a úpravy vedené referenciami

Referenčný režim prijíma text s obrázkami, videoklipmi a zvukovými klipmi. Určte prínos každého zdroja: vzhľad postavy, miesto, pohyb kamery, časovú štruktúru zdrojového klipu alebo hlas. Video použité iba na pohyb kamery sa líši od videa, ktoré sa má skutočne upraviť alebo v ktorom sa má pokračovať. Tento vzťah uveďte výslovne.

Referenčný návod výrobcu oddeľuje definície subjektov, súhrn úlohy, analýzu zachovania, podrobný opis záberu, celkové zvukové prostredie a hudobný podklad určený iba publiku. Rozlišuje zachovanie viditeľného obsahu od prenosu vlastností alebo všeobecnej štýlovej referencie. Pri zvuku sa kopírovanie signálu líši od odkazovania na farbu, rytmus či spôsob prednesu. Tieto úlohy udržujte v celom zadaní stabilné.

Pre scénu založenú na referenciách dodajte obrázok postavy, krátku referenciu pohybu kamery a zvukovú referenciu hlasu a potom opíšte, kde má každá ovplyvniť cieľový záber. Uveďte, ktoré detaily odevu, prostredia alebo predmetu musia zostať rozpoznateľné. Dokončený klip porovnajte s týmito požiadavkami vrátane kontinuity pohybu a vzťahu medzi viditeľným hovoriacim a počutým hlasom.

Reč, zvuk a časovanie záberov

H3 spoločne modeluje dialóg, fyzické zvuky, atmosféru a hudbu. Karta modelu dokumentuje stabilnú podporu dialógu v arabčine, čínštine, angličtine, francúzštine, nemčine, taliančine, japončine, kórejčine, portugalčine, ruštine a španielčine; pri ostatných jazykoch opisuje rozdielnu mieru podpory. Zadajte presné hovorené slová a jazyk so stabilnou identitou hovoriaceho naprieč zábermi.

Návody výrobcu na písanie zadaní používajú v opisných častiach angličtinu a dialóg aj viditeľný text zachovávajú v pôvodnom jazyku. Hovorený obsah používa <d>[Language] ...</d>, pričom identita hovoriaceho a opis hlasu sú mimo bloku. Rozlišujte fyzickú reč od komentára mimo obrazu a určte, kedy replika pokračuje cez strih alebo sa koncom preruší. Presne zachovajte aj viditeľný text. Množstvo reči prispôsobte zvolenej dĺžke a spoločne skontrolujte vykreslené slová aj počuteľnú repliku.

Pohyb kamery opisujte ako akciu vrátane rozsahu a rýchlosti, keď na nich záleží. Zábery číslujte v poradí prehrávania a časy strihov udržujte v rámci dĺžky videa. Zvuky scény, napríklad kroky alebo zatvorenie dverí, oddeľte od hudobného sprievodu počuteľného iba publiku. Vďaka týmto voľbám sa krátky plán záberov ľahšie interpretuje a porovnáva s výsledkom.

Príprava vstupov a číselné limity

Aktuálna schéma generovania vyžaduje neprázdny text v každom režime, najviac 7 000 znakov na textovú položku. Obrázky môžu byť JPG, JPEG, PNG, WebP, HEIC alebo HEIF, každý najviac 30 MB, s každou stranou od 256 do 5 760 pixelov a pomerom strán od 0.4 do 2.5. Vstup snímok povoľuje jeden úvodný a jeden záverečný obrázok; referenčný režim povoľuje až deväť referenčných obrázkov.

Referenčné video môže obsahovať až tri klipy MP4 alebo MOV, každý v dĺžke 2–15 sekúnd a spolu najviac 15 sekúnd. Klip môže mať najviac 50 MB; video kodek je H.264 alebo H.265, so zvukom AAC alebo MP3, stranami od 256 do 5 760 pixelov, pomerom strán od 0.4 do 2.5 a snímkovou frekvenciou od 23.976 do 60. Referenčný zvuk podporuje až tri klipy WAV alebo MP3, každý najviac 15 MB a 2–15 sekúnd, spolu najviac 15 sekúnd. Karta modelu obmedzuje zmiešané referenčné vstupy na 12 súborov. Dokumentovaný limit tela požiadavky je 64 MB, oddelený od limitov jednotlivých súborov.

Vyberajte iba referencie, ktoré prispievajú k zadaniu, a každý prínos uveďte výslovne. Jasný pohľad na subjekt je užitočnejší než niekoľko protichodných pohľadov bez vysvetlenia. Zachovajte poradie referencií, orežte nepodstatný materiál bez odstránenia potrebného kontextu scény a overte, že krátke zdrojové klipy obsahujú požadovanú akciu alebo hlasovú vlastnosť.

Tvar výstupu a celý systém

Rozhranie H3 výrobcu ponúka 768P a 2K. Čisto textové generovanie vyžaduje konkrétny pomer: 21:9, 16:9, 4:3, 1:1, 3:4 alebo 9:16. Tvorba z prvej/poslednej snímky preberá pomer strán zo vstupného obrázka; referenčná tvorba môže použiť adaptívny alebo explicitný pomer. Celočíselná dĺžka výstupu je 4–15 sekúnd.

Karta modelu rozlišuje H3-Context-IR, ktorý interpretuje a obohacuje zadanie, H3-Base, ktorý generuje audiovizuálny obsah, a H3-Regenerate-2K, ktorý vytvára výsledok vo vyššom rozlíšení. Zverejnené základné checkpointy oddeľujú úlohy vedené snímkami od úloh s omnimodálnymi referenciami. Komponenty kontextu a regenerovania sú oddelené od týchto základných váh, preto samotný názov otvoreného checkpointu nepotvrdzuje správanie celého systému.

Postup generovania výrobcu je asynchrónny. Jeho rozhranie na zisťovanie stavu úloh načítava úlohy z predchádzajúcich siedmich dní. Identitu úlohy uchovajte, kým nepríde skutočný výsledok videa, a potom uložte klip namiesto uchovania iba časovo obmedzenej adresy na stiahnutie. Pri zamýšľanej veľkosti zobrazenia kontrolujte vizuálnu identitu, drobný text, interakcie objektov, hovorený obsah a časovanie zvuku. Výrobca označuje multimodálne porozumenie a jemné vizuálne detaily za oblasti pokračujúceho zlepšovania; podrobné zadanie a porovnávanie so zdrojom zostávajú základom užitočného výsledku.

", "aboutText": "Jeden audiovizuálny výsledok z multimodálneho zadania\n\nMiniMax H3 je omnimodálny videosystém spoločnosti MiniMax. Spoločne interpretuje text, obrázky, video a zvuk a potom generuje video s natívnym stereofónnym zvukom. Výrobca ho predstavuje na krátku tvorivú prácu, napríklad produktové vizuály, reklamu, animované plagáty a koncepty filmových titulkov, pri ktorých sú vzťahy medzi referenčnými podkladmi rovnako dôležité ako opis scény.\n\nDokumentovaný systém vytvára video s dĺžkou 4–15 sekúnd pri 24 snímkach za sekundu so stereofónnym zvukom 32 kHz. Generovanie H3-Base pracuje v 768p; úplný postup 2K tento výsledok regeneruje pomocou pôvodného multimodálneho kontextu. Nejde iba o bežnú zmenu veľkosti: druhá etapa znovu používa model a zdrojový kontext na obnovu jemných detailov. H3 Max a H3-Context-IR majú samostatné úlohy a limity.\n\nTvorba z textu a vedená snímkami\n\nČisto textový vstup opisuje celú audiovizuálnu časovú os. Prvý obrázok ukotvuje začiatok, posledný koniec a dva obrázky môžu určiť oba. Pri zábere z úvodnej snímky vychádzajte z kompozície a identity viditeľnej na statickom obrázku a potom opíšte rozvíjajúcu sa akciu. Pri prechode od prvej k poslednej snímke opíšte pozorovateľný pohyb spájajúci oba stavy namiesto opakovania dvoch nesúvisiacich opisov obrázkov.\n\nPraktické produktové zadanie môže určiť zatvorený obal v úvodnej snímke, ruku, ktorá ho otvára, jemný pohyb kamery a konečný stav, ktorý treba dosiahnuť. V dodaných snímkach zachovajte tvar predmetu, umiestnenie štítka a osvetlenie. Tvorba vedená snímkami a tvorba vedená referenciami sú samostatné vstupné režimy; rozhranie výrobcu v jednej požiadavke nemieša úlohy prvej/poslednej snímky s úlohami referenčných médií.\n\nGenerovanie a úpravy vedené referenciami\n\nReferenčný režim prijíma text s obrázkami, videoklipmi a zvukovými klipmi. Určte prínos každého zdroja: vzhľad postavy, miesto, pohyb kamery, časovú štruktúru zdrojového klipu alebo hlas. Video použité iba na pohyb kamery sa líši od videa, ktoré sa má skutočne upraviť alebo v ktorom sa má pokračovať. Tento vzťah uveďte výslovne.\n\nReferenčný návod výrobcu oddeľuje definície subjektov, súhrn úlohy, analýzu zachovania, podrobný opis záberu, celkové zvukové prostredie a hudobný podklad určený iba publiku. Rozlišuje zachovanie viditeľného obsahu od prenosu vlastností alebo všeobecnej štýlovej referencie. Pri zvuku sa kopírovanie signálu líši od odkazovania na farbu, rytmus či spôsob prednesu. Tieto úlohy udržujte v celom zadaní stabilné.\n\nPre scénu založenú na referenciách dodajte obrázok postavy, krátku referenciu pohybu kamery a zvukovú referenciu hlasu a potom opíšte, kde má každá ovplyvniť cieľový záber. Uveďte, ktoré detaily odevu, prostredia alebo predmetu musia zostať rozpoznateľné. Dokončený klip porovnajte s týmito požiadavkami vrátane kontinuity pohybu a vzťahu medzi viditeľným hovoriacim a počutým hlasom.\n\nReč, zvuk a časovanie záberov\n\nH3 spoločne modeluje dialóg, fyzické zvuky, atmosféru a hudbu. Karta modelu dokumentuje stabilnú podporu dialógu v arabčine, čínštine, angličtine, francúzštine, nemčine, taliančine, japončine, kórejčine, portugalčine, ruštine a španielčine; pri ostatných jazykoch opisuje rozdielnu mieru podpory. Zadajte presné hovorené slová a jazyk so stabilnou identitou hovoriaceho naprieč zábermi.\n\nNávody výrobcu na písanie zadaní používajú v opisných častiach angličtinu a dialóg aj viditeľný text zachovávajú v pôvodnom jazyku. Hovorený obsah používa `[Language] ...`, pričom identita hovoriaceho a opis hlasu sú mimo bloku. Rozlišujte fyzickú reč od komentára mimo obrazu a určte, kedy replika pokračuje cez strih alebo sa koncom preruší. Presne zachovajte aj viditeľný text. Množstvo reči prispôsobte zvolenej dĺžke a spoločne skontrolujte vykreslené slová aj počuteľnú repliku.\n\nPohyb kamery opisujte ako akciu vrátane rozsahu a rýchlosti, keď na nich záleží. Zábery číslujte v poradí prehrávania a časy strihov udržujte v rámci dĺžky videa. Zvuky scény, napríklad kroky alebo zatvorenie dverí, oddeľte od hudobného sprievodu počuteľného iba publiku. Vďaka týmto voľbám sa krátky plán záberov ľahšie interpretuje a porovnáva s výsledkom.\n\nPríprava vstupov a číselné limity\n\nAktuálna schéma generovania vyžaduje neprázdny text v každom režime, najviac 7 000 znakov na textovú položku. Obrázky môžu byť JPG, JPEG, PNG, WebP, HEIC alebo HEIF, každý najviac 30 MB, s každou stranou od 256 do 5 760 pixelov a pomerom strán od 0.4 do 2.5. Vstup snímok povoľuje jeden úvodný a jeden záverečný obrázok; referenčný režim povoľuje až deväť referenčných obrázkov.\n\nReferenčné video môže obsahovať až tri klipy MP4 alebo MOV, každý v dĺžke 2–15 sekúnd a spolu najviac 15 sekúnd. Klip môže mať najviac 50 MB; video kodek je H.264 alebo H.265, so zvukom AAC alebo MP3, stranami od 256 do 5 760 pixelov, pomerom strán od 0.4 do 2.5 a snímkovou frekvenciou od 23.976 do 60. Referenčný zvuk podporuje až tri klipy WAV alebo MP3, každý najviac 15 MB a 2–15 sekúnd, spolu najviac 15 sekúnd. Karta modelu obmedzuje zmiešané referenčné vstupy na 12 súborov. Dokumentovaný limit tela požiadavky je 64 MB, oddelený od limitov jednotlivých súborov.\n\nVyberajte iba referencie, ktoré prispievajú k zadaniu, a každý prínos uveďte výslovne. Jasný pohľad na subjekt je užitočnejší než niekoľko protichodných pohľadov bez vysvetlenia. Zachovajte poradie referencií, orežte nepodstatný materiál bez odstránenia potrebného kontextu scény a overte, že krátke zdrojové klipy obsahujú požadovanú akciu alebo hlasovú vlastnosť.\n\nTvar výstupu a celý systém\n\nRozhranie H3 výrobcu ponúka 768P a 2K. Čisto textové generovanie vyžaduje konkrétny pomer: 21:9, 16:9, 4:3, 1:1, 3:4 alebo 9:16. Tvorba z prvej/poslednej snímky preberá pomer strán zo vstupného obrázka; referenčná tvorba môže použiť adaptívny alebo explicitný pomer. Celočíselná dĺžka výstupu je 4–15 sekúnd.\n\nKarta modelu rozlišuje H3-Context-IR, ktorý interpretuje a obohacuje zadanie, H3-Base, ktorý generuje audiovizuálny obsah, a H3-Regenerate-2K, ktorý vytvára výsledok vo vyššom rozlíšení. Zverejnené základné checkpointy oddeľujú úlohy vedené snímkami od úloh s omnimodálnymi referenciami. Komponenty kontextu a regenerovania sú oddelené od týchto základných váh, preto samotný názov otvoreného checkpointu nepotvrdzuje správanie celého systému.\n\nPostup generovania výrobcu je asynchrónny. Jeho rozhranie na zisťovanie stavu úloh načítava úlohy z predchádzajúcich siedmich dní. Identitu úlohy uchovajte, kým nepríde skutočný výsledok videa, a potom uložte klip namiesto uchovania iba časovo obmedzenej adresy na stiahnutie. Pri zamýšľanej veľkosti zobrazenia kontrolujte vizuálnu identitu, drobný text, interakcie objektov, hovorený obsah a časovanie zvuku. Výrobca označuje multimodálne porozumenie a jemné vizuálne detaily za oblasti pokračujúceho zlepšovania; podrobné zadanie a porovnávanie so zdrojom zostávajú základom užitočného výsledku.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "62381f8c6c79d7f952bc2e5e6e5ec7b91d13afd2fbf148a9b20b6a64dc2f76d7", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sk", "methods": [ { "html": "
MM

MiniMax: H3

MiniMax /minimax/hailuo-3

Úvod

MiniMax H3 generuje krátke video s natívnym stereofónnym zvukom z textu, snímok alebo multimodálnych referencií. Podporuje tvorbu z prvej/poslednej snímky, úpravy vedené referenciami a vzťahy pohybu či hlasu, s výstupom 4–15 sekúnd a samostatným postupom regenerovania v 2K.

Povolené vstupy
Text · Obrázky · Audio · Video
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.

Jeden audiovizuálny výsledok z multimodálneho zadania

MiniMax H3 je omnimodálny videosystém spoločnosti MiniMax. Spoločne interpretuje text, obrázky, video a zvuk a potom generuje video s natívnym stereofónnym zvukom. Výrobca ho predstavuje na krátku tvorivú prácu, napríklad produktové vizuály, reklamu, animované plagáty a koncepty filmových titulkov, pri ktorých sú vzťahy medzi referenčnými podkladmi rovnako dôležité ako opis scény.

Dokumentovaný systém vytvára video s dĺžkou 4–15 sekúnd pri 24 snímkach za sekundu so stereofónnym zvukom 32 kHz. Generovanie H3-Base pracuje v 768p; úplný postup 2K tento výsledok regeneruje pomocou pôvodného multimodálneho kontextu. Nejde iba o bežnú zmenu veľkosti: druhá etapa znovu používa model a zdrojový kontext na obnovu jemných detailov. H3 Max a H3-Context-IR majú samostatné úlohy a limity.

Tvorba z textu a vedená snímkami

Čisto textový vstup opisuje celú audiovizuálnu časovú os. Prvý obrázok ukotvuje začiatok, posledný koniec a dva obrázky môžu určiť oba. Pri zábere z úvodnej snímky vychádzajte z kompozície a identity viditeľnej na statickom obrázku a potom opíšte rozvíjajúcu sa akciu. Pri prechode od prvej k poslednej snímke opíšte pozorovateľný pohyb spájajúci oba stavy namiesto opakovania dvoch nesúvisiacich opisov obrázkov.

Praktické produktové zadanie môže určiť zatvorený obal v úvodnej snímke, ruku, ktorá ho otvára, jemný pohyb kamery a konečný stav, ktorý treba dosiahnuť. V dodaných snímkach zachovajte tvar predmetu, umiestnenie štítka a osvetlenie. Tvorba vedená snímkami a tvorba vedená referenciami sú samostatné vstupné režimy; rozhranie výrobcu v jednej požiadavke nemieša úlohy prvej/poslednej snímky s úlohami referenčných médií.

Generovanie a úpravy vedené referenciami

Referenčný režim prijíma text s obrázkami, videoklipmi a zvukovými klipmi. Určte prínos každého zdroja: vzhľad postavy, miesto, pohyb kamery, časovú štruktúru zdrojového klipu alebo hlas. Video použité iba na pohyb kamery sa líši od videa, ktoré sa má skutočne upraviť alebo v ktorom sa má pokračovať. Tento vzťah uveďte výslovne.

Referenčný návod výrobcu oddeľuje definície subjektov, súhrn úlohy, analýzu zachovania, podrobný opis záberu, celkové zvukové prostredie a hudobný podklad určený iba publiku. Rozlišuje zachovanie viditeľného obsahu od prenosu vlastností alebo všeobecnej štýlovej referencie. Pri zvuku sa kopírovanie signálu líši od odkazovania na farbu, rytmus či spôsob prednesu. Tieto úlohy udržujte v celom zadaní stabilné.

Pre scénu založenú na referenciách dodajte obrázok postavy, krátku referenciu pohybu kamery a zvukovú referenciu hlasu a potom opíšte, kde má každá ovplyvniť cieľový záber. Uveďte, ktoré detaily odevu, prostredia alebo predmetu musia zostať rozpoznateľné. Dokončený klip porovnajte s týmito požiadavkami vrátane kontinuity pohybu a vzťahu medzi viditeľným hovoriacim a počutým hlasom.

Reč, zvuk a časovanie záberov

H3 spoločne modeluje dialóg, fyzické zvuky, atmosféru a hudbu. Karta modelu dokumentuje stabilnú podporu dialógu v arabčine, čínštine, angličtine, francúzštine, nemčine, taliančine, japončine, kórejčine, portugalčine, ruštine a španielčine; pri ostatných jazykoch opisuje rozdielnu mieru podpory. Zadajte presné hovorené slová a jazyk so stabilnou identitou hovoriaceho naprieč zábermi.

Návody výrobcu na písanie zadaní používajú v opisných častiach angličtinu a dialóg aj viditeľný text zachovávajú v pôvodnom jazyku. Hovorený obsah používa <d>[Language] ...</d>, pričom identita hovoriaceho a opis hlasu sú mimo bloku. Rozlišujte fyzickú reč od komentára mimo obrazu a určte, kedy replika pokračuje cez strih alebo sa koncom preruší. Presne zachovajte aj viditeľný text. Množstvo reči prispôsobte zvolenej dĺžke a spoločne skontrolujte vykreslené slová aj počuteľnú repliku.

Pohyb kamery opisujte ako akciu vrátane rozsahu a rýchlosti, keď na nich záleží. Zábery číslujte v poradí prehrávania a časy strihov udržujte v rámci dĺžky videa. Zvuky scény, napríklad kroky alebo zatvorenie dverí, oddeľte od hudobného sprievodu počuteľného iba publiku. Vďaka týmto voľbám sa krátky plán záberov ľahšie interpretuje a porovnáva s výsledkom.

Príprava vstupov a číselné limity

Aktuálna schéma generovania vyžaduje neprázdny text v každom režime, najviac 7 000 znakov na textovú položku. Obrázky môžu byť JPG, JPEG, PNG, WebP, HEIC alebo HEIF, každý najviac 30 MB, s každou stranou od 256 do 5 760 pixelov a pomerom strán od 0.4 do 2.5. Vstup snímok povoľuje jeden úvodný a jeden záverečný obrázok; referenčný režim povoľuje až deväť referenčných obrázkov.

Referenčné video môže obsahovať až tri klipy MP4 alebo MOV, každý v dĺžke 2–15 sekúnd a spolu najviac 15 sekúnd. Klip môže mať najviac 50 MB; video kodek je H.264 alebo H.265, so zvukom AAC alebo MP3, stranami od 256 do 5 760 pixelov, pomerom strán od 0.4 do 2.5 a snímkovou frekvenciou od 23.976 do 60. Referenčný zvuk podporuje až tri klipy WAV alebo MP3, každý najviac 15 MB a 2–15 sekúnd, spolu najviac 15 sekúnd. Karta modelu obmedzuje zmiešané referenčné vstupy na 12 súborov. Dokumentovaný limit tela požiadavky je 64 MB, oddelený od limitov jednotlivých súborov.

Vyberajte iba referencie, ktoré prispievajú k zadaniu, a každý prínos uveďte výslovne. Jasný pohľad na subjekt je užitočnejší než niekoľko protichodných pohľadov bez vysvetlenia. Zachovajte poradie referencií, orežte nepodstatný materiál bez odstránenia potrebného kontextu scény a overte, že krátke zdrojové klipy obsahujú požadovanú akciu alebo hlasovú vlastnosť.

Tvar výstupu a celý systém

Rozhranie H3 výrobcu ponúka 768P a 2K. Čisto textové generovanie vyžaduje konkrétny pomer: 21:9, 16:9, 4:3, 1:1, 3:4 alebo 9:16. Tvorba z prvej/poslednej snímky preberá pomer strán zo vstupného obrázka; referenčná tvorba môže použiť adaptívny alebo explicitný pomer. Celočíselná dĺžka výstupu je 4–15 sekúnd.

Karta modelu rozlišuje H3-Context-IR, ktorý interpretuje a obohacuje zadanie, H3-Base, ktorý generuje audiovizuálny obsah, a H3-Regenerate-2K, ktorý vytvára výsledok vo vyššom rozlíšení. Zverejnené základné checkpointy oddeľujú úlohy vedené snímkami od úloh s omnimodálnymi referenciami. Komponenty kontextu a regenerovania sú oddelené od týchto základných váh, preto samotný názov otvoreného checkpointu nepotvrdzuje správanie celého systému.

Postup generovania výrobcu je asynchrónny. Jeho rozhranie na zisťovanie stavu úloh načítava úlohy z predchádzajúcich siedmich dní. Identitu úlohy uchovajte, kým nepríde skutočný výsledok videa, a potom uložte klip namiesto uchovania iba časovo obmedzenej adresy na stiahnutie. Pri zamýšľanej veľkosti zobrazenia kontrolujte vizuálnu identitu, drobný text, interakcie objektov, hovorený obsah a časovanie zvuku. Výrobca označuje multimodálne porozumenie a jemné vizuálne detaily za oblasti pokračujúceho zlepšovania; podrobné zadanie a porovnávanie so zdrojom zostávajú základom užitočného výsledku.

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Video POST /v1/videos
Vstup
text, image, audio, video
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
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
2K
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, true
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

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. V jednej požiadavke použite obrázky snímok alebo referenčné obrázky; nekombinujte oboje. 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

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

Reference to video · Textové zadanie a podporované obrazové, video a zvukové referencie. · Povinné: model, prompt, duration, input_references

input_references je pole objektov. Nastavte type na image_url, video_url, audio_url a použite zodpovedajúce pole obsahujúce url. Použite verejné HTTPS URL. Režim referencií vyberiete vynechaním frame_images. Odhad zahŕňa zobrazenú zložku za obrázok iba pri referenčných obrázkoch po prvých piatich. Konečný poplatok sa riadi skutočne účtovanou konfiguráciou. Nekombinujte referenčné obrázky s obrázkami snímok. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.

model: Typ: string · minimax/hailuo-3

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, audio, video
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žstvoÚčtovacia jednotkaPodmienky účtovaniaPoplatok
KonfiguráciaZákladné sadzby za tokenySadzobníkZákladná sadzbaOdhadované množstvo—Úč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áciaCena videaSadzobník—Odhadované množstvo—Účtovacia jednotkaza sekundu videaPodmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka.Poplatok
Výstup · Cena videa · Odhad iba na porovnanie $0.26 za sekundu videa
Konfiguráciareferenčný obrázokSadzobník—Odhadované množstvo—Účtovacia jednotkaza referenčný obrázokPodmienky účtovania—Poplatok
Vstup · referenčný obrázok · Odhad iba na porovnanie $0.08 za referenčný obrázok
KonfiguráciaOdhadované náklady na generovanieSadzobník—Odhadované množstvoodhad pre jedno generovanieÚčtovacia jednotka—Podmienky účtovania—Poplatok
Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $1.3 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.26 za sekundu videa

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

KonfiguráciaReferenčné obrázky po prvých piatichPodmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka.Poplatok
Vstup · Referenčné obrázky po prvých piatich $0.08 za obrázok

Prvých päť referenčných obrázkov je bezplatných; uvedená sadzba za obrázok platí po prvých piatich. Zverejnená cenová referencia 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","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', 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

Aliasy ciest metód

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

Súvisiace ID na volanie

minimax/hailuo-3

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3", "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" ], "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" ], "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. V jednej požiadavke použite obrázky snímok alebo referenčné obrázky; nekombinujte oboje. 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." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references je pole objektov. Nastavte type na image_url, video_url, audio_url a použite zodpovedajúce pole obsahujúce url. Použite verejné HTTPS URL. Režim referencií vyberiete vynechaním frame_images. Odhad zahŕňa zobrazenú zložku za obrázok iba pri referenčných obrázkoch po prvých piatich. Konečný poplatok sa riadi skutočne účtovanou konfiguráciou. Nekombinujte referenčné obrázky s obrázkami snímok. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Textové zadanie a podporované obrazové, video a zvukové referencie." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "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" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "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": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "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, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "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, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "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" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_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" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_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": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "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, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "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" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_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" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_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": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "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.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "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", "reference_to_video" ], "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": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "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": "1.3", "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": "1.3", "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\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', 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", "audio", "video" ], "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": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "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": "1.3", "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": "1.3", "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", "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.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "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": "1.3", "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", "nativeProvenance": { "input_facts_canonical_sha256": "66a80394aa24d2a1b9e5529d1c168bbf782101a09ca8ce68dc9353692ba1d4df", "input_html_sha256": "34bb1e92ad2ab96f4df46329892571e8208dcb80e59b2ec9442941fbe43bfda0", "private_audit_sha256": "a794d6b0ac5266314cb0fe2bba175281570a380ba886b1e3e5c8736c4ea71392", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/sk/minimax-hailuo-3/", "description": "MiniMax H3 generuje krátke video s natívnym stereofónnym zvukom z textu, snímok alebo multimodálnych referencií. Podporuje tvorbu z prvej/poslednej snímky, úpravy vedené referenciami a vzťahy pohybu či hlasu, s výstupom 4–15 sekúnd a samostatným postupom regenerovania v 2K.", "locale": "sk", "md_url": "https://ailoot.ai/models/sk/minimax-hailuo-3/index.md", "title": "MiniMax: H3 — Ailoot", "url": "https://ailoot.ai/models/sk/minimax-hailuo-3/" }, "rawModel": { "about": "Jeden audiovizuálny výsledok z multimodálneho zadania\n\nMiniMax H3 je omnimodálny videosystém spoločnosti MiniMax. Spoločne interpretuje text, obrázky, video a zvuk a potom generuje video s natívnym stereofónnym zvukom. Výrobca ho predstavuje na krátku tvorivú prácu, napríklad produktové vizuály, reklamu, animované plagáty a koncepty filmových titulkov, pri ktorých sú vzťahy medzi referenčnými podkladmi rovnako dôležité ako opis scény.\n\nDokumentovaný systém vytvára video s dĺžkou 4–15 sekúnd pri 24 snímkach za sekundu so stereofónnym zvukom 32 kHz. Generovanie H3-Base pracuje v 768p; úplný postup 2K tento výsledok regeneruje pomocou pôvodného multimodálneho kontextu. Nejde iba o bežnú zmenu veľkosti: druhá etapa znovu používa model a zdrojový kontext na obnovu jemných detailov. H3 Max a H3-Context-IR majú samostatné úlohy a limity.\n\nTvorba z textu a vedená snímkami\n\nČisto textový vstup opisuje celú audiovizuálnu časovú os. Prvý obrázok ukotvuje začiatok, posledný koniec a dva obrázky môžu určiť oba. Pri zábere z úvodnej snímky vychádzajte z kompozície a identity viditeľnej na statickom obrázku a potom opíšte rozvíjajúcu sa akciu. Pri prechode od prvej k poslednej snímke opíšte pozorovateľný pohyb spájajúci oba stavy namiesto opakovania dvoch nesúvisiacich opisov obrázkov.\n\nPraktické produktové zadanie môže určiť zatvorený obal v úvodnej snímke, ruku, ktorá ho otvára, jemný pohyb kamery a konečný stav, ktorý treba dosiahnuť. V dodaných snímkach zachovajte tvar predmetu, umiestnenie štítka a osvetlenie. Tvorba vedená snímkami a tvorba vedená referenciami sú samostatné vstupné režimy; rozhranie výrobcu v jednej požiadavke nemieša úlohy prvej/poslednej snímky s úlohami referenčných médií.\n\nGenerovanie a úpravy vedené referenciami\n\nReferenčný režim prijíma text s obrázkami, videoklipmi a zvukovými klipmi. Určte prínos každého zdroja: vzhľad postavy, miesto, pohyb kamery, časovú štruktúru zdrojového klipu alebo hlas. Video použité iba na pohyb kamery sa líši od videa, ktoré sa má skutočne upraviť alebo v ktorom sa má pokračovať. Tento vzťah uveďte výslovne.\n\nReferenčný návod výrobcu oddeľuje definície subjektov, súhrn úlohy, analýzu zachovania, podrobný opis záberu, celkové zvukové prostredie a hudobný podklad určený iba publiku. Rozlišuje zachovanie viditeľného obsahu od prenosu vlastností alebo všeobecnej štýlovej referencie. Pri zvuku sa kopírovanie signálu líši od odkazovania na farbu, rytmus či spôsob prednesu. Tieto úlohy udržujte v celom zadaní stabilné.\n\nPre scénu založenú na referenciách dodajte obrázok postavy, krátku referenciu pohybu kamery a zvukovú referenciu hlasu a potom opíšte, kde má každá ovplyvniť cieľový záber. Uveďte, ktoré detaily odevu, prostredia alebo predmetu musia zostať rozpoznateľné. Dokončený klip porovnajte s týmito požiadavkami vrátane kontinuity pohybu a vzťahu medzi viditeľným hovoriacim a počutým hlasom.\n\nReč, zvuk a časovanie záberov\n\nH3 spoločne modeluje dialóg, fyzické zvuky, atmosféru a hudbu. Karta modelu dokumentuje stabilnú podporu dialógu v arabčine, čínštine, angličtine, francúzštine, nemčine, taliančine, japončine, kórejčine, portugalčine, ruštine a španielčine; pri ostatných jazykoch opisuje rozdielnu mieru podpory. Zadajte presné hovorené slová a jazyk so stabilnou identitou hovoriaceho naprieč zábermi.\n\nNávody výrobcu na písanie zadaní používajú v opisných častiach angličtinu a dialóg aj viditeľný text zachovávajú v pôvodnom jazyku. Hovorený obsah používa `[Language] ...`, pričom identita hovoriaceho a opis hlasu sú mimo bloku. Rozlišujte fyzickú reč od komentára mimo obrazu a určte, kedy replika pokračuje cez strih alebo sa koncom preruší. Presne zachovajte aj viditeľný text. Množstvo reči prispôsobte zvolenej dĺžke a spoločne skontrolujte vykreslené slová aj počuteľnú repliku.\n\nPohyb kamery opisujte ako akciu vrátane rozsahu a rýchlosti, keď na nich záleží. Zábery číslujte v poradí prehrávania a časy strihov udržujte v rámci dĺžky videa. Zvuky scény, napríklad kroky alebo zatvorenie dverí, oddeľte od hudobného sprievodu počuteľného iba publiku. Vďaka týmto voľbám sa krátky plán záberov ľahšie interpretuje a porovnáva s výsledkom.\n\nPríprava vstupov a číselné limity\n\nAktuálna schéma generovania vyžaduje neprázdny text v každom režime, najviac 7 000 znakov na textovú položku. Obrázky môžu byť JPG, JPEG, PNG, WebP, HEIC alebo HEIF, každý najviac 30 MB, s každou stranou od 256 do 5 760 pixelov a pomerom strán od 0.4 do 2.5. Vstup snímok povoľuje jeden úvodný a jeden záverečný obrázok; referenčný režim povoľuje až deväť referenčných obrázkov.\n\nReferenčné video môže obsahovať až tri klipy MP4 alebo MOV, každý v dĺžke 2–15 sekúnd a spolu najviac 15 sekúnd. Klip môže mať najviac 50 MB; video kodek je H.264 alebo H.265, so zvukom AAC alebo MP3, stranami od 256 do 5 760 pixelov, pomerom strán od 0.4 do 2.5 a snímkovou frekvenciou od 23.976 do 60. Referenčný zvuk podporuje až tri klipy WAV alebo MP3, každý najviac 15 MB a 2–15 sekúnd, spolu najviac 15 sekúnd. Karta modelu obmedzuje zmiešané referenčné vstupy na 12 súborov. Dokumentovaný limit tela požiadavky je 64 MB, oddelený od limitov jednotlivých súborov.\n\nVyberajte iba referencie, ktoré prispievajú k zadaniu, a každý prínos uveďte výslovne. Jasný pohľad na subjekt je užitočnejší než niekoľko protichodných pohľadov bez vysvetlenia. Zachovajte poradie referencií, orežte nepodstatný materiál bez odstránenia potrebného kontextu scény a overte, že krátke zdrojové klipy obsahujú požadovanú akciu alebo hlasovú vlastnosť.\n\nTvar výstupu a celý systém\n\nRozhranie H3 výrobcu ponúka 768P a 2K. Čisto textové generovanie vyžaduje konkrétny pomer: 21:9, 16:9, 4:3, 1:1, 3:4 alebo 9:16. Tvorba z prvej/poslednej snímky preberá pomer strán zo vstupného obrázka; referenčná tvorba môže použiť adaptívny alebo explicitný pomer. Celočíselná dĺžka výstupu je 4–15 sekúnd.\n\nKarta modelu rozlišuje H3-Context-IR, ktorý interpretuje a obohacuje zadanie, H3-Base, ktorý generuje audiovizuálny obsah, a H3-Regenerate-2K, ktorý vytvára výsledok vo vyššom rozlíšení. Zverejnené základné checkpointy oddeľujú úlohy vedené snímkami od úloh s omnimodálnymi referenciami. Komponenty kontextu a regenerovania sú oddelené od týchto základných váh, preto samotný názov otvoreného checkpointu nepotvrdzuje správanie celého systému.\n\nPostup generovania výrobcu je asynchrónny. Jeho rozhranie na zisťovanie stavu úloh načítava úlohy z predchádzajúcich siedmich dní. Identitu úlohy uchovajte, kým nepríde skutočný výsledok videa, a potom uložte klip namiesto uchovania iba časovo obmedzenej adresy na stiahnutie. Pri zamýšľanej veľkosti zobrazenia kontrolujte vizuálnu identitu, drobný text, interakcie objektov, hovorený obsah a časovanie zvuku. Výrobca označuje multimodálne porozumenie a jemné vizuálne detaily za oblasti pokračujúceho zlepšovania; podrobné zadanie a porovnávanie so zdrojom zostávajú základom užitočného výsledku.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.3", "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": "1.3", "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": "ffcc346d33bca9e66b22f181", "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.26", "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": "Prvých päť referenčných obrázkov je bezplatných; uvedená sadzba za obrázok platí po prvých piatich. Zverejnená cenová referencia 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": "Referenčné obrázky po prvých piatich", "units": [ { "amount": "0.08", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Reference images after the first five", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_video_image_reference", "side": "in", "unit": "image" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3", "input": [ "text", "image", "audio", "video" ], "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" ], "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" ], "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. V jednej požiadavke použite obrázky snímok alebo referenčné obrázky; nekombinujte oboje. 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." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references je pole objektov. Nastavte type na image_url, video_url, audio_url a použite zodpovedajúce pole obsahujúce url. Použite verejné HTTPS URL. Režim referencií vyberiete vynechaním frame_images. Odhad zahŕňa zobrazenú zložku za obrázok iba pri referenčných obrázkoch po prvých piatich. Konečný poplatok sa riadi skutočne účtovanou konfiguráciou. Nekombinujte referenčné obrázky s obrázkami snímok. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Textové zadanie a podporované obrazové, video a zvukové referencie." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "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" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "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": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "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, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "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, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "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" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_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" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_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": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "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, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "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" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_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" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_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": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "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.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "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", "reference_to_video" ], "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": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "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": "1.3", "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": "1.3", "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\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', 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", "audio", "video" ], "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": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "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": "1.3", "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": "1.3", "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", "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.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "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.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "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": "1.3", "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", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" } ], "name": "MiniMax: H3", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.3, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.3, "varies": false }, "pricing_profiles": [ { "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": 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": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "2K" }, "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": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "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": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "2K" }, "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": 5, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.08", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 5, "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.26", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD", "billing_original_rate": "0.26", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_physical_unit", "basis": "reference image", "billing_original_currency": "USD", "billing_original_rate": "0.08", "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "quantity": 1, "side": "in", "unit": "reference_image" } ] } ], "public_id": "minimax/hailuo-3", "short": "MiniMax H3 generuje krátke video s natívnym stereofónnym zvukom z textu, snímok alebo multimodálnych referencií. Podporuje tvorbu z prvej/poslednej snímky, úpravy vedené referenciami a vzťahy pohybu či hlasu, s výstupom 4–15 sekúnd a samostatným postupom regenerovania v 2K." }, "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 generuje krátke video s natívnym stereofónnym zvukom z textu, snímok alebo multimodálnych referencií. Podporuje tvorbu z prvej/poslednej snímky, úpravy vedené referenciami a vzťahy pohybu či hlasu, s výstupom 4–15 sekúnd a samostatným postupom regenerovania v 2K.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "fc05ce600e26c8d114de0587e18ed4249b827b6c09d68e9f5367ba0f8f830e7a", "renderer_sha256": "94893ba0fa4d7b7d32370787b705f436a4c2569f84ec7b33063549adc74b07e0" }, "sourceRevision": "78d2382c6bf5a905012f215756cb736abc8f08d7f0563bf4d6fc08b36d554986" }