MiniMax: Hailuo 02
Hailuo 02 skapar video från text eller en första bildruta och stöder ett dokumenterat arbetsflöde med första och sista bildrutan. Kamerakommandon, promptoptimering och lägesspecifika val av längd och upplösning hjälper till att forma den avsedda tagningen.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
Hailuo 02 är MiniMax videomodell för textstyrda scener, bildanimering och ett arbetsflöde med första och sista bildrutan. En skriftlig beskrivning anger motivet, handlingen och kameran, medan tillhandahållna bildrutor kan fastställa den visuella utgångspunkten eller övergångens destination. Välj genereringsläge efter det material som redan finns och den del av tagningen du behöver styra.
För text-till-video beskriver du en sammanhängande handling med en tydlig miljö och kameravinkel. En scen kan visa en liten segelbåt som passerar en brygga medan kameran följer från stranden. Ange vad som rör sig, vilka detaljer som ska förbli synliga och hur tagningen slutar. Håll beskrivningen inriktad på observerbara händelser i stället för en lista med orelaterade visuella kvaliteter.
För bild-till-video förbereds en första bildruta som redan fastställer det avsedda motivet och inramningen. Tillverkaren accepterar JPG-, JPEG-, PNG- och WebP-bilder under 20 MB, med en kortsida större än 300 pixlar och ett bildförhållande mellan 2:5 och 5:2. Välj en bild med synliga viktiga konturer och egenskaper och beskriv sedan rörelsen som ska utvecklas från den.
Hailuo 02 har också ett dokumenterat läge med första och sista bildrutan. Förbered de två bilderna som de avsedda öppnings- och sluttillstånden i en sekvens och beskriv hur scenen rör sig mellan dem. Den första bildrutan bestämmer inramningen; tillverkaren anger att en sista bildruta med annan storlek beskärs så att den passar den första. Anpassa bildernas komposition i förväg när ett motiv måste förbli synligt genom övergången.
Prompten får innehålla upp till 2 000 tecken. Hailuo 02 stöder kamerakommandon inom hakparenteser, bland annat push, pull, truck, pan, pedestal, tilt, zoom, tracking och static shot. Kommandon i samma hakparentes begär samtidig rörelse; kommandon på olika ställen i beskrivningen begär en sekvens. Tillverkaren rekommenderar att högst tre rörelser kombineras, så välj den kamerahandling som gör motivet lättare att läsa.
Längd och upplösning är kopplade till läget. Text-till-video dokumenterar sex eller tio sekunder i 768P och sex sekunder i 1080P. Bild-till-video dokumenterar dessutom 512P i sex eller tio sekunder. Arbetsflödet med första och sista bildrutan dokumenterar 768P i sex eller tio sekunder och 1080P i sex sekunder. Välj en stödd kombination för tagningen i stället för att överföra ett läges upplösningsalternativ till alla andra lägen.
Automatisk promptoptimering är en dokumenterad kontroll och är aktiverad som standard i tillverkarens arbetsflöde. Behåll inställningen vid jämförelser mellan versioner, eftersom en omskriven beskrivning ändrar vad modellen får. Spara exakt text, referensbilder och valda utdatainställningar med den genererade videon så att en revidering kan riktas mot den handling eller inramning som behöver förbättras.
Granska hela den färdiga sekvensen: öppningskompositionen, motivets kontinuitet, handlingens timing och slutbilden. För en övergång kontrolleras både ändpunkterna och rörelsen mellan dem. Spara den faktiska videon för redigering tillsammans med prompten och referenserna; använd nästa revidering för att rätta ett konkret visuellt problem, exempelvis en dold detalj, en abrupt kamerarörelse eller ett slut som kommer för tidigt.
Ailoot Ultra · Videor POST /v1/videos minimaxi-hailuo-02
minimaxi-hailuo-02Start
Hailuo 02 skapar video från text eller en första bildruta och stöder ett dokumenterat arbetsflöde med första och sista bildrutan. Kamerakommandon, promptoptimering och lägesspecifika val av längd och upplösning hjälper till att forma den avsedda tagningen.
- Godkända indata
- Text · Bilder
- Resultat
- Video
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Videor POST /v1/videos
- Indatatyper
text,image- Utdatatyper
video
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser minimaxi-hailuo-02 Villkor: Använd den exakta modellväljaren för Ailoot. | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Villkor: Beskriv scenen och rörelsen. | Standard— |
Fältduration | Typinteger | KravValfritt | Värden & gränser 6, 10 Villkor: Skicka ett av de angivna längdvärdena; inget standardvärde fastställs. | Standard— |
Fältend_image | Typstring | KravValfritt | Värden & gränser Villkor: En slutbildruta gäller endast i ett bildindataläge som stöds. | Standard— |
Fältimage | Typstring or array<string> | KravValfritt | Värden & gränser Villkor: Använd en faktisk offentligt åtkomlig URL till en bild eller en bildsträng i base64; inget högsta antal bilder fastställs här. | Standard— |
Fältresolution | Typstring | KravValfritt | Värden & gränser 512P, 768P, 1080P Villkor: Skicka ett av de angivna upplösningsvärdena; inget standardvärde fastställs. | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parameteroptional | Avtalduration, end_image, image, resolution |
Parametermaterial_types | Avtaltext, image |
Parameterconditions | AvtalAnvänd den exakta modellväljaren för Ailoot., Beskriv scenen och rörelsen., Skicka ett av de angivna längdvärdena; inget standardvärde fastställs., En slutbildruta gäller endast i ett bildindataläge som stöds., Använd en faktisk offentligt åtkomlig URL till en bild eller en bildsträng i base64; inget högsta antal bilder fastställs här., Skicka ett av de angivna upplösningsvärdena; inget standardvärde fastställs. |
Metodalias: /v1/videos/generations
Livscykel: 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}
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.2 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Videor
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
Ta emot och spara resultat
Ailoot Ultra · Videor
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}
Behåll alla färdiga resultat
Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Behåll hela svaret och svarshuvudena, ursprungliga identifierare, varje faktiskt resultat och alla förbruknings- och redovisningsfält. Spara varje unik tillgång som du äger och behåll varje roll som pekar på den.
Om det ursprungliga svaret behöver kontrolleras
Behåll det returnerade offentliga uppgifts- eller operations-id:t och samtliga svarshuvuden. Läs endast den ursprungliga uppgiften; unknown eller result_pending_check ger inte tillstånd att skapa på nytt.
Svarsfält
| Fält | Typ |
|---|---|
Fältid | Typstring |
Fältpolling_url | Typstring |
Fältprovider_task_id | Typstring |
Fälttask_id | Typstring |
Fältstatus | Typstring |
Fältvideo_url | Typstring |
Alias
Modellalias
Ailoot Ultra minimaxi-hailuo-02
Alias för metodsökvägar
/v1/videos/generations
Relaterade anropar-ID:n
FAQ · MiniMax: Hailuo 02
- Vilka indata och resultat finns?
POST /v1/videos·minimaxi-hailuo-02:text,image→video- Vilka fält använder begäran?
POST /v1/videos·minimaxi-hailuo-02:model,prompt,duration,end_image,image,resolution