{ "aboutHtml": "

Jeden audiovizuální výsledek z multimodálního zadání

MiniMax H3 je omnimodální videosystém společnosti MiniMax. Společně interpretuje text, obrázky, video a zvuk a poté generuje video s nativním stereofonním zvukem. Výrobce jej představuje pro krátkou tvůrčí práci, jako jsou produktové vizuály, reklama, animované plakáty a návrhy filmových titulků, kde jsou vztahy mezi referenčními podklady stejně důležité jako popis scény.

Dokumentovaný systém vytváří videa dlouhá 4–15 sekund při 24 snímcích za sekundu se stereofonním zvukem 32 kHz. Generování H3-Base pracuje v 768p; úplný postup 2K tento výsledek regeneruje s využitím původního multimodálního kontextu. Nejde jen o běžnou změnu velikosti: druhá fáze znovu používá model a zdrojový kontext k obnovení jemných detailů. H3 Max a H3-Context-IR mají samostatné role a limity.

Tvorba z textu a pomocí snímků

Čistě textový vstup popisuje celou audiovizuální časovou osu. První obrázek ukotvuje začátek, poslední konec a dva obrázky mohou určit obojí. U záběru z úvodního snímku vyjděte z kompozice a identity viditelných na obrázku a poté popište rozvíjející se děj. U přechodu od prvního k poslednímu snímku popište pozorovatelný pohyb spojující oba stavy místo opakování dvou nesouvisejících popisů obrázků.

Praktické produktové zadání může určit zavřený obal v úvodním snímku, ruku, která jej otevře, jemný pohyb kamery a cílový konečný stav. V dodaných snímcích zachovejte tvar předmětu, umístění etikety a osvětlení. Tvorba vedená snímky a tvorba vedená referencemi jsou samostatné vstupní režimy; rozhraní výrobce nemíchá role prvního a posledního snímku s rolemi referenčních médií v jednom požadavku.

Generování a úpravy vedené referencemi

Referenční režim přijímá text s obrázky, videoklipy a zvukovými klipy. Určete, čím každý zdroj přispívá: vzhledem postavy, místem, pohybem kamery, časovou strukturou zdrojového klipu nebo hlasem. Video používané jen pro pohyb kamery se liší od videa, které se má skutečně upravit či prodloužit. Tento vztah výslovně uveďte.

Referenční příručka výrobce odděluje definice objektů, shrnutí úlohy, analýzu zachovávaných prvků, podrobný popis záběru, celkovou zvukovou atmosféru a hudební doprovod slyšitelný jen divákům. Rozlišuje zachování viditelného obsahu od přenosu vlastností či obecné stylové reference. U zvuku se kopírování signálu liší od odkazu na barvu hlasu, rytmus nebo přednes. Tyto role v celém zadání zachovejte stabilní.

Pro scénu vedenou referencemi dodejte obrázek postavy, krátkou referenci pohybu kamery a zvukovou referenci hlasu a poté popište, kde má každá ovlivnit cílový záběr. Uveďte, které detaily oděvu, prostředí nebo předmětu musí zůstat rozpoznatelné. Hotový klip porovnejte s těmito požadavky včetně kontinuity pohybu a vztahu mezi viditelným mluvčím a slyšeným hlasem.

Řeč, zvuk a načasování záběru

H3 společně modeluje dialog, fyzické zvuky, ruch prostředí a hudbu. Karta modelu dokumentuje stabilní podporu dialogu v arabštině, čínštině, angličtině, francouzštině, němčině, italštině, japonštině, korejštině, portugalštině, ruštině a španělštině; u ostatních jazyků popisuje proměnlivou podporu. Zadejte přesná mluvená slova a jazyk a zachovejte stabilní identitu mluvčího napříč záběry.

Příručky výrobce pro psaní promptů používají v popisných částech angličtinu a dialog i viditelný text ponechávají v původním jazyce. Mluvený obsah používá <d>[Language] ...</d>, přičemž identita mluvčího a popis hlasu jsou mimo blok. Odlišujte řeč postavy ve scéně od komentáře mimo obraz a určete, kdy replika pokračuje přes střih nebo ji ukončí konec. Také viditelný text zachovejte přesně. Množství řeči přizpůsobte zvolené délce a společně zkontrolujte vykreslená slova i slyšitelnou repliku.

Pohyb kamery popište jako akci včetně rozsahu a rychlosti, pokud jsou důležité. Záběry číslujte v pořadí přehrávání a časy střihů udržujte v rámci délky videa. Zvuky scény, například kroky či zavření dveří, oddělte od doprovodné hudby slyšitelné pouze divákům. Tyto volby usnadňují interpretaci krátkého plánu záběrů i jeho porovnání s výsledkem.

Příprava vstupů a číselné limity

Současné schéma generování vyžaduje v každém režimu neprázdný text, nejvýše 7 000 znaků na textovou položku. Obrázky mohou být JPG, JPEG, PNG, WebP, HEIC nebo HEIF, každý do 30 MB, s každou stranou od 256 do 5 760 pixelů a poměrem stran od 0,4 do 2,5. Snímkový vstup dovoluje jeden úvodní a jeden závěrečný obrázek; referenční režim až devět referenčních obrázků.

Referenční video může obsahovat až tři klipy MP4 nebo MOV, každý dlouhý 2–15 sekund a celkem nejvýše 15 sekund. Klip může mít do 50 MB; jeho kodek videa je H.264 nebo H.265, zvuk AAC nebo MP3, strany od 256 do 5 760 pixelů, poměry od 0,4 do 2,5 a snímková frekvence od 23,976 do 60. Referenční zvuk podporuje až tři klipy WAV nebo MP3, každý do 15 MB, každý dlouhý 2–15 sekund a celkem nejvýše 15 sekund. Karta modelu omezuje smíšené referenční vstupy na 12 souborů. Dokumentovaný limit těla požadavku je 64 MB a je odlišný od limitů jednotlivých souborů.

Vybírejte jen reference přispívající k zadání a přínos každé výslovně uveďte. Jasný pohled na objekt je užitečnější než několik rozporných pohledů bez vysvětlení. Zachovejte pořadí referencí, ořízněte nepodstatný materiál bez odstranění nutného kontextu scény a ověřte, že krátké zdrojové klipy obsahují požadovaný děj či hlasovou charakteristiku.

Formát výstupu a úplný systém

Rozhraní H3 výrobce nabízí 768P a 2K. Generování pouze z textu vyžaduje konkrétní poměr: 21:9, 16:9, 4:3, 1:1, 3:4 nebo 9:16. Tvorba z prvního a posledního snímku přebírá poměr vstupního obrázku; tvorba z referencí může použít adaptivní nebo explicitní poměr. Celočíselná délka výstupu je 4–15 sekund.

Karta modelu rozlišuje H3-Context-IR, který interpretuje a obohacuje zadání, H3-Base, který generuje audiovizuální obsah, a H3-Regenerate-2K, který vytváří výsledek s vyšším rozlišením. Vydané základní checkpointy oddělují úlohy vedené snímky a úlohy s omnimodálními referencemi. Kontextové a regenerační komponenty se liší od těchto základních vah, takže samotný název otevřeného checkpointu nedokládá chování celého systému.

Postup generování výrobce je asynchronní. Rozhraní pro dotazování na úlohy vyhledává úlohy z předchozích sedmi dnů. Identitu úlohy uchovejte do vrácení skutečného výsledného videa a poté uložte klip místo samotné časově omezené adresy ke stažení. V zamýšleném měřítku zobrazení zkontrolujte vizuální identitu, drobný text, interakce předmětů, mluvený obsah a načasování zvuku. Výrobce označuje multimodální porozumění a jemné vizuální detaily za oblasti dalšího zlepšování; podrobné zadání a porovnání se zdrojem zůstávají klíčem k užitečnému výsledku.

", "aboutText": "Jeden audiovizuální výsledek z multimodálního zadání\n\nMiniMax H3 je omnimodální videosystém společnosti MiniMax. Společně interpretuje text, obrázky, video a zvuk a poté generuje video s nativním stereofonním zvukem. Výrobce jej představuje pro krátkou tvůrčí práci, jako jsou produktové vizuály, reklama, animované plakáty a návrhy filmových titulků, kde jsou vztahy mezi referenčními podklady stejně důležité jako popis scény.\n\nDokumentovaný systém vytváří videa dlouhá 4–15 sekund při 24 snímcích za sekundu se stereofonním zvukem 32 kHz. Generování H3-Base pracuje v 768p; úplný postup 2K tento výsledek regeneruje s využitím původního multimodálního kontextu. Nejde jen o běžnou změnu velikosti: druhá fáze znovu používá model a zdrojový kontext k obnovení jemných detailů. H3 Max a H3-Context-IR mají samostatné role a limity.\n\nTvorba z textu a pomocí snímků\n\nČistě textový vstup popisuje celou audiovizuální časovou osu. První obrázek ukotvuje začátek, poslední konec a dva obrázky mohou určit obojí. U záběru z úvodního snímku vyjděte z kompozice a identity viditelných na obrázku a poté popište rozvíjející se děj. U přechodu od prvního k poslednímu snímku popište pozorovatelný pohyb spojující oba stavy místo opakování dvou nesouvisejících popisů obrázků.\n\nPraktické produktové zadání může určit zavřený obal v úvodním snímku, ruku, která jej otevře, jemný pohyb kamery a cílový konečný stav. V dodaných snímcích zachovejte tvar předmětu, umístění etikety a osvětlení. Tvorba vedená snímky a tvorba vedená referencemi jsou samostatné vstupní režimy; rozhraní výrobce nemíchá role prvního a posledního snímku s rolemi referenčních médií v jednom požadavku.\n\nGenerování a úpravy vedené referencemi\n\nReferenční režim přijímá text s obrázky, videoklipy a zvukovými klipy. Určete, čím každý zdroj přispívá: vzhledem postavy, místem, pohybem kamery, časovou strukturou zdrojového klipu nebo hlasem. Video používané jen pro pohyb kamery se liší od videa, které se má skutečně upravit či prodloužit. Tento vztah výslovně uveďte.\n\nReferenční příručka výrobce odděluje definice objektů, shrnutí úlohy, analýzu zachovávaných prvků, podrobný popis záběru, celkovou zvukovou atmosféru a hudební doprovod slyšitelný jen divákům. Rozlišuje zachování viditelného obsahu od přenosu vlastností či obecné stylové reference. U zvuku se kopírování signálu liší od odkazu na barvu hlasu, rytmus nebo přednes. Tyto role v celém zadání zachovejte stabilní.\n\nPro scénu vedenou referencemi dodejte obrázek postavy, krátkou referenci pohybu kamery a zvukovou referenci hlasu a poté popište, kde má každá ovlivnit cílový záběr. Uveďte, které detaily oděvu, prostředí nebo předmětu musí zůstat rozpoznatelné. Hotový klip porovnejte s těmito požadavky včetně kontinuity pohybu a vztahu mezi viditelným mluvčím a slyšeným hlasem.\n\nŘeč, zvuk a načasování záběru\n\nH3 společně modeluje dialog, fyzické zvuky, ruch prostředí a hudbu. Karta modelu dokumentuje stabilní podporu dialogu v arabštině, čínštině, angličtině, francouzštině, němčině, italštině, japonštině, korejštině, portugalštině, ruštině a španělštině; u ostatních jazyků popisuje proměnlivou podporu. Zadejte přesná mluvená slova a jazyk a zachovejte stabilní identitu mluvčího napříč záběry.\n\nPříručky výrobce pro psaní promptů používají v popisných částech angličtinu a dialog i viditelný text ponechávají v původním jazyce. Mluvený obsah používá `[Language] ...`, přičemž identita mluvčího a popis hlasu jsou mimo blok. Odlišujte řeč postavy ve scéně od komentáře mimo obraz a určete, kdy replika pokračuje přes střih nebo ji ukončí konec. Také viditelný text zachovejte přesně. Množství řeči přizpůsobte zvolené délce a společně zkontrolujte vykreslená slova i slyšitelnou repliku.\n\nPohyb kamery popište jako akci včetně rozsahu a rychlosti, pokud jsou důležité. Záběry číslujte v pořadí přehrávání a časy střihů udržujte v rámci délky videa. Zvuky scény, například kroky či zavření dveří, oddělte od doprovodné hudby slyšitelné pouze divákům. Tyto volby usnadňují interpretaci krátkého plánu záběrů i jeho porovnání s výsledkem.\n\nPříprava vstupů a číselné limity\n\nSoučasné schéma generování vyžaduje v každém režimu neprázdný text, nejvýše 7 000 znaků na textovou položku. Obrázky mohou být JPG, JPEG, PNG, WebP, HEIC nebo HEIF, každý do 30 MB, s každou stranou od 256 do 5 760 pixelů a poměrem stran od 0,4 do 2,5. Snímkový vstup dovoluje jeden úvodní a jeden závěrečný obrázek; referenční režim až devět referenčních obrázků.\n\nReferenční video může obsahovat až tři klipy MP4 nebo MOV, každý dlouhý 2–15 sekund a celkem nejvýše 15 sekund. Klip může mít do 50 MB; jeho kodek videa je H.264 nebo H.265, zvuk AAC nebo MP3, strany od 256 do 5 760 pixelů, poměry od 0,4 do 2,5 a snímková frekvence od 23,976 do 60. Referenční zvuk podporuje až tři klipy WAV nebo MP3, každý do 15 MB, každý dlouhý 2–15 sekund a celkem nejvýše 15 sekund. Karta modelu omezuje smíšené referenční vstupy na 12 souborů. Dokumentovaný limit těla požadavku je 64 MB a je odlišný od limitů jednotlivých souborů.\n\nVybírejte jen reference přispívající k zadání a přínos každé výslovně uveďte. Jasný pohled na objekt je užitečnější než několik rozporných pohledů bez vysvětlení. Zachovejte pořadí referencí, ořízněte nepodstatný materiál bez odstranění nutného kontextu scény a ověřte, že krátké zdrojové klipy obsahují požadovaný děj či hlasovou charakteristiku.\n\nFormát výstupu a úplný systém\n\nRozhraní H3 výrobce nabízí 768P a 2K. Generování pouze z textu vyžaduje konkrétní poměr: 21:9, 16:9, 4:3, 1:1, 3:4 nebo 9:16. Tvorba z prvního a posledního snímku přebírá poměr vstupního obrázku; tvorba z referencí může použít adaptivní nebo explicitní poměr. Celočíselná délka výstupu je 4–15 sekund.\n\nKarta modelu rozlišuje H3-Context-IR, který interpretuje a obohacuje zadání, H3-Base, který generuje audiovizuální obsah, a H3-Regenerate-2K, který vytváří výsledek s vyšším rozlišením. Vydané základní checkpointy oddělují úlohy vedené snímky a úlohy s omnimodálními referencemi. Kontextové a regenerační komponenty se liší od těchto základních vah, takže samotný název otevřeného checkpointu nedokládá chování celého systému.\n\nPostup generování výrobce je asynchronní. Rozhraní pro dotazování na úlohy vyhledává úlohy z předchozích sedmi dnů. Identitu úlohy uchovejte do vrácení skutečného výsledného videa a poté uložte klip místo samotné časově omezené adresy ke stažení. V zamýšleném měřítku zobrazení zkontrolujte vizuální identitu, drobný text, interakce předmětů, mluvený obsah a načasování zvuku. Výrobce označuje multimodální porozumění a jemné vizuální detaily za oblasti dalšího zlepšování; podrobné zadání a porovnání se zdrojem zůstávají klíčem k užitečnému výsledku.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "741d745ab0ac81f882f47fbf2e935eb3a14921f96bacb8c545eb4e93e157ebe0", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "cs", "methods": [ { "html": "
MM

MiniMax: H3

MiniMax /minimax/hailuo-3

Úvod

MiniMax H3 generuje krátká videa s nativním stereofonním zvukem z textu, snímků nebo multimodálních referencí. Podporuje tvorbu z prvního či posledního snímku, úpravy vedené referencemi a vztahy pohybu či hlasu, s výstupem 4–15 sekund a samostatným postupem regenerování do 2K.

Přijímané vstupy
Text · Obrázky · Zvuk · Video
Výsledky
Video
O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Jeden audiovizuální výsledek z multimodálního zadání

MiniMax H3 je omnimodální videosystém společnosti MiniMax. Společně interpretuje text, obrázky, video a zvuk a poté generuje video s nativním stereofonním zvukem. Výrobce jej představuje pro krátkou tvůrčí práci, jako jsou produktové vizuály, reklama, animované plakáty a návrhy filmových titulků, kde jsou vztahy mezi referenčními podklady stejně důležité jako popis scény.

Dokumentovaný systém vytváří videa dlouhá 4–15 sekund při 24 snímcích za sekundu se stereofonním zvukem 32 kHz. Generování H3-Base pracuje v 768p; úplný postup 2K tento výsledek regeneruje s využitím původního multimodálního kontextu. Nejde jen o běžnou změnu velikosti: druhá fáze znovu používá model a zdrojový kontext k obnovení jemných detailů. H3 Max a H3-Context-IR mají samostatné role a limity.

Tvorba z textu a pomocí snímků

Čistě textový vstup popisuje celou audiovizuální časovou osu. První obrázek ukotvuje začátek, poslední konec a dva obrázky mohou určit obojí. U záběru z úvodního snímku vyjděte z kompozice a identity viditelných na obrázku a poté popište rozvíjející se děj. U přechodu od prvního k poslednímu snímku popište pozorovatelný pohyb spojující oba stavy místo opakování dvou nesouvisejících popisů obrázků.

Praktické produktové zadání může určit zavřený obal v úvodním snímku, ruku, která jej otevře, jemný pohyb kamery a cílový konečný stav. V dodaných snímcích zachovejte tvar předmětu, umístění etikety a osvětlení. Tvorba vedená snímky a tvorba vedená referencemi jsou samostatné vstupní režimy; rozhraní výrobce nemíchá role prvního a posledního snímku s rolemi referenčních médií v jednom požadavku.

Generování a úpravy vedené referencemi

Referenční režim přijímá text s obrázky, videoklipy a zvukovými klipy. Určete, čím každý zdroj přispívá: vzhledem postavy, místem, pohybem kamery, časovou strukturou zdrojového klipu nebo hlasem. Video používané jen pro pohyb kamery se liší od videa, které se má skutečně upravit či prodloužit. Tento vztah výslovně uveďte.

Referenční příručka výrobce odděluje definice objektů, shrnutí úlohy, analýzu zachovávaných prvků, podrobný popis záběru, celkovou zvukovou atmosféru a hudební doprovod slyšitelný jen divákům. Rozlišuje zachování viditelného obsahu od přenosu vlastností či obecné stylové reference. U zvuku se kopírování signálu liší od odkazu na barvu hlasu, rytmus nebo přednes. Tyto role v celém zadání zachovejte stabilní.

Pro scénu vedenou referencemi dodejte obrázek postavy, krátkou referenci pohybu kamery a zvukovou referenci hlasu a poté popište, kde má každá ovlivnit cílový záběr. Uveďte, které detaily oděvu, prostředí nebo předmětu musí zůstat rozpoznatelné. Hotový klip porovnejte s těmito požadavky včetně kontinuity pohybu a vztahu mezi viditelným mluvčím a slyšeným hlasem.

Řeč, zvuk a načasování záběru

H3 společně modeluje dialog, fyzické zvuky, ruch prostředí a hudbu. Karta modelu dokumentuje stabilní podporu dialogu v arabštině, čínštině, angličtině, francouzštině, němčině, italštině, japonštině, korejštině, portugalštině, ruštině a španělštině; u ostatních jazyků popisuje proměnlivou podporu. Zadejte přesná mluvená slova a jazyk a zachovejte stabilní identitu mluvčího napříč záběry.

Příručky výrobce pro psaní promptů používají v popisných částech angličtinu a dialog i viditelný text ponechávají v původním jazyce. Mluvený obsah používá <d>[Language] ...</d>, přičemž identita mluvčího a popis hlasu jsou mimo blok. Odlišujte řeč postavy ve scéně od komentáře mimo obraz a určete, kdy replika pokračuje přes střih nebo ji ukončí konec. Také viditelný text zachovejte přesně. Množství řeči přizpůsobte zvolené délce a společně zkontrolujte vykreslená slova i slyšitelnou repliku.

Pohyb kamery popište jako akci včetně rozsahu a rychlosti, pokud jsou důležité. Záběry číslujte v pořadí přehrávání a časy střihů udržujte v rámci délky videa. Zvuky scény, například kroky či zavření dveří, oddělte od doprovodné hudby slyšitelné pouze divákům. Tyto volby usnadňují interpretaci krátkého plánu záběrů i jeho porovnání s výsledkem.

Příprava vstupů a číselné limity

Současné schéma generování vyžaduje v každém režimu neprázdný text, nejvýše 7 000 znaků na textovou položku. Obrázky mohou být JPG, JPEG, PNG, WebP, HEIC nebo HEIF, každý do 30 MB, s každou stranou od 256 do 5 760 pixelů a poměrem stran od 0,4 do 2,5. Snímkový vstup dovoluje jeden úvodní a jeden závěrečný obrázek; referenční režim až devět referenčních obrázků.

Referenční video může obsahovat až tři klipy MP4 nebo MOV, každý dlouhý 2–15 sekund a celkem nejvýše 15 sekund. Klip může mít do 50 MB; jeho kodek videa je H.264 nebo H.265, zvuk AAC nebo MP3, strany od 256 do 5 760 pixelů, poměry od 0,4 do 2,5 a snímková frekvence od 23,976 do 60. Referenční zvuk podporuje až tři klipy WAV nebo MP3, každý do 15 MB, každý dlouhý 2–15 sekund a celkem nejvýše 15 sekund. Karta modelu omezuje smíšené referenční vstupy na 12 souborů. Dokumentovaný limit těla požadavku je 64 MB a je odlišný od limitů jednotlivých souborů.

Vybírejte jen reference přispívající k zadání a přínos každé výslovně uveďte. Jasný pohled na objekt je užitečnější než několik rozporných pohledů bez vysvětlení. Zachovejte pořadí referencí, ořízněte nepodstatný materiál bez odstranění nutného kontextu scény a ověřte, že krátké zdrojové klipy obsahují požadovaný děj či hlasovou charakteristiku.

Formát výstupu a úplný systém

Rozhraní H3 výrobce nabízí 768P a 2K. Generování pouze z textu vyžaduje konkrétní poměr: 21:9, 16:9, 4:3, 1:1, 3:4 nebo 9:16. Tvorba z prvního a posledního snímku přebírá poměr vstupního obrázku; tvorba z referencí může použít adaptivní nebo explicitní poměr. Celočíselná délka výstupu je 4–15 sekund.

Karta modelu rozlišuje H3-Context-IR, který interpretuje a obohacuje zadání, H3-Base, který generuje audiovizuální obsah, a H3-Regenerate-2K, který vytváří výsledek s vyšším rozlišením. Vydané základní checkpointy oddělují úlohy vedené snímky a úlohy s omnimodálními referencemi. Kontextové a regenerační komponenty se liší od těchto základních vah, takže samotný název otevřeného checkpointu nedokládá chování celého systému.

Postup generování výrobce je asynchronní. Rozhraní pro dotazování na úlohy vyhledává úlohy z předchozích sedmi dnů. Identitu úlohy uchovejte do vrácení skutečného výsledného videa a poté uložte klip místo samotné časově omezené adresy ke stažení. V zamýšleném měřítku zobrazení zkontrolujte vizuální identitu, drobný text, interakce předmětů, mluvený obsah a načasování zvuku. Výrobce označuje multimodální porozumění a jemné vizuální detaily za oblasti dalšího zlepšování; podrobné zadání a porovnání se zdrojem zůstávají klíčem k užitečnému výsledku.

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Video POST /v1/videos
Vstup
text, image, audio, video
Výstup
video
Výstupní formát
původní bajty MP4; bez normalizace a překódování
PoleTypPožadavekHodnoty a limityVýchozí
PolemodelTypstringPožadavekPovinnéHodnoty a limity
minimax/hailuo-3
Výchozí—
PolepromptTypstringPožadavekPovinnéHodnoty a limityVýchozí—
PoledurationTypintegerPožadavekPovinnéHodnoty a limity
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maximum: 600
Výchozí—
PoleresolutionTypstringPožadavekVolitelnéHodnoty a limity
2K
Výchozí—
Poleaspect_ratioTypstringPožadavekVolitelnéHodnoty a limity
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Výchozí—
Polegenerate_audioTypbooleanPožadavekVolitelnéHodnoty a limity
false, true
Výchozí—
Poleframe_imagesTyparrayPožadavekVolitelnéHodnoty a limity
Minimální počet položek: 1
Maximální počet položek: 2
Vstupní obsah: Pole objektů snímků. Každý objekt obsahuje type=image_url, image_url obsahující url a frame_type. Použijte HTTPS URL obrázku a nastavte frame_type na first_frame nebo last_frame. Každá role snímku se smí vyskytnout nejvýše jednou.
Přesné klíče: type, image_url, frame_type
Podmínky: Tyto klíče popisují každý objekt snímku; image_url obsahuje pouze url. Pro požadavek obsahující pouze text vynechte frame_images.
Výchozí—
Poleinput_referencesTyparrayPožadavekVolitelnéHodnoty a limityVýchozí—
Polecallback_urlTypstringPožadavekVolitelnéHodnoty a limity
Vzor: ^https://
Výchozí—
Polesession_idTypstringPožadavekVolitelnéHodnoty a limityVýchozí—
PoletraceTypobjectPožadavekVolitelnéHodnoty a limityVýchozí—
PoleuserTypstringPožadavekVolitelnéHodnoty a limityVýchozí—
Kombinace vstupních materiálů

Text na video · Textové zadání. · Povinné: model, prompt, duration

Zadejte prompt jako text a duration v celých sekundách. Vyberte podporované rozlišení a případně poměr stran.

model: Typ: string · minimax/hailuo-3

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Obrázek na video · Textové zadání a obrázek prvního snímku. · Povinné: model, prompt, duration, frame_images

frame_images je pole. Každý objekt snímku obsahuje type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použijte first_frame s volitelným last_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Pro každý snímek zadejte veřejnou HTTPS URL obrázku. V jednom požadavku používejte buď obrázky snímků, nebo obrazové reference; obojí nekombinujte. Vyberte podporované rozlišení a případně poměr stran.

Přesné klíče: type, image_url, frame_type

model: Typ: string · minimax/hailuo-3

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Reference to video · Textové zadání a podporované obrazové, video a zvukové reference. · Povinné: model, prompt, duration, input_references

input_references je pole objektů. Nastavte type na image_url, video_url nebo audio_url a použijte odpovídající pole obsahující url. Používejte veřejné HTTPS URL. Vynecháním frame_images zvolíte režim referencí. Odhad zahrnuje zobrazenou složku ceny za obrázek pouze u obrazových referencí po prvních pěti. Konečná částka odpovídá skutečně účtované konfiguraci. Nekombinujte obrazové reference s obrázky snímků. Vyberte podporované rozlišení a případně poměr stran.

model: Typ: string · minimax/hailuo-3

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Parametry a životní cyklus metody
ParametrKontrakt
Parametrcontent_typeKontraktapplication/json
ParametrrequiredKontraktmodel, prompt, duration
Parametrmaterial_typesKontrakttext, image, audio, video
Parametradditional_propertiesKontraktfalse
Parametroptional_controlsKontraktresolution, 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

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim
Neuvedeno Při výběru rychlého režimu
Režim flex
Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování
Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

KonfiguraceTabulka sazebPředpokládané množstvíÚčtovací jednotkaPodmínky účtováníPoplatek
KonfiguraceZákladní sazby za tokenyTabulka sazebZákladní sazbaPředpokládané množství—Účtovací jednotka—Podmínky účtování—Poplatek
Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů
Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů
Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů
Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů
Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
KonfiguraceCena videaTabulka sazeb—Předpokládané množství—Účtovací jednotkaza sekundu videaPodmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka.Poplatek
Výstup · Cena videa · Odhad pouze pro srovnání $0.26 za sekundu videa
Konfiguracereferenční obrázekTabulka sazeb—Předpokládané množství—Účtovací jednotkaza referenční obrázekPodmínky účtování—Poplatek
Vstup · referenční obrázek · Odhad pouze pro srovnání $0.08 za referenční obrázek
KonfiguraceOdhadovaná cena generováníTabulka sazeb—Předpokládané množstvíodhad pro jedno generováníÚčtovací jednotka—Podmínky účtování—Poplatek
Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $1.3 odhad před generováním

Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Podrobnosti referenčního tarifu

Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.

Cenové reference konfigurací videa

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

KonfiguracePodmínky účtováníPoplatek
KonfiguraceCena videaPodmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka.Poplatek
Výstup · Cena videa $0.26 za sekundu videa

Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.

KonfiguraceReferenční obrázky po prvních pětiPodmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka.Poplatek
Vstup · Referenční obrázky po prvních pěti $0.08 za obrázek

Prvních pět referenčních obrázků je zdarma; uvedená sazba za obrázek platí až po prvních pěti. Zveřejněná cenová reference pro zobrazenou konfiguraci. Konečné částky odpovídají skutečně účtované konfiguraci.

Příklady požadavků

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

Přijímání a ukládání výsledků

Ailoot Ultra · Video

podepsané URL obsahu spravovaného službou

Ověřit 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
Další načtení 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
Uchovejte všechny dokončené výsledky

Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.

Uchovejte každý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.

Pokud je nutné ověřit původní odpověď

503 result_pending_check + původní id + X-Should-Retry:false; původní požadavek nikdy neopakujte

Pole odpovědi
PoleTypVýznam
PoleindexTypintegerVýznamPozice tohoto videa v seznamu výstupů, číslovaná od nuly.
Polecontent_urlTypstringVýznamPodepsaná HTTPS URL pro stažení tohoto dokončeného videa.
Polesha256Typstring | nullVýznamOtisk SHA-256 původních bajtů videa; null, není-li dostupný.
Polesize_bytesTypinteger | nullVýznamVelikost původního videosouboru v bajtech; null, není-li dostupná.
Poleduration_msTypinteger | nullVýznamNaměřená délka videa v milisekundách; null, není-li dostupná.
PolewidthTypinteger | nullVýznamŠířka videa v pixelech; null, není-li dostupná.
PoleheightTypinteger | nullVýznamVýška videa v pixelech; null, není-li dostupná.
Polevideo_codecTypstring | nullVýznamIdentifikátor video kodeku; null, není-li zaznamenán.
Polehas_audioTypboolean | nullVýznamZda video obsahuje zvukovou stopu; null, nebylo-li změřeno.
Poleaudio_codecTypstring | nullVýznamIdentifikátor zvukového kodeku; null, není-li žádný identifikátor zaznamenán.
Chyby a další kroky
OdpověďPodmínkaDalší krok
Odpověď404 · not_found_errorPodmínkaPřístup k videu není dostupný nebo toto ID videa nebylo nalezeno.Další krokZkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API.
Odpověď401 · authentication_errorPodmínkaKlíč API neodpovídá ověřenému účtu.Další krokPřed odesláním zkontrolujte svůj klíč API a přístup k účtu.
Odpověď400 · invalid_request_errorPodmínkaPožadavek se nepodařilo načíst nebo je index pro stažení neplatný.Další krokOpravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou.
Odpověď422 · price_unavailablePodmínkaVybranou konfiguraci videa nelze ocenit.Další krokPřed odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby.
Odpověď422 · invalid_request_errorPodmínkaVstup videa nebo původní úloha pro pokračování jsou neplatné.Další krokPoužívejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API.
Odpověď402 · billing_errorPodmínkaDostupný zůstatek nebo limity neumožňují rezervaci.Další krokPřed odesláním nového požadavku zkontrolujte dostupný zůstatek a limity.
Odpověď503 · server_errorPodmínkaOvěřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné.Další krokPočkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování.
Odpověď503 · result_pending_checkPodmínkaPůvodní výsledek videa a vyúčtovanou částku je třeba zkontrolovat.Další krokUchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování.
Odpověď503 · owned_result_unavailablePodmínkaStávající video je dočasně nedostupné ke stažení.Další krokPozději zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci.
Odpověď409 · video_not_readyPodmínkaObsah videa nebyl zveřejněn.Další krokZkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování.

Aliasy

Aliasy modelu

Ailoot Ultra minimax/hailuo-3

Aliasy cest metod

Použijte cesty metod uvedené výše.

Související ID modelů

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é sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.", "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": "Uchovejte každý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.", "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": "Přístup k videu není dostupný nebo toto ID videa nebylo nalezeno.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Zkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API.", "type": "not_found_error" }, { "condition": "Klíč API neodpovídá ověřenému účtu.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Před odesláním zkontrolujte svůj klíč API a přístup k účtu.", "type": "authentication_error" }, { "condition": "Požadavek se nepodařilo načíst nebo je index pro stažení neplatný.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Opravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou.", "type": "invalid_request_error" }, { "condition": "Vybranou konfiguraci videa nelze ocenit.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Před odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby.", "type": "price_unavailable" }, { "condition": "Vstup videa nebo původní úloha pro pokračování jsou neplatné.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Používejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API.", "type": "invalid_request_error" }, { "condition": "Dostupný zůstatek nebo limity neumožňují rezervaci.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Před odesláním nového požadavku zkontrolujte dostupný zůstatek a limity.", "type": "billing_error" }, { "condition": "Ověřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Počkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Původní výsledek videa a vyúčtovanou částku je třeba zkontrolovat.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Uchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Stávající video je dočasně nedostupné ke stažení.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Později zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci.", "type": "server_error" }, { "condition": "Obsah videa nebyl zveřejněn.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Zkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování.", "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žadavek nikdy neopakujte" }, "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": "Zadejte prompt jako text a duration v celých sekundách. Vyberte podporované rozlišení a případně poměr stran.", "required": [ "model", "prompt", "duration" ], "required_material": "Textové zadání." }, { "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ímku obsahuje type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použijte first_frame s volitelným last_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Pro každý snímek zadejte veřejnou HTTPS URL obrázku. V jednom požadavku používejte buď obrázky snímků, nebo obrazové reference; obojí nekombinujte. Vyberte podporované rozlišení a případně poměr stran.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Textové zadání a obrázek prvního snímku." }, { "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 objektů. Nastavte type na image_url, video_url nebo audio_url a použijte odpovídající pole obsahující url. Používejte veřejné HTTPS URL. Vynecháním frame_images zvolíte režim referencí. Odhad zahrnuje zobrazenou složku ceny za obrázek pouze u obrazových referencí po prvních pěti. Konečná částka odpovídá skutečně účtované konfiguraci. Nekombinujte obrazové reference s obrázky snímků. Vyberte podporované rozlišení a případně poměr stran.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Textové zadání a podporované obrazové, video a zvukové reference." } ], "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": "Pozice tohoto videa v seznamu výstupů, čí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": "Podepsaná HTTPS URL pro stažení tohoto 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": "Otisk SHA-256 původních bajtů videa; null, není-li 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": "Velikost původního videosouboru v bajtech; null, není-li 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": "Naměřená délka videa v milisekundách; null, není-li 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": "Šířka videa v pixelech; null, není-li 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 pixelech; null, není-li 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, není-li zaznamenán.", "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": "Zda video obsahuje zvukovou stopu; null, nebylo-li změřeno.", "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, není-li žádný identifikátor zaznamenán.", "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": "podepsané URL obsahu spravovaného službou", "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": "Tyto klíče popisují každý objekt snímku; image_url obsahuje pouze url. Pro požadavek obsahující pouze text vynechte frame_images.", "content": "Pole objektů snímků. Každý objekt obsahuje type=image_url, image_url obsahující url a frame_type. Použijte HTTPS URL obrázku a nastavte frame_type na first_frame nebo last_frame. Každá role snímku se smí vyskytnout nejvýše jednou.", "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 není dodatečným poplatkem ani pevnou sazbou za dokončené generování.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Odhadovaná cena generování", "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": "3ab7a07fe7a36e642449a9475a4a5c4afdf8b872ffa0f8ad4fd328f129b623a7", "input_html_sha256": "82e28eb3023c869f0bf897aac05b6444da26e45edefc7138fbe0af634bf9e74e", "private_audit_sha256": "72a67119f6bf612bb5ea68507908aeffeabcd4469c47fd1604a6b5191a7961c4", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/cs/minimax-hailuo-3/", "description": "MiniMax H3 generuje krátká videa s nativním stereofonním zvukem z textu, snímků nebo multimodálních referencí. Podporuje tvorbu z prvního či posledního snímku, úpravy vedené referencemi a vztahy pohybu či hlasu, s výstupem 4–15 sekund a samostatným postupem regenerování do 2K.", "locale": "cs", "md_url": "https://ailoot.ai/models/cs/minimax-hailuo-3/index.md", "title": "MiniMax: H3 — Ailoot", "url": "https://ailoot.ai/models/cs/minimax-hailuo-3/" }, "rawModel": { "about": "Jeden audiovizuální výsledek z multimodálního zadání\n\nMiniMax H3 je omnimodální videosystém společnosti MiniMax. Společně interpretuje text, obrázky, video a zvuk a poté generuje video s nativním stereofonním zvukem. Výrobce jej představuje pro krátkou tvůrčí práci, jako jsou produktové vizuály, reklama, animované plakáty a návrhy filmových titulků, kde jsou vztahy mezi referenčními podklady stejně důležité jako popis scény.\n\nDokumentovaný systém vytváří videa dlouhá 4–15 sekund při 24 snímcích za sekundu se stereofonním zvukem 32 kHz. Generování H3-Base pracuje v 768p; úplný postup 2K tento výsledek regeneruje s využitím původního multimodálního kontextu. Nejde jen o běžnou změnu velikosti: druhá fáze znovu používá model a zdrojový kontext k obnovení jemných detailů. H3 Max a H3-Context-IR mají samostatné role a limity.\n\nTvorba z textu a pomocí snímků\n\nČistě textový vstup popisuje celou audiovizuální časovou osu. První obrázek ukotvuje začátek, poslední konec a dva obrázky mohou určit obojí. U záběru z úvodního snímku vyjděte z kompozice a identity viditelných na obrázku a poté popište rozvíjející se děj. U přechodu od prvního k poslednímu snímku popište pozorovatelný pohyb spojující oba stavy místo opakování dvou nesouvisejících popisů obrázků.\n\nPraktické produktové zadání může určit zavřený obal v úvodním snímku, ruku, která jej otevře, jemný pohyb kamery a cílový konečný stav. V dodaných snímcích zachovejte tvar předmětu, umístění etikety a osvětlení. Tvorba vedená snímky a tvorba vedená referencemi jsou samostatné vstupní režimy; rozhraní výrobce nemíchá role prvního a posledního snímku s rolemi referenčních médií v jednom požadavku.\n\nGenerování a úpravy vedené referencemi\n\nReferenční režim přijímá text s obrázky, videoklipy a zvukovými klipy. Určete, čím každý zdroj přispívá: vzhledem postavy, místem, pohybem kamery, časovou strukturou zdrojového klipu nebo hlasem. Video používané jen pro pohyb kamery se liší od videa, které se má skutečně upravit či prodloužit. Tento vztah výslovně uveďte.\n\nReferenční příručka výrobce odděluje definice objektů, shrnutí úlohy, analýzu zachovávaných prvků, podrobný popis záběru, celkovou zvukovou atmosféru a hudební doprovod slyšitelný jen divákům. Rozlišuje zachování viditelného obsahu od přenosu vlastností či obecné stylové reference. U zvuku se kopírování signálu liší od odkazu na barvu hlasu, rytmus nebo přednes. Tyto role v celém zadání zachovejte stabilní.\n\nPro scénu vedenou referencemi dodejte obrázek postavy, krátkou referenci pohybu kamery a zvukovou referenci hlasu a poté popište, kde má každá ovlivnit cílový záběr. Uveďte, které detaily oděvu, prostředí nebo předmětu musí zůstat rozpoznatelné. Hotový klip porovnejte s těmito požadavky včetně kontinuity pohybu a vztahu mezi viditelným mluvčím a slyšeným hlasem.\n\nŘeč, zvuk a načasování záběru\n\nH3 společně modeluje dialog, fyzické zvuky, ruch prostředí a hudbu. Karta modelu dokumentuje stabilní podporu dialogu v arabštině, čínštině, angličtině, francouzštině, němčině, italštině, japonštině, korejštině, portugalštině, ruštině a španělštině; u ostatních jazyků popisuje proměnlivou podporu. Zadejte přesná mluvená slova a jazyk a zachovejte stabilní identitu mluvčího napříč záběry.\n\nPříručky výrobce pro psaní promptů používají v popisných částech angličtinu a dialog i viditelný text ponechávají v původním jazyce. Mluvený obsah používá `[Language] ...`, přičemž identita mluvčího a popis hlasu jsou mimo blok. Odlišujte řeč postavy ve scéně od komentáře mimo obraz a určete, kdy replika pokračuje přes střih nebo ji ukončí konec. Také viditelný text zachovejte přesně. Množství řeči přizpůsobte zvolené délce a společně zkontrolujte vykreslená slova i slyšitelnou repliku.\n\nPohyb kamery popište jako akci včetně rozsahu a rychlosti, pokud jsou důležité. Záběry číslujte v pořadí přehrávání a časy střihů udržujte v rámci délky videa. Zvuky scény, například kroky či zavření dveří, oddělte od doprovodné hudby slyšitelné pouze divákům. Tyto volby usnadňují interpretaci krátkého plánu záběrů i jeho porovnání s výsledkem.\n\nPříprava vstupů a číselné limity\n\nSoučasné schéma generování vyžaduje v každém režimu neprázdný text, nejvýše 7 000 znaků na textovou položku. Obrázky mohou být JPG, JPEG, PNG, WebP, HEIC nebo HEIF, každý do 30 MB, s každou stranou od 256 do 5 760 pixelů a poměrem stran od 0,4 do 2,5. Snímkový vstup dovoluje jeden úvodní a jeden závěrečný obrázek; referenční režim až devět referenčních obrázků.\n\nReferenční video může obsahovat až tři klipy MP4 nebo MOV, každý dlouhý 2–15 sekund a celkem nejvýše 15 sekund. Klip může mít do 50 MB; jeho kodek videa je H.264 nebo H.265, zvuk AAC nebo MP3, strany od 256 do 5 760 pixelů, poměry od 0,4 do 2,5 a snímková frekvence od 23,976 do 60. Referenční zvuk podporuje až tři klipy WAV nebo MP3, každý do 15 MB, každý dlouhý 2–15 sekund a celkem nejvýše 15 sekund. Karta modelu omezuje smíšené referenční vstupy na 12 souborů. Dokumentovaný limit těla požadavku je 64 MB a je odlišný od limitů jednotlivých souborů.\n\nVybírejte jen reference přispívající k zadání a přínos každé výslovně uveďte. Jasný pohled na objekt je užitečnější než několik rozporných pohledů bez vysvětlení. Zachovejte pořadí referencí, ořízněte nepodstatný materiál bez odstranění nutného kontextu scény a ověřte, že krátké zdrojové klipy obsahují požadovaný děj či hlasovou charakteristiku.\n\nFormát výstupu a úplný systém\n\nRozhraní H3 výrobce nabízí 768P a 2K. Generování pouze z textu vyžaduje konkrétní poměr: 21:9, 16:9, 4:3, 1:1, 3:4 nebo 9:16. Tvorba z prvního a posledního snímku přebírá poměr vstupního obrázku; tvorba z referencí může použít adaptivní nebo explicitní poměr. Celočíselná délka výstupu je 4–15 sekund.\n\nKarta modelu rozlišuje H3-Context-IR, který interpretuje a obohacuje zadání, H3-Base, který generuje audiovizuální obsah, a H3-Regenerate-2K, který vytváří výsledek s vyšším rozlišením. Vydané základní checkpointy oddělují úlohy vedené snímky a úlohy s omnimodálními referencemi. Kontextové a regenerační komponenty se liší od těchto základních vah, takže samotný název otevřeného checkpointu nedokládá chování celého systému.\n\nPostup generování výrobce je asynchronní. Rozhraní pro dotazování na úlohy vyhledává úlohy z předchozích sedmi dnů. Identitu úlohy uchovejte do vrácení skutečného výsledného videa a poté uložte klip místo samotné časově omezené adresy ke stažení. V zamýšleném měřítku zobrazení zkontrolujte vizuální identitu, drobný text, interakce předmětů, mluvený obsah a načasování zvuku. Výrobce označuje multimodální porozumění a jemné vizuální detaily za oblasti dalšího zlepšování; podrobné zadání a porovnání se zdrojem zůstávají klíčem k užitečnému 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": "Kompletní ceník konfigurace v podrobnostech." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "ffcc346d33bca9e66b22f181", "label": "Cenové reference konfigurací videa", "profiles": [ { "basis": "Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.", "dimensions": { "conditions": "V tomto cenovém klíči není uvedena žádná další podmínka." }, "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": "Prvních pět referenčních obrázků je zdarma; uvedená sazba za obrázek platí až po prvních pěti. Zveřejněná cenová reference pro zobrazenou konfiguraci. Konečné částky odpovídají skutečně účtované konfiguraci.", "dimensions": { "conditions": "V tomto cenovém klíči není uvedena žádná další podmínka." }, "label": "Referenční obrázky po prvních pěti", "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é sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.", "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": "Uchovejte každý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.", "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": "Přístup k videu není dostupný nebo toto ID videa nebylo nalezeno.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Zkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API.", "type": "not_found_error" }, { "condition": "Klíč API neodpovídá ověřenému účtu.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Před odesláním zkontrolujte svůj klíč API a přístup k účtu.", "type": "authentication_error" }, { "condition": "Požadavek se nepodařilo načíst nebo je index pro stažení neplatný.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Opravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou.", "type": "invalid_request_error" }, { "condition": "Vybranou konfiguraci videa nelze ocenit.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Před odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby.", "type": "price_unavailable" }, { "condition": "Vstup videa nebo původní úloha pro pokračování jsou neplatné.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Používejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API.", "type": "invalid_request_error" }, { "condition": "Dostupný zůstatek nebo limity neumožňují rezervaci.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Před odesláním nového požadavku zkontrolujte dostupný zůstatek a limity.", "type": "billing_error" }, { "condition": "Ověřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Počkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Původní výsledek videa a vyúčtovanou částku je třeba zkontrolovat.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Uchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Stávající video je dočasně nedostupné ke stažení.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Později zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci.", "type": "server_error" }, { "condition": "Obsah videa nebyl zveřejněn.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Zkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování.", "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žadavek nikdy neopakujte" }, "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": "Zadejte prompt jako text a duration v celých sekundách. Vyberte podporované rozlišení a případně poměr stran.", "required": [ "model", "prompt", "duration" ], "required_material": "Textové zadání." }, { "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ímku obsahuje type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použijte first_frame s volitelným last_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Pro každý snímek zadejte veřejnou HTTPS URL obrázku. V jednom požadavku používejte buď obrázky snímků, nebo obrazové reference; obojí nekombinujte. Vyberte podporované rozlišení a případně poměr stran.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Textové zadání a obrázek prvního snímku." }, { "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 objektů. Nastavte type na image_url, video_url nebo audio_url a použijte odpovídající pole obsahující url. Používejte veřejné HTTPS URL. Vynecháním frame_images zvolíte režim referencí. Odhad zahrnuje zobrazenou složku ceny za obrázek pouze u obrazových referencí po prvních pěti. Konečná částka odpovídá skutečně účtované konfiguraci. Nekombinujte obrazové reference s obrázky snímků. Vyberte podporované rozlišení a případně poměr stran.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Textové zadání a podporované obrazové, video a zvukové reference." } ], "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": "Pozice tohoto videa v seznamu výstupů, čí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": "Podepsaná HTTPS URL pro stažení tohoto 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": "Otisk SHA-256 původních bajtů videa; null, není-li 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": "Velikost původního videosouboru v bajtech; null, není-li 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": "Naměřená délka videa v milisekundách; null, není-li 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": "Šířka videa v pixelech; null, není-li 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 pixelech; null, není-li 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, není-li zaznamenán.", "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": "Zda video obsahuje zvukovou stopu; null, nebylo-li změřeno.", "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, není-li žádný identifikátor zaznamenán.", "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": "podepsané URL obsahu spravovaného službou", "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": "Tyto klíče popisují každý objekt snímku; image_url obsahuje pouze url. Pro požadavek obsahující pouze text vynechte frame_images.", "content": "Pole objektů snímků. Každý objekt obsahuje type=image_url, image_url obsahující url a frame_type. Použijte HTTPS URL obrázku a nastavte frame_type na first_frame nebo last_frame. Každá role snímku se smí vyskytnout nejvýše jednou.", "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 není dodatečným poplatkem ani pevnou sazbou za dokončené generování.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Odhadovaná cena generování", "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átká videa s nativním stereofonním zvukem z textu, snímků nebo multimodálních referencí. Podporuje tvorbu z prvního či posledního snímku, úpravy vedené referencemi a vztahy pohybu či hlasu, s výstupem 4–15 sekund a samostatným postupem regenerování do 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átká videa s nativním stereofonním zvukem z textu, snímků nebo multimodálních referencí. Podporuje tvorbu z prvního či posledního snímku, úpravy vedené referencemi a vztahy pohybu či hlasu, s výstupem 4–15 sekund a samostatným postupem regenerování do 2K.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "45e8575920264ea144180280ae1150f776b25fe2ec565a9e2f14e741bb4d950c", "renderer_sha256": "41721c81890b87836cd3fd41ef732d3276f5969e30822ba09962305294953718" }, "sourceRevision": "b8b7dc22e2ce7fc97d5707c96c70bdf2c547a7b62f9d06a8119c601408f3bb15" }