MiniMax: Hailuo 02
A Hailuo 02 szövegből vagy egy kezdőképként megadott képből készít videót, és dokumentáltan támogatja az első és utolsó képkockára épülő munkafolyamatot. A kameraparancsok, a promptoptimalizálás, valamint az üzemmódhoz tartozó időtartam- és felbontásválasztási lehetőségek segítenek kialakítani a tervezett felvételt.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A Hailuo 02 a MiniMax videómodellje szövegből felépített jelenetekhez, képek animálásához, valamint első és utolsó képkockára épülő munkafolyamathoz. Az írott leírás határozza meg a témát, a cselekményt és a kamerát, a megadott képkockák pedig kijelölhetik a vizuális kiindulópontot vagy az átmenet végállapotát. A generálási módot a már rendelkezésre álló anyag és a felvétel irányítani kívánt része alapján válassza ki.
Szövegből készülő videóhoz összefüggő cselekményt írjon le, jól értelmezhető környezettel és nézőponttal. Egy jelenet például egy móló mellett elhaladó kis vitorlást mutathat, miközben a kamera a partról követi. Adja meg, mi mozog, mely részletek maradjanak láthatók, és hogyan érjen véget a felvétel. A leírás megfigyelhető eseményekre összpontosítson, ne egymástól független vizuális tulajdonságok felsorolására.
Képből készülő videóhoz olyan első képkockát készítsen elő, amelyen már szerepel a kívánt téma és képkivágás. A gyártó 20 MB-nál kisebb JPG-, JPEG-, PNG- és WebP-képeket fogad el, 300 képpontnál hosszabb rövidebb oldallal, valamint 2:5 és 5:2 közötti képaránnyal. Olyan képet használjon, amelyen láthatók a fontos körvonalak és jellegzetességek, majd írja le az abból kibontakozó mozgást.
A Hailuo 02 dokumentáltan rendelkezik első és utolsó képkockát használó móddal is. A két képet egyetlen képsor kívánt nyitó- és záróállapotaként készítse elő, és írja le, hogyan halad a jelenet a kettő között. Az első képkocka határozza meg a képkivágást; a gyártó szerint az eltérő méretű utolsó képkockát ehhez igazítva vágja körül a rendszer. Előre hangolja össze a képek kompozícióját, ha a témának az átmenet teljes ideje alatt láthatónak kell maradnia.
A prompt legfeljebb 2000 karaktert tartalmazhat. A Hailuo 02 támogatja a szögletes zárójelbe tett kameraparancsokat, köztük a push, pull, truck, pan, pedestal, tilt, zoom és tracking mozgásokat, valamint a statikus felvételt. Az egy zárójelben együtt elhelyezett parancsok egyidejű mozgást kérnek; a leírás különböző pontjaira helyezett parancsok mozgássorozatot adnak meg. A gyártó legfeljebb három mozgás kombinálását javasolja, ezért olyan kameramozgást válasszon, amely megkönnyíti a téma értelmezését.
Az időtartam és a felbontás az üzemmódtól függ. A szövegből videót készítő mód dokumentációja 768P mellett hat vagy tíz másodpercet, 1080P mellett hat másodpercet ad meg. A képből videót készítő módnál 512P is szerepel hat vagy tíz másodperces időtartammal. Az első és utolsó képkockára épülő munkafolyamatnál 768P mellett hat vagy tíz másodperc, 1080P mellett hat másodperc van dokumentálva. A felvételhez támogatott kombinációt válasszon, ahelyett hogy az egyik mód felbontási lehetőségeit az összes többire is alkalmazná.
Az automatikus promptoptimalizálás dokumentált beállítás, és a gyártó munkafolyamatában alapértelmezés szerint be van kapcsolva. A változatok összehasonlításakor őrizze meg ezt a beállítást, mert az átírt leírás megváltoztatja a modellhez eljutó bemenetet. A pontos szöveget, a referenciaképkockákat és a választott kimeneti beállításokat tartsa együtt a generált klippel, hogy a módosítás a javítandó cselekményre vagy képkivágásra irányulhasson.
Ellenőrizze a teljes elkészült képsort: a nyitókompozíciót, a téma folytonosságát, a cselekmény időzítését és az utolsó képkockát. Átmenetnél vizsgálja meg az első és az utolsó képkockát, valamint a közöttük zajló mozgást. A tényleges videót mentse el szerkesztéshez a prompttal és a referenciákkal együtt; a következő módosítással konkrét vizuális problémát javítson, például egy takart részletet, hirtelen kameramozgást vagy túl korán bekövetkező befejezést.
Ailoot Ultra · Videó POST /v1/videos minimaxi-hailuo-02
minimaxi-hailuo-02Kezdő lépések
A Hailuo 02 szövegből vagy egy kezdőképként megadott képből készít videót, és dokumentáltan támogatja az első és utolsó képkockára épülő munkafolyamatot. A kameraparancsok, a promptoptimalizálás, valamint az üzemmódhoz tartozó időtartam- és felbontásválasztási lehetőségek segítenek kialakítani a tervezett felvételt.
- Elfogadott bemenetek
- Szöveg · Képek
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Videó POST /v1/videos
- Bemenet
text,image- Kimenet
video
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok minimaxi-hailuo-02 Feltételek: Használja a pontos Ailoot modellválasztót. | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Feltételek: Írja le a jelenetet és a mozgást. | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményOpcionális | Értékek és korlátok 6, 10 Feltételek: A felsorolt időtartamértékek egyikét küldje el; alapértelmezett értéket nem állítunk. | Alapértelmezett— |
Mezőend_image | Típusstring | KövetelményOpcionális | Értékek és korlátok Feltételek: A záró képkocka kizárólag támogatott képbemeneti módban érvényes. | Alapértelmezett— |
Mezőimage | Típusstring or array<string> | KövetelményOpcionális | Értékek és korlátok Feltételek: Használjon tényleges, nyilvánosan elérhető kép-URL-címet vagy base64 képsztringet; itt nem állítunk maximális képdarabszámot. | Alapértelmezett— |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 512P, 768P, 1080P Feltételek: A felsorolt felbontási értékek egyikét küldje el; alapértelmezett értéket nem állítunk. | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paraméteroptional | Szerződésduration, end_image, image, resolution |
Paramétermaterial_types | Szerződéstext, image |
Paraméterconditions | SzerződésHasználja a pontos Ailoot modellválasztót., Írja le a jelenetet és a mozgást., A felsorolt időtartamértékek egyikét küldje el; alapértelmezett értéket nem állítunk., A záró képkocka kizárólag támogatott képbemeneti módban érvényes., Használjon tényleges, nyilvánosan elérhető kép-URL-címet vagy base64 képsztringet; itt nem állítunk maximális képdarabszámot., A felsorolt felbontási értékek egyikét küldje el; alapértelmezett értéket nem állítunk. |
Metódus álnevei: /v1/videos/generations
Életciklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.2 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot Ultra · Videó
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-hailuo-02",
"prompt": "A cat is walking on grass."
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Eredmények fogadása és mentése
Ailoot Ultra · Videó
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizze meg a teljes választ és fejléceit, az eredeti azonosítókat, az összes tényleges kimenetet és minden felhasználási, illetve elszámolási mezőt. Mentsen el minden egyedi saját médiaállományt, és őrizzen meg minden rá mutató szerepet.
Ha az eredeti választ ellenőrizni kell
Őrizze meg a visszaadott nyilvános feladat- vagy műveletazonosítót és az összes fejlécet. Csak az eredeti feladatot kérdezze le; az unknown vagy result_pending_check nem jogosít fel újabb létrehozásra.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőpolling_url | Típusstring |
Mezőprovider_task_id | Típusstring |
Mezőtask_id | Típusstring |
Mezőstatus | Típusstring |
Mezővideo_url | Típusstring |
Álnevek
Modell álnevei
Ailoot Ultra minimaxi-hailuo-02
Metódusútvonalak álnevei
/v1/videos/generations
Kapcsolódó modellazonosítók
FAQ · MiniMax: Hailuo 02
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·minimaxi-hailuo-02:text,image→video- Mely mezőket használja a kérés?
POST /v1/videos·minimaxi-hailuo-02:model,prompt,duration,end_image,image,resolution