MiniMax Hailuo 2.3 je model pro generování videa s režimy tvorby z textu a z obrázku. Navazuje na Hailuo 02 se zaměřením na fyzický děj, vizuální styl, mikroexpresi postav a reakce na pokyny k pohybu. Dodejte písemný popis scény a vytvořte záběr od začátku, nebo pomocí úvodního obrázku určete počáteční pohled a popište následující pohyb.
Fyzický výkon je jednou z hlavních oblastí zlepšení této edice. Hailuo 2.3 usiluje o plynulejší a kontrolovanější pohyby těla včetně scén s pohybující se kamerou. Důležitý děj naplánujte před přidáním ozdobných detailů. Postava zvedající předmět, otáčející se k jiné osobě či procházející místností dává záběru viditelnou událost k posouzení. Určete, který pohyb nese příběh, a okolní pokyny s ním udržujte v souladu.
Dalším zaměřením je stylizace. Model podporuje práci v anime a ilustraci i ve stylech tušové malby či herní CG. Popište požadované vizuální zpracování a zachovejte vzhled v souladu se scénou. Pokud úvodní obrázek již určuje výtvarný styl, textem veďte animaci místo zavádění konkurenčního popisu designu postavy. V celém klipu zkontrolujte, zda toto zpracování zůstává při pohybu čitelné.
Model se zaměřuje také na výraz obličeje a jeho jemné změny. Záběr postavy připravte kolem důležité reakce: povšimnutí předmětu, probuzení zvědavosti nebo drobného úsměvu. Blízký pohled usnadní její posouzení, zatímco rozsáhlá sekvence gest může odvádět pozornost. Obličej zkontrolujte před reakcí, během ní i po ní místo hodnocení jediného reprezentativního snímku.
Pohyb předmětů je užitečný pro scény soustředěné na produkt. Vlastní zadání může ukazovat malou keramickou vázu otáčející se v teplém bočním světle, zatímco se k ní kamera postupně přibližuje. Určete vlastnosti, které musí zůstat rozpoznatelné, například siluetu, okraj a povrchovou úpravu. Během pohybu tyto detaily kontrolujte, protože samotná přesvědčivá atmosféra nedokládá věrné zobrazení produktu.
Pro tvorbu videa z textu může povinný popis obsahovat až 2 000 znaků. V souvislém pořadí uveďte objekt, děj, prostředí a vizuální styl. Tvorba z obrázku vyžaduje obrázek úvodního snímku s volitelným popisem do 2 000 znaků. Obrázek určuje úvodní kompozici, proto objekt a rámování připravte před žádostí o pohyb. Ponechte viditelný prostor tam, kde se má pohybovat paže, předmět nebo postava.
Úvodní obrázek může být JPG, JPEG, PNG nebo WebP, musí mít méně než 20 MB, kratší stranu větší než 300 pixelů a poměr stran mezi 2:5 a 5:2. Lze jej dodat jako veřejnou adresu URL obrázku nebo datovou URL Base64. Zvolte jasný úvodní obrázek a nespoléhejte, že animace opraví zakrytý obličej či již oříznutý děj.
Hailuo 2.3 generuje při 24 snímcích za sekundu. Šestisekundový záběr může použít 768P nebo 1080P; desetisekundový používá 768P. Výchozí volby jsou šest sekund a 768P. Délku zvolte podle požadovaného děje: krátká reakce se může vejít do krátkého záběru, pomalejší pohyb potřebuje více prostoru. Při vkládání klipu do střihu přečtěte skutečnou šířku a výšku hotového výsledku, protože samotný údaj o rozlišení neurčuje celé rámování.
Směr kamery lze určit příkazy v hranatých závorkách. Dostupné ovládání zahrnuje boční jízdu, panorámování, nájezd, svislý posun, naklápění, zoom, chvění, sledování a statický záběr. Příkaz jako [Push in] řídí přiblížení; příkazy seskupené v jedněch závorkách působí společně, zatímco postupně uvedené příkazy popisují sekvenci. MiniMax doporučuje nejvýše tři současné příkazy. Pohyb kamery slaďte s dějem objektu, aby hlavní událost zůstala snadno sledovatelná.
Automatická optimalizace promptu je ve výchozím stavu zapnutá a lze ji vypnout pro přesnější kontrolu nad dodaným zněním. Volitelné rychlé předzpracování zkracuje dobu optimalizace, pokud je optimalizace zapnutá; jde o nastavení oddělené od volby modelu Hailuo 2.3 Fast. Standardní Hailuo 2.3 podporuje oba režimy tvorby, zatímco Fast je samostatnou edicí pro tvorbu videa z obrázku. Edici vyberte podle toho, zda projekt začíná samotným textem, nebo existujícím snímkem.
Postup generování vrací asynchronní identifikátor úlohy a poté hlásí přípravu, zařazení do fronty, zpracování, úspěch či selhání. Při úspěchu výsledek obsahuje identifikátor souboru a skutečné rozměry videa a hotové video se načte ke stažení. Klip uložte během platnosti adresy ke stažení. Současná dokumentace výrobce ke stahování videa uvádí pro vrácenou URL platnost jednu hodinu. Pro sestříhanou sekvenci ponechte každý záběr s promptem a úvodním obrázkem, aby se zvolený tvůrčí směr dal při úpravách dohledat.
V uloženém klipu zkontrolujte děj, fyzickou kontinuitu, detaily obličeje či produktu, vizuální styl a chování kamery. Zhlédněte celý záběr a potom prohlédněte začátek a konec, kde se má spojovat s dalším materiálem. Pokud požadavek obsahuje příliš mnoho soupeřících pohybů, zjednodušte hlavní děj; pokud je úvodní design nejasný, zlepšete úvodní obrázek. Vyberte záběr sdělující zamýšlenou událost a poté ve střihovém postupu přidejte komentář, titulky a přechody.
", "aboutText": "MiniMax Hailuo 2.3 je model pro generování videa s režimy tvorby z textu a z obrázku. Navazuje na Hailuo 02 se zaměřením na fyzický děj, vizuální styl, mikroexpresi postav a reakce na pokyny k pohybu. Dodejte písemný popis scény a vytvořte záběr od začátku, nebo pomocí úvodního obrázku určete počáteční pohled a popište následující pohyb.\n\nFyzický výkon je jednou z hlavních oblastí zlepšení této edice. Hailuo 2.3 usiluje o plynulejší a kontrolovanější pohyby těla včetně scén s pohybující se kamerou. Důležitý děj naplánujte před přidáním ozdobných detailů. Postava zvedající předmět, otáčející se k jiné osobě či procházející místností dává záběru viditelnou událost k posouzení. Určete, který pohyb nese příběh, a okolní pokyny s ním udržujte v souladu.\n\nDalším zaměřením je stylizace. Model podporuje práci v anime a ilustraci i ve stylech tušové malby či herní CG. Popište požadované vizuální zpracování a zachovejte vzhled v souladu se scénou. Pokud úvodní obrázek již určuje výtvarný styl, textem veďte animaci místo zavádění konkurenčního popisu designu postavy. V celém klipu zkontrolujte, zda toto zpracování zůstává při pohybu čitelné.\n\nModel se zaměřuje také na výraz obličeje a jeho jemné změny. Záběr postavy připravte kolem důležité reakce: povšimnutí předmětu, probuzení zvědavosti nebo drobného úsměvu. Blízký pohled usnadní její posouzení, zatímco rozsáhlá sekvence gest může odvádět pozornost. Obličej zkontrolujte před reakcí, během ní i po ní místo hodnocení jediného reprezentativního snímku.\n\nPohyb předmětů je užitečný pro scény soustředěné na produkt. Vlastní zadání může ukazovat malou keramickou vázu otáčející se v teplém bočním světle, zatímco se k ní kamera postupně přibližuje. Určete vlastnosti, které musí zůstat rozpoznatelné, například siluetu, okraj a povrchovou úpravu. Během pohybu tyto detaily kontrolujte, protože samotná přesvědčivá atmosféra nedokládá věrné zobrazení produktu.\n\nPro tvorbu videa z textu může povinný popis obsahovat až 2 000 znaků. V souvislém pořadí uveďte objekt, děj, prostředí a vizuální styl. Tvorba z obrázku vyžaduje obrázek úvodního snímku s volitelným popisem do 2 000 znaků. Obrázek určuje úvodní kompozici, proto objekt a rámování připravte před žádostí o pohyb. Ponechte viditelný prostor tam, kde se má pohybovat paže, předmět nebo postava.\n\nÚvodní obrázek může být JPG, JPEG, PNG nebo WebP, musí mít méně než 20 MB, kratší stranu větší než 300 pixelů a poměr stran mezi 2:5 a 5:2. Lze jej dodat jako veřejnou adresu URL obrázku nebo datovou URL Base64. Zvolte jasný úvodní obrázek a nespoléhejte, že animace opraví zakrytý obličej či již oříznutý děj.\n\nHailuo 2.3 generuje při 24 snímcích za sekundu. Šestisekundový záběr může použít 768P nebo 1080P; desetisekundový používá 768P. Výchozí volby jsou šest sekund a 768P. Délku zvolte podle požadovaného děje: krátká reakce se může vejít do krátkého záběru, pomalejší pohyb potřebuje více prostoru. Při vkládání klipu do střihu přečtěte skutečnou šířku a výšku hotového výsledku, protože samotný údaj o rozlišení neurčuje celé rámování.\n\nSměr kamery lze určit příkazy v hranatých závorkách. Dostupné ovládání zahrnuje boční jízdu, panorámování, nájezd, svislý posun, naklápění, zoom, chvění, sledování a statický záběr. Příkaz jako [Push in] řídí přiblížení; příkazy seskupené v jedněch závorkách působí společně, zatímco postupně uvedené příkazy popisují sekvenci. MiniMax doporučuje nejvýše tři současné příkazy. Pohyb kamery slaďte s dějem objektu, aby hlavní událost zůstala snadno sledovatelná.\n\nAutomatická optimalizace promptu je ve výchozím stavu zapnutá a lze ji vypnout pro přesnější kontrolu nad dodaným zněním. Volitelné rychlé předzpracování zkracuje dobu optimalizace, pokud je optimalizace zapnutá; jde o nastavení oddělené od volby modelu Hailuo 2.3 Fast. Standardní Hailuo 2.3 podporuje oba režimy tvorby, zatímco Fast je samostatnou edicí pro tvorbu videa z obrázku. Edici vyberte podle toho, zda projekt začíná samotným textem, nebo existujícím snímkem.\n\nPostup generování vrací asynchronní identifikátor úlohy a poté hlásí přípravu, zařazení do fronty, zpracování, úspěch či selhání. Při úspěchu výsledek obsahuje identifikátor souboru a skutečné rozměry videa a hotové video se načte ke stažení. Klip uložte během platnosti adresy ke stažení. Současná dokumentace výrobce ke stahování videa uvádí pro vrácenou URL platnost jednu hodinu. Pro sestříhanou sekvenci ponechte každý záběr s promptem a úvodním obrázkem, aby se zvolený tvůrčí směr dal při úpravách dohledat.\n\nV uloženém klipu zkontrolujte děj, fyzickou kontinuitu, detaily obličeje či produktu, vizuální styl a chování kamery. Zhlédněte celý záběr a potom prohlédněte začátek a konec, kde se má spojovat s dalším materiálem. Pokud požadavek obsahuje příliš mnoho soupeřících pohybů, zjednodušte hlavní děj; pokud je úvodní design nejasný, zlepšete úvodní obrázek. Vyberte záběr sdělující zamýšlenou událost a poté ve střihovém postupu přidejte komentář, titulky a přechody.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "74c0aec6e59443e11e148d51c157579efa896aebf2451848943d14ad173f4bbb", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "cs", "methods": [ { "html": "MiniMax-Hailuo-2.3MiniMax Hailuo 2.3 vytváří videa z textu nebo úvodního obrázku s ovládáním pohybu a směru kamery. Zvolte šest sekund v 768P či 1080P nebo deset sekund v 768P pro herecké výkony postav, stylizované scény a produktové záběry, které lze kontrolovat a stříhat.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
MiniMax Hailuo 2.3 je model pro generování videa s režimy tvorby z textu a z obrázku. Navazuje na Hailuo 02 se zaměřením na fyzický děj, vizuální styl, mikroexpresi postav a reakce na pokyny k pohybu. Dodejte písemný popis scény a vytvořte záběr od začátku, nebo pomocí úvodního obrázku určete počáteční pohled a popište následující pohyb.
Fyzický výkon je jednou z hlavních oblastí zlepšení této edice. Hailuo 2.3 usiluje o plynulejší a kontrolovanější pohyby těla včetně scén s pohybující se kamerou. Důležitý děj naplánujte před přidáním ozdobných detailů. Postava zvedající předmět, otáčející se k jiné osobě či procházející místností dává záběru viditelnou událost k posouzení. Určete, který pohyb nese příběh, a okolní pokyny s ním udržujte v souladu.
Dalším zaměřením je stylizace. Model podporuje práci v anime a ilustraci i ve stylech tušové malby či herní CG. Popište požadované vizuální zpracování a zachovejte vzhled v souladu se scénou. Pokud úvodní obrázek již určuje výtvarný styl, textem veďte animaci místo zavádění konkurenčního popisu designu postavy. V celém klipu zkontrolujte, zda toto zpracování zůstává při pohybu čitelné.
Model se zaměřuje také na výraz obličeje a jeho jemné změny. Záběr postavy připravte kolem důležité reakce: povšimnutí předmětu, probuzení zvědavosti nebo drobného úsměvu. Blízký pohled usnadní její posouzení, zatímco rozsáhlá sekvence gest může odvádět pozornost. Obličej zkontrolujte před reakcí, během ní i po ní místo hodnocení jediného reprezentativního snímku.
Pohyb předmětů je užitečný pro scény soustředěné na produkt. Vlastní zadání může ukazovat malou keramickou vázu otáčející se v teplém bočním světle, zatímco se k ní kamera postupně přibližuje. Určete vlastnosti, které musí zůstat rozpoznatelné, například siluetu, okraj a povrchovou úpravu. Během pohybu tyto detaily kontrolujte, protože samotná přesvědčivá atmosféra nedokládá věrné zobrazení produktu.
Pro tvorbu videa z textu může povinný popis obsahovat až 2 000 znaků. V souvislém pořadí uveďte objekt, děj, prostředí a vizuální styl. Tvorba z obrázku vyžaduje obrázek úvodního snímku s volitelným popisem do 2 000 znaků. Obrázek určuje úvodní kompozici, proto objekt a rámování připravte před žádostí o pohyb. Ponechte viditelný prostor tam, kde se má pohybovat paže, předmět nebo postava.
Úvodní obrázek může být JPG, JPEG, PNG nebo WebP, musí mít méně než 20 MB, kratší stranu větší než 300 pixelů a poměr stran mezi 2:5 a 5:2. Lze jej dodat jako veřejnou adresu URL obrázku nebo datovou URL Base64. Zvolte jasný úvodní obrázek a nespoléhejte, že animace opraví zakrytý obličej či již oříznutý děj.
Hailuo 2.3 generuje při 24 snímcích za sekundu. Šestisekundový záběr může použít 768P nebo 1080P; desetisekundový používá 768P. Výchozí volby jsou šest sekund a 768P. Délku zvolte podle požadovaného děje: krátká reakce se může vejít do krátkého záběru, pomalejší pohyb potřebuje více prostoru. Při vkládání klipu do střihu přečtěte skutečnou šířku a výšku hotového výsledku, protože samotný údaj o rozlišení neurčuje celé rámování.
Směr kamery lze určit příkazy v hranatých závorkách. Dostupné ovládání zahrnuje boční jízdu, panorámování, nájezd, svislý posun, naklápění, zoom, chvění, sledování a statický záběr. Příkaz jako [Push in] řídí přiblížení; příkazy seskupené v jedněch závorkách působí společně, zatímco postupně uvedené příkazy popisují sekvenci. MiniMax doporučuje nejvýše tři současné příkazy. Pohyb kamery slaďte s dějem objektu, aby hlavní událost zůstala snadno sledovatelná.
Automatická optimalizace promptu je ve výchozím stavu zapnutá a lze ji vypnout pro přesnější kontrolu nad dodaným zněním. Volitelné rychlé předzpracování zkracuje dobu optimalizace, pokud je optimalizace zapnutá; jde o nastavení oddělené od volby modelu Hailuo 2.3 Fast. Standardní Hailuo 2.3 podporuje oba režimy tvorby, zatímco Fast je samostatnou edicí pro tvorbu videa z obrázku. Edici vyberte podle toho, zda projekt začíná samotným textem, nebo existujícím snímkem.
Postup generování vrací asynchronní identifikátor úlohy a poté hlásí přípravu, zařazení do fronty, zpracování, úspěch či selhání. Při úspěchu výsledek obsahuje identifikátor souboru a skutečné rozměry videa a hotové video se načte ke stažení. Klip uložte během platnosti adresy ke stažení. Současná dokumentace výrobce ke stahování videa uvádí pro vrácenou URL platnost jednu hodinu. Pro sestříhanou sekvenci ponechte každý záběr s promptem a úvodním obrázkem, aby se zvolený tvůrčí směr dal při úpravách dohledat.
V uloženém klipu zkontrolujte děj, fyzickou kontinuitu, detaily obličeje či produktu, vizuální styl a chování kamery. Zhlédněte celý záběr a potom prohlédněte začátek a konec, kde se má spojovat s dalším materiálem. Pokud požadavek obsahuje příliš mnoho soupeřících pohybů, zjednodušte hlavní děj; pokud je úvodní design nejasný, zlepšete úvodní obrázek. Vyberte záběr sdělující zamýšlenou událost a poté ve střihovém postupu přidejte komentář, titulky a přechody.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity MiniMax-Hailuo-2.3 | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Minimální délka: 1 Maximální délka: 2 000 Jednotka: znaky Unicode | Výchozí— |
Poleduration | Typinteger | PožadavekVolitelné | Hodnoty a limity 6, 10 Podmínky: 10 sekund vyžaduje 768P Jednotka: sekundy | Výchozí6 |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 768P, 1080P Podmínky: 1080P vyžaduje 6 sekund | Výchozí768P |
Polefirst_frame_image | Typhttps_url|data_image_url | PožadavekVolitelné | Hodnoty a limity Maximální počet dekódovaných bajtů: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp Minimální rozměr (bez krajní hodnoty): 300 Rozsah poměrů stran: 2:5, 5:2 | Výchozí— |
Poleprompt_optimizer | Typboolean | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polefast_pretreatment | Typboolean | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Obrázek na video · Povinné: prompt, first_frame_image
Text na video · Povinné: prompt
| Parametr | Kontrakt |
|---|---|
Parametrmaterial_types | Kontrakttext, image |
Parametrrequired | Kontraktnull |
Parametroptional_controls | Kontraktnull |
Životní cyklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Struktury metod a ID jsou přesné; schopnosti dodavatele jsou oddělené od připuštění požadavku.
POST /v1/videos/generationsAiloot 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í →
Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceMiniMax-Hailuo-2.3 · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstup 0,00 US$ za volání Výstup · Výstup 0,60 US$ za volání |
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceMiniMax-Hailuo-2.3 · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstup 0,00 US$ za volání Výstup · Výstup 1,20 US$ za volání |
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceMiniMax-Hailuo-2.3 · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstup 0,00 US$ za volání Výstup · Výstup 1,20 US$ za volání |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" \\\n -H "Content-Type: application/json" \\\n -d '{"model": "MiniMax-Hailuo-2.3", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side.", "duration": 6, "resolution": "768P"}'mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1\ncurl "https://api.ailoot.ai/v1/videos/generations/$video_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY"set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1\ncurl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" \\\n --output video.mp4Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Zachovejte každou vrácenou datovou položku a index výstupu. content_url označuje pouze první; načtěte každou skutečnou cestu obsahu či soubor. GET obsahu bez indexu nepředstavuje všechny výstupy.
Načítejte existující původní úlohu; odeslání s neznámým výsledkem nikdy neopakujte.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleobject | Typstring |
Polemodel | Typstring |
Polestatus | Typstring |
Polecontent_url | Typsigned URL |
Poledata[] | Typsigned URL |
Poleusage | Typobject |
Poleresult_pending_check | Typboolean |
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru | Další krokPřed novým požadavkem na vytvoření opravte uvedená pole. |
Odpověď409 · video_not_ready | PodmínkaObsah původního výsledku zatím není dostupný | Další krokDotazujte se na původní vrácené ID a dodržujte Retry-After. |
Odpověďserver_error | PodmínkaVrácená odpověď uvádí, že operaci nebo výsledek je třeba zkontrolovat | Další krokUchovejte původní vrácené ID operace nebo úlohy, hlavičky požadavku a odpověď; pokračujte v podporovaném načítání údajů o této původní operaci. Požadavek na vytvoření znovu neodesílejte. |
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
/v1/videos/generations, /videos, /videos/generations
MiniMax-Hailuo-2.3MiniMax Hailuo 2.3 vytváří videa z textu nebo úvodního obrázku s ovládáním pohybu a směru kamery. Zvolte šest sekund v 768P či 1080P nebo deset sekund v 768P pro herecké výkony postav, stylizované scény a produktové záběry, které lze kontrolovat a stříhat.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
MiniMax Hailuo 2.3 je model pro generování videa s režimy tvorby z textu a z obrázku. Navazuje na Hailuo 02 se zaměřením na fyzický děj, vizuální styl, mikroexpresi postav a reakce na pokyny k pohybu. Dodejte písemný popis scény a vytvořte záběr od začátku, nebo pomocí úvodního obrázku určete počáteční pohled a popište následující pohyb.
Fyzický výkon je jednou z hlavních oblastí zlepšení této edice. Hailuo 2.3 usiluje o plynulejší a kontrolovanější pohyby těla včetně scén s pohybující se kamerou. Důležitý děj naplánujte před přidáním ozdobných detailů. Postava zvedající předmět, otáčející se k jiné osobě či procházející místností dává záběru viditelnou událost k posouzení. Určete, který pohyb nese příběh, a okolní pokyny s ním udržujte v souladu.
Dalším zaměřením je stylizace. Model podporuje práci v anime a ilustraci i ve stylech tušové malby či herní CG. Popište požadované vizuální zpracování a zachovejte vzhled v souladu se scénou. Pokud úvodní obrázek již určuje výtvarný styl, textem veďte animaci místo zavádění konkurenčního popisu designu postavy. V celém klipu zkontrolujte, zda toto zpracování zůstává při pohybu čitelné.
Model se zaměřuje také na výraz obličeje a jeho jemné změny. Záběr postavy připravte kolem důležité reakce: povšimnutí předmětu, probuzení zvědavosti nebo drobného úsměvu. Blízký pohled usnadní její posouzení, zatímco rozsáhlá sekvence gest může odvádět pozornost. Obličej zkontrolujte před reakcí, během ní i po ní místo hodnocení jediného reprezentativního snímku.
Pohyb předmětů je užitečný pro scény soustředěné na produkt. Vlastní zadání může ukazovat malou keramickou vázu otáčející se v teplém bočním světle, zatímco se k ní kamera postupně přibližuje. Určete vlastnosti, které musí zůstat rozpoznatelné, například siluetu, okraj a povrchovou úpravu. Během pohybu tyto detaily kontrolujte, protože samotná přesvědčivá atmosféra nedokládá věrné zobrazení produktu.
Pro tvorbu videa z textu může povinný popis obsahovat až 2 000 znaků. V souvislém pořadí uveďte objekt, děj, prostředí a vizuální styl. Tvorba z obrázku vyžaduje obrázek úvodního snímku s volitelným popisem do 2 000 znaků. Obrázek určuje úvodní kompozici, proto objekt a rámování připravte před žádostí o pohyb. Ponechte viditelný prostor tam, kde se má pohybovat paže, předmět nebo postava.
Úvodní obrázek může být JPG, JPEG, PNG nebo WebP, musí mít méně než 20 MB, kratší stranu větší než 300 pixelů a poměr stran mezi 2:5 a 5:2. Lze jej dodat jako veřejnou adresu URL obrázku nebo datovou URL Base64. Zvolte jasný úvodní obrázek a nespoléhejte, že animace opraví zakrytý obličej či již oříznutý děj.
Hailuo 2.3 generuje při 24 snímcích za sekundu. Šestisekundový záběr může použít 768P nebo 1080P; desetisekundový používá 768P. Výchozí volby jsou šest sekund a 768P. Délku zvolte podle požadovaného děje: krátká reakce se může vejít do krátkého záběru, pomalejší pohyb potřebuje více prostoru. Při vkládání klipu do střihu přečtěte skutečnou šířku a výšku hotového výsledku, protože samotný údaj o rozlišení neurčuje celé rámování.
Směr kamery lze určit příkazy v hranatých závorkách. Dostupné ovládání zahrnuje boční jízdu, panorámování, nájezd, svislý posun, naklápění, zoom, chvění, sledování a statický záběr. Příkaz jako [Push in] řídí přiblížení; příkazy seskupené v jedněch závorkách působí společně, zatímco postupně uvedené příkazy popisují sekvenci. MiniMax doporučuje nejvýše tři současné příkazy. Pohyb kamery slaďte s dějem objektu, aby hlavní událost zůstala snadno sledovatelná.
Automatická optimalizace promptu je ve výchozím stavu zapnutá a lze ji vypnout pro přesnější kontrolu nad dodaným zněním. Volitelné rychlé předzpracování zkracuje dobu optimalizace, pokud je optimalizace zapnutá; jde o nastavení oddělené od volby modelu Hailuo 2.3 Fast. Standardní Hailuo 2.3 podporuje oba režimy tvorby, zatímco Fast je samostatnou edicí pro tvorbu videa z obrázku. Edici vyberte podle toho, zda projekt začíná samotným textem, nebo existujícím snímkem.
Postup generování vrací asynchronní identifikátor úlohy a poté hlásí přípravu, zařazení do fronty, zpracování, úspěch či selhání. Při úspěchu výsledek obsahuje identifikátor souboru a skutečné rozměry videa a hotové video se načte ke stažení. Klip uložte během platnosti adresy ke stažení. Současná dokumentace výrobce ke stahování videa uvádí pro vrácenou URL platnost jednu hodinu. Pro sestříhanou sekvenci ponechte každý záběr s promptem a úvodním obrázkem, aby se zvolený tvůrčí směr dal při úpravách dohledat.
V uloženém klipu zkontrolujte děj, fyzickou kontinuitu, detaily obličeje či produktu, vizuální styl a chování kamery. Zhlédněte celý záběr a potom prohlédněte začátek a konec, kde se má spojovat s dalším materiálem. Pokud požadavek obsahuje příliš mnoho soupeřících pohybů, zjednodušte hlavní děj; pokud je úvodní design nejasný, zlepšete úvodní obrázek. Vyberte záběr sdělující zamýšlenou událost a poté ve střihovém postupu přidejte komentář, titulky a přechody.
POST /v1/videostextvideo| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity MiniMax-Hailuo-2.3 | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Minimální délka: 1 Maximální délka: 2 000 Podmínky: Pro 768P: nejvýše 2000 kódových bodů Unicode. Pro 1080P: méně než 200 kódových bodů Unicode (maximum 199). Zadání musí obsahovat text tvořený i jinými znaky než bílými. Jednotka: znaky Unicode | Výchozí— |
Poleduration | Typinteger | PožadavekPovinné | Hodnoty a limity 6 Jednotka: sekundy | Výchozí— |
Poleresolution | Typstring | PožadavekPovinné | Hodnoty a limity 768P, 1080P | Výchozí— |
Text na video · Povinné: prompt
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, duration, resolution |
Parametrother_options | Kontraktfalse |
Parametrduration | Kontrakt6 |
Parametrresolution | Kontrakt768P, 1080P |
Parametrprompt_max_characters | Kontrakt2000 |
Parametrmaterial_types | Kontrakttext |
Parametrprompt_max_characters_by_resolution | Kontrakt{"768P":2000,"1080P":199} |
Aliasy metody: /v1/videos/generations, /videos, /videos/generations
Životní cyklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Vytvořte pouze jednou a uložte vrácené ID.
Dotazujte se na původní stav; uchovejte každý dokončený soubor i jeho délku.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Nominální délka klipu, sekundy | Rozlišení | Účtovací jednotka | Poplatek |
|---|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Nominální délka klipu, sekundy— | Rozlišení— | Účtovací jednotka— | Poplatek Vstup · Vstupní tokeny — / 1K tokenů Výstup · Výstupní tokeny — / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
| KonfiguraceUltra | Tabulka sazeb— | Nominální délka klipu, sekundy6 | Rozlišení1080P | Účtovací jednotkaza výstupní klip o nominální délce 6s | Poplatek Výstup · výstupní klip s nominální délkou 6s $1.2 za výstupní klip o nominální délce 6s |
| KonfiguraceUltra | Tabulka sazeb— | Nominální délka klipu, sekundy6 | Rozlišení768P | Účtovací jednotkaza výstupní klip o nominální délce 6s | Poplatek Výstup · výstupní klip s nominální délkou 6s $0.6 za výstupní klip o nominální délce 6s |
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í →
Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceMiniMax-Hailuo-2.3 · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstup 0,00 US$ za volání Výstup · Výstup 0,60 US$ za volání |
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceMiniMax-Hailuo-2.3 · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstup 0,00 US$ za volání Výstup · Výstup 1,20 US$ za volání |
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceMiniMax-Hailuo-2.3 · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstup 0,00 US$ za volání Výstup · Výstup 1,20 US$ za volání |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\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\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\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\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n 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 Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nUložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Pole data[] po dokončení obsahuje všechny podepsané URL obsahu spravovaného službou. Načtěte každou vrácenou URL nebo použijte koncový bod obsahu s parametrem index nastaveným na skutečný index výstupu. Neúspěšná původní úloha může vrátit charge_pending_check; kontrolujte tuto původní úlohu místo jejího opětovného vytváření.
Načítejte existující původní úlohu; odeslání s neznámým výsledkem nikdy neopakujte.
Maximální počet výstupů: 1.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleobject | Typstring |
Polemodel | Typstring |
Polestatus | Typstring |
Poledata[] | Typsigned content URL |
Polecharge_pending_check | Typboolean |
Poleerror.code | Typstring |
Poleerror.message | Typstring |
Polerequested_nominal_duration_seconds | Typinteger |
Polemeasured_duration_seconds | Typnumber |
Polewidth | Typinteger |
Poleheight | Typinteger |
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru | Další krokPřed novým požadavkem na vytvoření opravte uvedená pole. |
Odpověď409 · video_not_ready | PodmínkaObsah původního výsledku zatím není dostupný | Další krokDotazujte se na původní vrácené ID a dodržujte Retry-After. |
Odpověďserver_error | PodmínkaVrácená odpověď uvádí, že operaci nebo výsledek je třeba zkontrolovat | Další krokUchovejte původní vrácené ID operace nebo úlohy, hlavičky požadavku a odpověď; pokračujte v podporovaném načítání údajů o této původní operaci. Požadavek na vytvoření znovu neodesílejte. |
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
/v1/videos/generations, /videos, /videos/generations