MiniMax-Hailuo-2.3
MiniMax 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ť.
- Ailoot · Generovanie videa
POST /v1/videos/generationsMiniMax-Hailuo-2.3 - Ailoot Ultra · Video
POST /v1/videosMiniMax-Hailuo-2.3
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
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.
Ailoot · Generovanie videa POST /v1/videos/generations MiniMax-Hailuo-2.3
MiniMax-Hailuo-2.3Úvod
MiniMax 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ť.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot · Generovanie videa POST /v1/videos/generations
- Vstup
text,image- Výstup
video- Výstupný formát
- mp4
| 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é— |
Kombinácie vstupných podkladov
Z obrázka na video · Povinné: prompt, first_frame_image
Z textu na video · Povinné: prompt
Parametre a životný cyklus metódy
| 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.
Cenník
Sadzby metód Ailoot
POST /v1/videos/generations- Výstup
- 0,28 USD za 6 s video pri 768p
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Podrobnosti referenčnej tarify
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
MiniMax-Hailuo-2.3
Ceny podľa konfigurácie
| 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 |
MiniMax-Hailuo-2.3
Ceny podľa konfigurácie
| 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 |
MiniMax-Hailuo-2.3
Ceny podľa konfigurácie
| 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 |
Príklady požiadaviek
Ailoot · Generovanie videa
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-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"}'Prijať a uložiť výsledky
Ailoot · Generovanie videa
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Skontrolovať stav úlohy
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
-H "Authorization: Bearer $AILOOT_API_KEY"Čítanie ďalšieho obsahu
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--output video.mp4Uchovať všetky dokončené výsledky
Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Zachovajte každú 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.
Ak treba overiť pôvodnú odpoveď
Načítajte existujúcu pôvodnú úlohu; odoslanie s neznámym výsledkom nikdy neopakujte.
Polia odpovede
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleobject | Typstring |
Polemodel | Typstring |
Polestatus | Typstring |
Polecontent_url | Typsigned URL |
Poledata[] | Typsigned URL |
Poleusage | Typobject |
Poleresult_pending_check | Typboolean |
Chyby a ďalšie kroky
| 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. |
Aliasy
Aliasy modelov
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
Aliasy ciest metód
/v1/videos/generations, /videos, /videos/generations
Súvisiace ID na volanie
Ailoot Ultra · Video POST /v1/videos MiniMax-Hailuo-2.3
MiniMax-Hailuo-2.3Úvod
MiniMax 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ť.
- Povolené vstupy
- Text
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Video POST /v1/videos
- Vstup
text- Výstup
video- Výstupný formát
- mp4
- Počet výstupov
- Do 1 výstup
| 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é— |
Kombinácie vstupných podkladov
Z textu na video · Povinné: prompt
Parametre a životný cyklus metódy
| 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.
Cenník
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Sadzby Ailoot
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurá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 →
Podrobnosti referenčnej tarify
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
MiniMax-Hailuo-2.3
Ceny podľa konfigurácie
| 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 |
MiniMax-Hailuo-2.3
Ceny podľa konfigurácie
| 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 |
MiniMax-Hailuo-2.3
Ceny podľa konfigurácie
| 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 |
Príklady požiadaviek
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
Prijať a uložiť výsledky
Ailoot Ultra · Video
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Skontrolovať stav úlohy
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
Uložiť všetky dokončené podklady
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if 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")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
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")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Čítanie ďalšieho obsahu
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
Uchovať všetky dokončené výsledky
Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
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.
Ak treba overiť pôvodnú odpoveď
Načítajte existujúcu pôvodnú úlohu; odoslanie s neznámym výsledkom nikdy neopakujte.
Maximálny počet výstupov: 1.
Polia odpovede
| 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 |
Chyby a ďalšie kroky
| 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. |
Aliasy
Aliasy modelov
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
Aliasy ciest metód
/v1/videos/generations, /videos, /videos/generations
Súvisiace ID na volanie
FAQ · MiniMax-Hailuo-2.3
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:text,image→videoPOST /v1/videos·MiniMax-Hailuo-2.3:text→video- Aké polia používa požiadavka?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:model,prompt,duration,resolution,first_frame_image,prompt_optimizer,fast_pretreatmentPOST /v1/videos·MiniMax-Hailuo-2.3:model,prompt,duration,resolution- Aké limity platia?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:prompt.maximum_length:2000POST /v1/videos·MiniMax-Hailuo-2.3:prompt.maximum_length:2000