MiniMax Hailuo 2.3 je model na generovanie videa s režimami text-to-video a image-to-video. Nadväzuje na Hailuo 02 so zameraním na fyzickú akciu, vizuálny štýl, mikroexpresie postáv a reakciu na pohybové pokyny. Dodajte písanú scénu na vytvorenie záberu od začiatku alebo použite úvodný obrázok na určenie počiatočného pohľadu a opíšte nasledujúci pohyb.
Fyzický výkon je jednou z hlavných oblastí zlepšenia tejto edície. Hailuo 2.3 sa snaží dosiahnuť plynulejšie a kontrolovanejšie pohyby tela vrátane scén s pohybujúcou sa kamerou. Dôležitú akciu naplánujte pred pridávaním dekoratívnych detailov. Postava zdvíhajúca predmet, otáčajúca sa k inej osobe alebo prechádzajúca miestnosťou dáva záberu viditeľnú udalosť na vyhodnotenie. Rozhodnite, ktorý pohyb nesie príbeh, a ostatné pokyny s ním udržte v súlade.
Ďalším zameraním je štylizácia. Model podporuje prácu v anime a ilustrácii aj v štýloch ako tušová maľba a herné CG. Opíšte požadované vizuálne spracovanie a udržte vzhľad v súlade so scénou. Ak úvodný obrázok už určuje kresliarsky štýl, text použite na usmernenie animácie namiesto zavádzania konkurenčného opisu dizajnu postavy. V celom klipe overte, či toto spracovanie zostáva čitateľné počas pohybu.
Model sa tiež zameriava na tvárový prejav a jemné zmeny výrazu. Záber postavy pripravte okolo dôležitej reakcie: všimnutia si predmetu, prebudenia zvedavosti alebo jemného úsmevu. Detailný záber môže uľahčiť posúdenie tejto zmeny, zatiaľ čo rozsiahla sekvencia gest od nej môže odvádzať pozornosť. Kontrolujte tvár pred reakciou, počas nej aj po nej namiesto hodnotenia iba reprezentatívnej statickej snímky.
Pohyb predmetov je užitočný pre scény sústredené na produkt. Pôvodné zadanie môže zobrazovať malú keramickú vázu otáčajúcu sa v teplom bočnom svetle, zatiaľ čo sa k nej kamera postupne približuje. Určte vlastnosti, ktoré musia zostať rozpoznateľné, napríklad siluetu, okraj a povrchovú úpravu. Tieto detaily kontrolujte počas pohybu, pretože samotná presvedčivá atmosféra nepotvrdzuje verný pohľad na produkt.
Pri text-to-video môže povinný opis obsahovať najviac 2 000 znakov. Subjekt, akciu, prostredie a vizuálny štýl uveďte v súvislom poradí. Image-to-video vyžaduje obrázok úvodnej snímky s voliteľným opisom najviac 2 000 znakov. Obrázok určuje úvodnú kompozíciu, preto pred požiadavkou na pohyb pripravte subjekt a rámovanie. Nechajte viditeľný priestor tam, kde sa má pohybovať ruka, predmet alebo postava.
Úvodný obrázok môže byť JPG, JPEG, PNG alebo WebP, musí byť menší než 20 MB, mať kratší okraj väčší než 300 pixelov a pomer strán od 2:5 do 5:2. Možno ho dodať ako verejnú URL obrázka alebo dátovú URL Base64. Zvoľte jasný úvodný obrázok namiesto spoliehania sa, že animácia opraví zakrytú tvár alebo už orezanú akciu.
Hailuo 2.3 generuje pri 24 snímkach za sekundu. Šesťsekundový záber môže použiť 768P alebo 1080P; desaťsekundový používa 768P. Predvolené nastavenia sú šesť sekúnd a 768P. Dĺžku zvoľte podľa požadovanej akcie: krátka reakcia sa môže zmestiť do krátkeho záberu, pomalší pohyb potrebuje viac priestoru. Pri vkladaní klipu do strihu prečítajte skutočnú šírku a výšku dokončeného výsledku, pretože označenie rozlíšenia samo nevyjadruje celé rozhodnutie o kompozícii.
Smerovanie kamery môže používať príkazy v hranatých zátvorkách. Dostupné ovládanie zahŕňa bočný posun, panorámovanie, nájazd, zvislý posun, nakláňanie, priblíženie, trasenie, sledovanie a statický záber. Príkaz ako [Push in] riadi približovanie; príkazy zoskupené v jednej zátvorke pôsobia spoločne, kým príkazy uvedené postupne opisujú sekvenciu. MiniMax odporúča najviac tri súčasné príkazy. Pohyb kamery udržte zlučiteľný s akciou subjektu, aby sa hlavná udalosť dala ľahko sledovať.
Automatická optimalizácia zadania je predvolene zapnutá a možno ju vypnúť na presnejšie riadenie dodaného znenia. Voliteľné rýchle predspracovanie skracuje čas optimalizácie, keď je zapnutá; ide o samostatné nastavenie, odlišné od výberu modelu Hailuo 2.3 Fast. Štandardný Hailuo 2.3 podporuje oba režimy tvorby, zatiaľ čo Fast je samostatná edícia image-to-video. Edíciu vyberte podľa toho, či projekt začína iba textom alebo existujúcou snímkou.
Postup generovania vracia identifikátor asynchrónnej úlohy a potom hlási prípravu, zaradenie do frontu, spracovanie, úspech alebo zlyhanie. Pri úspechu výsledok poskytne identifikátor súboru a skutočné rozmery videa a dokončené video sa načíta na stiahnutie. Klip uložte, kým je jeho adresa na stiahnutie platná. Aktuálna referencia výrobcu na sťahovanie videa uvádza hodinovú platnosť vrátenej URL na stiahnutie. Pri strihanej sekvencii si uchovajte každý záber s jeho zadaním a úvodným obrázkom, aby zvolený tvorivý smer zostal dohľadateľný počas revízií.
V uloženom klipe kontrolujte akciu, fyzickú kontinuitu, detaily tváre alebo produktu, vizuálny štýl a správanie kamery. Pozrite si celý záber a potom skontrolujte jeho začiatok a koniec v miestach napojenia na ďalší materiál. Ak požiadavka obsahuje príliš veľa protichodných pohybov, zjednodušte hlavnú akciu; ak je úvodný dizajn nejasný, vylepšite úvodný obrázok. Vyberte záber, ktorý komunikuje zamýšľanú udalosť, a potom v strihovom postupe pridajte komentár, titulky a prechody.
", "aboutText": "MiniMax Hailuo 2.3 je model na generovanie videa s režimami text-to-video a image-to-video. Nadväzuje na Hailuo 02 so zameraním na fyzickú akciu, vizuálny štýl, mikroexpresie postáv a reakciu na pohybové pokyny. Dodajte písanú scénu na vytvorenie záberu od začiatku alebo použite úvodný obrázok na určenie počiatočného pohľadu a opíšte nasledujúci pohyb.\n\nFyzický výkon je jednou z hlavných oblastí zlepšenia tejto edície. Hailuo 2.3 sa snaží dosiahnuť plynulejšie a kontrolovanejšie pohyby tela vrátane scén s pohybujúcou sa kamerou. Dôležitú akciu naplánujte pred pridávaním dekoratívnych detailov. Postava zdvíhajúca predmet, otáčajúca sa k inej osobe alebo prechádzajúca miestnosťou dáva záberu viditeľnú udalosť na vyhodnotenie. Rozhodnite, ktorý pohyb nesie príbeh, a ostatné pokyny s ním udržte v súlade.\n\nĎalším zameraním je štylizácia. Model podporuje prácu v anime a ilustrácii aj v štýloch ako tušová maľba a herné CG. Opíšte požadované vizuálne spracovanie a udržte vzhľad v súlade so scénou. Ak úvodný obrázok už určuje kresliarsky štýl, text použite na usmernenie animácie namiesto zavádzania konkurenčného opisu dizajnu postavy. V celom klipe overte, či toto spracovanie zostáva čitateľné počas pohybu.\n\nModel sa tiež zameriava na tvárový prejav a jemné zmeny výrazu. Záber postavy pripravte okolo dôležitej reakcie: všimnutia si predmetu, prebudenia zvedavosti alebo jemného úsmevu. Detailný záber môže uľahčiť posúdenie tejto zmeny, zatiaľ čo rozsiahla sekvencia gest od nej môže odvádzať pozornosť. Kontrolujte tvár pred reakciou, počas nej aj po nej namiesto hodnotenia iba reprezentatívnej statickej snímky.\n\nPohyb predmetov je užitočný pre scény sústredené na produkt. Pôvodné zadanie môže zobrazovať malú keramickú vázu otáčajúcu sa v teplom bočnom svetle, zatiaľ čo sa k nej kamera postupne približuje. Určte vlastnosti, ktoré musia zostať rozpoznateľné, napríklad siluetu, okraj a povrchovú úpravu. Tieto detaily kontrolujte počas pohybu, pretože samotná presvedčivá atmosféra nepotvrdzuje verný pohľad na produkt.\n\nPri text-to-video môže povinný opis obsahovať najviac 2 000 znakov. Subjekt, akciu, prostredie a vizuálny štýl uveďte v súvislom poradí. Image-to-video vyžaduje obrázok úvodnej snímky s voliteľným opisom najviac 2 000 znakov. Obrázok určuje úvodnú kompozíciu, preto pred požiadavkou na pohyb pripravte subjekt a rámovanie. Nechajte viditeľný priestor tam, kde sa má pohybovať ruka, predmet alebo postava.\n\nÚvodný obrázok môže byť JPG, JPEG, PNG alebo WebP, musí byť menší než 20 MB, mať kratší okraj väčší než 300 pixelov a pomer strán od 2:5 do 5:2. Možno ho dodať ako verejnú URL obrázka alebo dátovú URL Base64. Zvoľte jasný úvodný obrázok namiesto spoliehania sa, že animácia opraví zakrytú tvár alebo už orezanú akciu.\n\nHailuo 2.3 generuje pri 24 snímkach za sekundu. Šesťsekundový záber môže použiť 768P alebo 1080P; desaťsekundový používa 768P. Predvolené nastavenia sú šesť sekúnd a 768P. Dĺžku zvoľte podľa požadovanej akcie: krátka reakcia sa môže zmestiť do krátkeho záberu, pomalší pohyb potrebuje viac priestoru. Pri vkladaní klipu do strihu prečítajte skutočnú šírku a výšku dokončeného výsledku, pretože označenie rozlíšenia samo nevyjadruje celé rozhodnutie o kompozícii.\n\nSmerovanie kamery môže používať príkazy v hranatých zátvorkách. Dostupné ovládanie zahŕňa bočný posun, panorámovanie, nájazd, zvislý posun, nakláňanie, priblíženie, trasenie, sledovanie a statický záber. Príkaz ako [Push in] riadi približovanie; príkazy zoskupené v jednej zátvorke pôsobia spoločne, kým príkazy uvedené postupne opisujú sekvenciu. MiniMax odporúča najviac tri súčasné príkazy. Pohyb kamery udržte zlučiteľný s akciou subjektu, aby sa hlavná udalosť dala ľahko sledovať.\n\nAutomatická optimalizácia zadania je predvolene zapnutá a možno ju vypnúť na presnejšie riadenie dodaného znenia. Voliteľné rýchle predspracovanie skracuje čas optimalizácie, keď je zapnutá; ide o samostatné nastavenie, odlišné od výberu modelu Hailuo 2.3 Fast. Štandardný Hailuo 2.3 podporuje oba režimy tvorby, zatiaľ čo Fast je samostatná edícia image-to-video. Edíciu vyberte podľa toho, či projekt začína iba textom alebo existujúcou snímkou.\n\nPostup generovania vracia identifikátor asynchrónnej úlohy a potom hlási prípravu, zaradenie do frontu, spracovanie, úspech alebo zlyhanie. Pri úspechu výsledok poskytne identifikátor súboru a skutočné rozmery videa a dokončené video sa načíta na stiahnutie. Klip uložte, kým je jeho adresa na stiahnutie platná. Aktuálna referencia výrobcu na sťahovanie videa uvádza hodinovú platnosť vrátenej URL na stiahnutie. Pri strihanej sekvencii si uchovajte každý záber s jeho zadaním a úvodným obrázkom, aby zvolený tvorivý smer zostal dohľadateľný počas revízií.\n\nV uloženom klipe kontrolujte akciu, fyzickú kontinuitu, detaily tváre alebo produktu, vizuálny štýl a správanie kamery. Pozrite si celý záber a potom skontrolujte jeho začiatok a koniec v miestach napojenia na ďalší materiál. Ak požiadavka obsahuje príliš veľa protichodných pohybov, zjednodušte hlavnú akciu; ak je úvodný dizajn nejasný, vylepšite úvodný obrázok. Vyberte záber, ktorý komunikuje zamýšľanú udalosť, a potom v strihovom postupe pridajte komentár, titulky a prechody.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "f9a349c4706f6fb1176e8ac0066f444698c4d84cec43ce61e51309a0fdca5994", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sk", "methods": [ { "html": "MiniMax-Hailuo-2.3MiniMax Hailuo 2.3 vytvára videá z textu alebo úvodného obrázka s ovládaním pohybu a smerovania kamery. Zvoľte šesť sekúnd v 768P alebo 1080P, alebo desať sekúnd v 768P, pre herecké výkony postáv, štylizované scény a produktové zábery, ktoré možno posúdiť a upraviť.
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
MiniMax Hailuo 2.3 je model na generovanie videa s režimami text-to-video a image-to-video. Nadväzuje na Hailuo 02 so zameraním na fyzickú akciu, vizuálny štýl, mikroexpresie postáv a reakciu na pohybové pokyny. Dodajte písanú scénu na vytvorenie záberu od začiatku alebo použite úvodný obrázok na určenie počiatočného pohľadu a opíšte nasledujúci pohyb.
Fyzický výkon je jednou z hlavných oblastí zlepšenia tejto edície. Hailuo 2.3 sa snaží dosiahnuť plynulejšie a kontrolovanejšie pohyby tela vrátane scén s pohybujúcou sa kamerou. Dôležitú akciu naplánujte pred pridávaním dekoratívnych detailov. Postava zdvíhajúca predmet, otáčajúca sa k inej osobe alebo prechádzajúca miestnosťou dáva záberu viditeľnú udalosť na vyhodnotenie. Rozhodnite, ktorý pohyb nesie príbeh, a ostatné pokyny s ním udržte v súlade.
Ďalším zameraním je štylizácia. Model podporuje prácu v anime a ilustrácii aj v štýloch ako tušová maľba a herné CG. Opíšte požadované vizuálne spracovanie a udržte vzhľad v súlade so scénou. Ak úvodný obrázok už určuje kresliarsky štýl, text použite na usmernenie animácie namiesto zavádzania konkurenčného opisu dizajnu postavy. V celom klipe overte, či toto spracovanie zostáva čitateľné počas pohybu.
Model sa tiež zameriava na tvárový prejav a jemné zmeny výrazu. Záber postavy pripravte okolo dôležitej reakcie: všimnutia si predmetu, prebudenia zvedavosti alebo jemného úsmevu. Detailný záber môže uľahčiť posúdenie tejto zmeny, zatiaľ čo rozsiahla sekvencia gest od nej môže odvádzať pozornosť. Kontrolujte tvár pred reakciou, počas nej aj po nej namiesto hodnotenia iba reprezentatívnej statickej snímky.
Pohyb predmetov je užitočný pre scény sústredené na produkt. Pôvodné zadanie môže zobrazovať malú keramickú vázu otáčajúcu sa v teplom bočnom svetle, zatiaľ čo sa k nej kamera postupne približuje. Určte vlastnosti, ktoré musia zostať rozpoznateľné, napríklad siluetu, okraj a povrchovú úpravu. Tieto detaily kontrolujte počas pohybu, pretože samotná presvedčivá atmosféra nepotvrdzuje verný pohľad na produkt.
Pri text-to-video môže povinný opis obsahovať najviac 2 000 znakov. Subjekt, akciu, prostredie a vizuálny štýl uveďte v súvislom poradí. Image-to-video vyžaduje obrázok úvodnej snímky s voliteľným opisom najviac 2 000 znakov. Obrázok určuje úvodnú kompozíciu, preto pred požiadavkou na pohyb pripravte subjekt a rámovanie. Nechajte viditeľný priestor tam, kde sa má pohybovať ruka, predmet alebo postava.
Úvodný obrázok môže byť JPG, JPEG, PNG alebo WebP, musí byť menší než 20 MB, mať kratší okraj väčší než 300 pixelov a pomer strán od 2:5 do 5:2. Možno ho dodať ako verejnú URL obrázka alebo dátovú URL Base64. Zvoľte jasný úvodný obrázok namiesto spoliehania sa, že animácia opraví zakrytú tvár alebo už orezanú akciu.
Hailuo 2.3 generuje pri 24 snímkach za sekundu. Šesťsekundový záber môže použiť 768P alebo 1080P; desaťsekundový používa 768P. Predvolené nastavenia sú šesť sekúnd a 768P. Dĺžku zvoľte podľa požadovanej akcie: krátka reakcia sa môže zmestiť do krátkeho záberu, pomalší pohyb potrebuje viac priestoru. Pri vkladaní klipu do strihu prečítajte skutočnú šírku a výšku dokončeného výsledku, pretože označenie rozlíšenia samo nevyjadruje celé rozhodnutie o kompozícii.
Smerovanie kamery môže používať príkazy v hranatých zátvorkách. Dostupné ovládanie zahŕňa bočný posun, panorámovanie, nájazd, zvislý posun, nakláňanie, priblíženie, trasenie, sledovanie a statický záber. Príkaz ako [Push in] riadi približovanie; príkazy zoskupené v jednej zátvorke pôsobia spoločne, kým príkazy uvedené postupne opisujú sekvenciu. MiniMax odporúča najviac tri súčasné príkazy. Pohyb kamery udržte zlučiteľný s akciou subjektu, aby sa hlavná udalosť dala ľahko sledovať.
Automatická optimalizácia zadania je predvolene zapnutá a možno ju vypnúť na presnejšie riadenie dodaného znenia. Voliteľné rýchle predspracovanie skracuje čas optimalizácie, keď je zapnutá; ide o samostatné nastavenie, odlišné od výberu modelu Hailuo 2.3 Fast. Štandardný Hailuo 2.3 podporuje oba režimy tvorby, zatiaľ čo Fast je samostatná edícia image-to-video. Edíciu vyberte podľa toho, či projekt začína iba textom alebo existujúcou snímkou.
Postup generovania vracia identifikátor asynchrónnej úlohy a potom hlási prípravu, zaradenie do frontu, spracovanie, úspech alebo zlyhanie. Pri úspechu výsledok poskytne identifikátor súboru a skutočné rozmery videa a dokončené video sa načíta na stiahnutie. Klip uložte, kým je jeho adresa na stiahnutie platná. Aktuálna referencia výrobcu na sťahovanie videa uvádza hodinovú platnosť vrátenej URL na stiahnutie. Pri strihanej sekvencii si uchovajte každý záber s jeho zadaním a úvodným obrázkom, aby zvolený tvorivý smer zostal dohľadateľný počas revízií.
V uloženom klipe kontrolujte akciu, fyzickú kontinuitu, detaily tváre alebo produktu, vizuálny štýl a správanie kamery. Pozrite si celý záber a potom skontrolujte jeho začiatok a koniec v miestach napojenia na ďalší materiál. Ak požiadavka obsahuje príliš veľa protichodných pohybov, zjednodušte hlavnú akciu; ak je úvodný dizajn nejasný, vylepšite úvodný obrázok. Vyberte záber, ktorý komunikuje zamýšľanú udalosť, a potom v strihovom postupe pridajte komentár, titulky a prechody.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity MiniMax-Hailuo-2.3 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 Maximálna dĺžka: 2 000 Jednotka: znaky Unicode | Predvolené— |
Poleduration | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity 6, 10 Podmienky: 10 sekúnd vyžaduje 768P Jednotka: sekundy | Predvolené6 |
Poleresolution | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 768P, 1080P Podmienky: 1080P vyžaduje 6 sekúnd | Predvolené768P |
Polefirst_frame_image | Typhttps_url|data_image_url | PožiadavkaVoliteľné | Hodnoty a limity Maximálny počet dekódovaných bajtov: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp Minimálny rozmer (bez zahrnutia hranice): 300 Rozsah pomerov strán: 2:5, 5:2 | Predvolené— |
Poleprompt_optimizer | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polefast_pretreatment | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Z obrázka na video · Povinné: prompt, first_frame_image
Z textu na video · Povinné: prompt
| Parameter | Špecifikácia |
|---|---|
Parametermaterial_types | Špecifikáciatext, image |
Parameterrequired | Špecifikácianull |
Parameteroptional_controls | Špecifikácianull |
Ž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
Štruktúry metód a ID sú presné; možnosti dodávateľa sa posudzujú oddelene od prijatia požiadavky.
POST /v1/videos/generationsAiloot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaMiniMax-Hailuo-2.3 · Predvolená konfigurácia | Podmienky účtovaniaPredvolená konfigurácia | Poplatok Vstup · Vstup 0,00 USD za volanie Výstup · Výstup 0,60 USD za volanie |
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaMiniMax-Hailuo-2.3 · Predvolená konfigurácia | Podmienky účtovaniaPredvolená konfigurácia | Poplatok Vstup · Vstup 0,00 USD za volanie Výstup · Výstup 1,20 USD za volanie |
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaMiniMax-Hailuo-2.3 · Predvolená konfigurácia | Podmienky účtovaniaPredvolená konfigurácia | Poplatok Vstup · Vstup 0,00 USD za volanie Výstup · Výstup 1,20 USD za volanie |
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 alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Zachovajte každú vrátenú dátovú položku a index výstupu. content_url odkazuje iba na prvý výstup; načítajte každú skutočnú cestu obsahu alebo súbor. GET obsahu bez parametra index nevracia všetky výstupy.
Načítajte existujúcu pôvodnú úlohu; odoslanie s neznámym výsledkom 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 |
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra | Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia. |
Odpoveď409 · video_not_ready | PodmienkaPôvodný obsah výsledku zatiaľ nie je dostupný | Ďalší krokPriebežne zisťujte stav pomocou pôvodne vráteného ID a rešpektujte Retry-After. |
Odpoveďserver_error | PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať | Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte. |
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ára videá z textu alebo úvodného obrázka s ovládaním pohybu a smerovania kamery. Zvoľte šesť sekúnd v 768P alebo 1080P, alebo desať sekúnd v 768P, pre herecké výkony postáv, štylizované scény a produktové zábery, ktoré možno posúdiť a upraviť.
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
MiniMax Hailuo 2.3 je model na generovanie videa s režimami text-to-video a image-to-video. Nadväzuje na Hailuo 02 so zameraním na fyzickú akciu, vizuálny štýl, mikroexpresie postáv a reakciu na pohybové pokyny. Dodajte písanú scénu na vytvorenie záberu od začiatku alebo použite úvodný obrázok na určenie počiatočného pohľadu a opíšte nasledujúci pohyb.
Fyzický výkon je jednou z hlavných oblastí zlepšenia tejto edície. Hailuo 2.3 sa snaží dosiahnuť plynulejšie a kontrolovanejšie pohyby tela vrátane scén s pohybujúcou sa kamerou. Dôležitú akciu naplánujte pred pridávaním dekoratívnych detailov. Postava zdvíhajúca predmet, otáčajúca sa k inej osobe alebo prechádzajúca miestnosťou dáva záberu viditeľnú udalosť na vyhodnotenie. Rozhodnite, ktorý pohyb nesie príbeh, a ostatné pokyny s ním udržte v súlade.
Ďalším zameraním je štylizácia. Model podporuje prácu v anime a ilustrácii aj v štýloch ako tušová maľba a herné CG. Opíšte požadované vizuálne spracovanie a udržte vzhľad v súlade so scénou. Ak úvodný obrázok už určuje kresliarsky štýl, text použite na usmernenie animácie namiesto zavádzania konkurenčného opisu dizajnu postavy. V celom klipe overte, či toto spracovanie zostáva čitateľné počas pohybu.
Model sa tiež zameriava na tvárový prejav a jemné zmeny výrazu. Záber postavy pripravte okolo dôležitej reakcie: všimnutia si predmetu, prebudenia zvedavosti alebo jemného úsmevu. Detailný záber môže uľahčiť posúdenie tejto zmeny, zatiaľ čo rozsiahla sekvencia gest od nej môže odvádzať pozornosť. Kontrolujte tvár pred reakciou, počas nej aj po nej namiesto hodnotenia iba reprezentatívnej statickej snímky.
Pohyb predmetov je užitočný pre scény sústredené na produkt. Pôvodné zadanie môže zobrazovať malú keramickú vázu otáčajúcu sa v teplom bočnom svetle, zatiaľ čo sa k nej kamera postupne približuje. Určte vlastnosti, ktoré musia zostať rozpoznateľné, napríklad siluetu, okraj a povrchovú úpravu. Tieto detaily kontrolujte počas pohybu, pretože samotná presvedčivá atmosféra nepotvrdzuje verný pohľad na produkt.
Pri text-to-video môže povinný opis obsahovať najviac 2 000 znakov. Subjekt, akciu, prostredie a vizuálny štýl uveďte v súvislom poradí. Image-to-video vyžaduje obrázok úvodnej snímky s voliteľným opisom najviac 2 000 znakov. Obrázok určuje úvodnú kompozíciu, preto pred požiadavkou na pohyb pripravte subjekt a rámovanie. Nechajte viditeľný priestor tam, kde sa má pohybovať ruka, predmet alebo postava.
Úvodný obrázok môže byť JPG, JPEG, PNG alebo WebP, musí byť menší než 20 MB, mať kratší okraj väčší než 300 pixelov a pomer strán od 2:5 do 5:2. Možno ho dodať ako verejnú URL obrázka alebo dátovú URL Base64. Zvoľte jasný úvodný obrázok namiesto spoliehania sa, že animácia opraví zakrytú tvár alebo už orezanú akciu.
Hailuo 2.3 generuje pri 24 snímkach za sekundu. Šesťsekundový záber môže použiť 768P alebo 1080P; desaťsekundový používa 768P. Predvolené nastavenia sú šesť sekúnd a 768P. Dĺžku zvoľte podľa požadovanej akcie: krátka reakcia sa môže zmestiť do krátkeho záberu, pomalší pohyb potrebuje viac priestoru. Pri vkladaní klipu do strihu prečítajte skutočnú šírku a výšku dokončeného výsledku, pretože označenie rozlíšenia samo nevyjadruje celé rozhodnutie o kompozícii.
Smerovanie kamery môže používať príkazy v hranatých zátvorkách. Dostupné ovládanie zahŕňa bočný posun, panorámovanie, nájazd, zvislý posun, nakláňanie, priblíženie, trasenie, sledovanie a statický záber. Príkaz ako [Push in] riadi približovanie; príkazy zoskupené v jednej zátvorke pôsobia spoločne, kým príkazy uvedené postupne opisujú sekvenciu. MiniMax odporúča najviac tri súčasné príkazy. Pohyb kamery udržte zlučiteľný s akciou subjektu, aby sa hlavná udalosť dala ľahko sledovať.
Automatická optimalizácia zadania je predvolene zapnutá a možno ju vypnúť na presnejšie riadenie dodaného znenia. Voliteľné rýchle predspracovanie skracuje čas optimalizácie, keď je zapnutá; ide o samostatné nastavenie, odlišné od výberu modelu Hailuo 2.3 Fast. Štandardný Hailuo 2.3 podporuje oba režimy tvorby, zatiaľ čo Fast je samostatná edícia image-to-video. Edíciu vyberte podľa toho, či projekt začína iba textom alebo existujúcou snímkou.
Postup generovania vracia identifikátor asynchrónnej úlohy a potom hlási prípravu, zaradenie do frontu, spracovanie, úspech alebo zlyhanie. Pri úspechu výsledok poskytne identifikátor súboru a skutočné rozmery videa a dokončené video sa načíta na stiahnutie. Klip uložte, kým je jeho adresa na stiahnutie platná. Aktuálna referencia výrobcu na sťahovanie videa uvádza hodinovú platnosť vrátenej URL na stiahnutie. Pri strihanej sekvencii si uchovajte každý záber s jeho zadaním a úvodným obrázkom, aby zvolený tvorivý smer zostal dohľadateľný počas revízií.
V uloženom klipe kontrolujte akciu, fyzickú kontinuitu, detaily tváre alebo produktu, vizuálny štýl a správanie kamery. Pozrite si celý záber a potom skontrolujte jeho začiatok a koniec v miestach napojenia na ďalší materiál. Ak požiadavka obsahuje príliš veľa protichodných pohybov, zjednodušte hlavnú akciu; ak je úvodný dizajn nejasný, vylepšite úvodný obrázok. Vyberte záber, ktorý komunikuje zamýšľanú udalosť, a potom v strihovom postupe pridajte komentár, titulky a prechody.
POST /v1/videostextvideo| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity MiniMax-Hailuo-2.3 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 Maximálna dĺžka: 2 000 Podmienky: Pre 768P: najviac 2000 kódových bodov Unicode. Pre 1080P: menej než 200 kódových bodov Unicode (maximum 199). Zadanie musí obsahovať text, ktorý netvoria iba biele znaky. Jednotka: znaky Unicode | Predvolené— |
Poleduration | Typinteger | PožiadavkaPovinné | Hodnoty a limity 6 Jednotka: sekundy | Predvolené— |
Poleresolution | Typstring | PožiadavkaPovinné | Hodnoty a limity 768P, 1080P | Predvolené— |
Z textu na video · Povinné: prompt
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt, duration, resolution |
Parameterother_options | Špecifikáciafalse |
Parameterduration | Špecifikácia6 |
Parameterresolution | Špecifikácia768P, 1080P |
Parameterprompt_max_characters | Špecifikácia2000 |
Parametermaterial_types | Špecifikáciatext |
Parameterprompt_max_characters_by_resolution | Špecifikácia{"768P":2000,"1080P":199} |
Aliasy metódy: /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
Vytvorte iba raz a uložte vrátené ID.
Priebežne zisťujte pôvodný stav; zachovajte každý dokončený súbor a jeho dĺžku.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Nominálne trvanie klipu, sekundy | Rozlíšenie | Účtovacia jednotka | Poplatok |
|---|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Nominálne trvanie klipu, sekundy— | Rozlíšenie— | Účtovacia jednotka— | Poplatok Vstup · Vstupné tokeny — / 1K tokenov Výstup · Výstupné tokeny — / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
| KonfiguráciaUltra | Sadzobník— | Nominálne trvanie klipu, sekundy6 | Rozlíšenie1080P | Účtovacia jednotkaza výstupný klip s nominálnym trvaním 6s | Poplatok Výstup · výstupný klip s nominálnou dĺžkou 6s $1.2 za výstupný klip s nominálnym trvaním 6s |
| KonfiguráciaUltra | Sadzobník— | Nominálne trvanie klipu, sekundy6 | Rozlíšenie768P | Účtovacia jednotkaza výstupný klip s nominálnym trvaním 6s | Poplatok Výstup · výstupný klip s nominálnou dĺžkou 6s $0.6 za výstupný klip s nominálnym trvaním 6s |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaMiniMax-Hailuo-2.3 · Predvolená konfigurácia | Podmienky účtovaniaPredvolená konfigurácia | Poplatok Vstup · Vstup 0,00 USD za volanie Výstup · Výstup 0,60 USD za volanie |
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaMiniMax-Hailuo-2.3 · Predvolená konfigurácia | Podmienky účtovaniaPredvolená konfigurácia | Poplatok Vstup · Vstup 0,00 USD za volanie Výstup · Výstup 1,20 USD za volanie |
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaMiniMax-Hailuo-2.3 · Predvolená konfigurácia | Podmienky účtovaniaPredvolená konfigurácia | Poplatok Vstup · Vstup 0,00 USD za volanie Výstup · Výstup 1,20 USD za volanie |
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 alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Dokončené data[] obsahuje všetky podpísané URL obsahu vo vašom vlastníctve. Načítajte každú vrátenú URL alebo použite koncový bod obsahu s index nastaveným na skutočný index výstupu. Neúspešná pôvodná úloha môže vrátiť charge_pending_check; skontrolujte pôvodnú úlohu namiesto jej opätovného vytvorenia.
Načítajte existujúcu pôvodnú úlohu; odoslanie s neznámym výsledkom nikdy neopakujte.
Maximálny počet výstupov: 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 |
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra | Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia. |
Odpoveď409 · video_not_ready | PodmienkaPôvodný obsah výsledku zatiaľ nie je dostupný | Ďalší krokPriebežne zisťujte stav pomocou pôvodne vráteného ID a rešpektujte Retry-After. |
Odpoveďserver_error | PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať | Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte. |
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
/v1/videos/generations, /videos, /videos/generations