MiniMax: Hailuo 02
Hailuo 02 erzeugt Video aus Text oder einem ersten Einzelbild und unterstützt einen dokumentierten Ablauf mit erstem und letztem Einzelbild. Kamerabefehle, Promptoptimierung sowie modusspezifische Dauer- und Auflösungsoptionen helfen, die gewünschte Aufnahme zu gestalten.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Hailuo 02 ist MiniMax’ Videomodell für textgestützte Szenen, Bildanimation und einen Ablauf mit erstem und letztem Einzelbild. Ein schriftlicher Auftrag beschreibt Motiv, Handlung und Kamera, während bereitgestellte Einzelbilder den visuellen Anfangspunkt oder das Ziel des Übergangs festlegen können. Wählen Sie den Generierungsmodus nach dem vorhandenen Material und dem Teil der Aufnahme, den Sie steuern möchten.
Beschreiben Sie für Text-zu-Video eine zusammenhängende Handlung mit klar erkennbarer Umgebung und Blickrichtung. Eine Szene könnte ein kleines Segelboot zeigen, das an einem Steg vorbeifährt, während die Kamera es vom Ufer aus verfolgt. Bestimmen Sie, was sich bewegt, welche Details sichtbar bleiben sollen und wie die Aufnahme endet. Halten Sie den Auftrag auf beobachtbare Ereignisse statt auf eine Liste unverbundener visueller Eigenschaften ausgerichtet.
Bereiten Sie für Bild-zu-Video ein erstes Einzelbild vor, das gewünschtes Motiv und Bildausschnitt bereits festlegt. Der Hersteller akzeptiert JPG-, JPEG-, PNG- und WebP-Bilder unter 20 MB, mit einer kurzen Kante über 300 Pixeln und einem Seitenverhältnis zwischen 2:5 und 5:2. Verwenden Sie ein Bild mit sichtbaren wichtigen Konturen und Merkmalen und beschreiben Sie dann die daraus zu entwickelnde Bewegung.
Hailuo 02 hat außerdem einen dokumentierten Modus mit erstem und letztem Einzelbild. Bereiten Sie die beiden Bilder als gewünschte Anfangs- und Endzustände einer Sequenz vor und beschreiben Sie die Bewegung der Szene dazwischen. Das erste Einzelbild bestimmt den Bildausschnitt; laut Hersteller wird ein letztes Einzelbild mit abweichender Größe passend zugeschnitten. Stimmen Sie die Bildkompositionen im Voraus ab, wenn ein Motiv durch den Übergang hindurch sichtbar bleiben muss.
Der Prompt kann bis zu 2.000 Zeichen enthalten. Hailuo 02 unterstützt Kamerabefehle in Klammern, darunter push, pull, truck, pan, pedestal, tilt, zoom, tracking und eine statische Aufnahme. Gemeinsam in einer Klammer platzierte Befehle verlangen gleichzeitige Bewegung; an unterschiedlichen Stellen der Beschreibung platzierte Befehle verlangen eine Folge. Der Hersteller empfiehlt, höchstens drei Bewegungen zu kombinieren; wählen Sie deshalb die Kamerabewegung, die das Motiv leichter erkennbar macht.
Dauer und Auflösung sind an den Modus gebunden. Text-zu-Video dokumentiert sechs oder zehn Sekunden bei 768P und sechs Sekunden bei 1080P. Bild-zu-Video dokumentiert zusätzlich 512P für sechs oder zehn Sekunden. Der Ablauf mit erstem und letztem Einzelbild dokumentiert 768P für sechs oder zehn Sekunden und 1080P für sechs Sekunden. Wählen Sie eine unterstützte Kombination für die Aufnahme, statt die Auflösungsoptionen eines Modus auf alle anderen Modi zu übertragen.
Automatische Promptoptimierung ist eine dokumentierte Steuerung und im Herstellerablauf standardmäßig eingeschaltet. Erhalten Sie ihre Einstellung beim Versionsvergleich, denn ein umgeschriebener Auftrag verändert die Eingabe des Modells. Bewahren Sie den genauen Text, Referenzbilder und gewählten Ausgabeeinstellungen zusammen mit dem erzeugten Clip auf, damit eine Überarbeitung gezielt die zu verbessernde Handlung oder den Bildausschnitt behandeln kann.
Prüfen Sie die gesamte fertige Sequenz: Anfangskomposition, Motivkontinuität, zeitlichen Ablauf der Handlung und Schlussbild. Prüfen Sie bei einem Übergang beide Endpunkte und die Bewegung dazwischen. Speichern Sie das tatsächliche Video zusammen mit Prompt und Referenzen für die Bearbeitung und richten Sie die nächste Überarbeitung auf ein konkretes visuelles Problem, etwa ein verdecktes Detail, eine abrupte Kamerabewegung oder ein zu früh eintreffendes Ende.
Ailoot Ultra · Videogenerierung POST /v1/videos minimaxi-hailuo-02
minimaxi-hailuo-02Start
Hailuo 02 erzeugt Video aus Text oder einem ersten Einzelbild und unterstützt einen dokumentierten Ablauf mit erstem und letztem Einzelbild. Kamerabefehle, Promptoptimierung sowie modusspezifische Dauer- und Auflösungsoptionen helfen, die gewünschte Aufnahme zu gestalten.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Videogenerierung POST /v1/videos
- Eingabetypen
text,image- Ausgabetypen
video
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits minimaxi-hailuo-02 Bedingungen: Verwenden Sie die genaue Ailoot-Modellauswahl. | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Bedingungen: Beschreiben Sie die Szene und die Bewegung. | Standard— |
Feldduration | Typinteger | AnforderungOptional | Werte und Limits 6, 10 Bedingungen: Senden Sie einen der aufgeführten Dauerwerte; ein Standardwert wird nicht zugesichert. | Standard— |
Feldend_image | Typstring | AnforderungOptional | Werte und Limits Bedingungen: Ein Endframe gilt nur in einem unterstützten Bildeingabemodus. | Standard— |
Feldimage | Typstring or array<string> | AnforderungOptional | Werte und Limits Bedingungen: Verwenden Sie eine tatsächliche, öffentlich erreichbare Bild-URL oder eine base64-Bildzeichenfolge; eine maximale Bildanzahl wird hier nicht zugesichert. | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 512P, 768P, 1080P Bedingungen: Senden Sie einen der aufgeführten Auflösungswerte; ein Standardwert wird nicht zugesichert. | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional | Vertragduration, end_image, image, resolution |
Parametermaterial_types | Vertragtext, image |
Parameterconditions | VertragVerwenden Sie die genaue Ailoot-Modellauswahl., Beschreiben Sie die Szene und die Bewegung., Senden Sie einen der aufgeführten Dauerwerte; ein Standardwert wird nicht zugesichert., Ein Endframe gilt nur in einem unterstützten Bildeingabemodus., Verwenden Sie eine tatsächliche, öffentlich erreichbare Bild-URL oder eine base64-Bildzeichenfolge; eine maximale Bildanzahl wird hier nicht zugesichert., Senden Sie einen der aufgeführten Auflösungswerte; ein Standardwert wird nicht zugesichert. |
Methodenaliasnamen: /v1/videos/generations
Lebenszyklus: 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}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebühr |
|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.2 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Videogenerierung
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
Ergebnisse abrufen und speichern
Ailoot Ultra · Videogenerierung
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}
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie die vollständige Antwort und die Header, ursprüngliche Kennungen, jede tatsächliche Ausgabe sowie alle Verbrauchs- und Abrechnungsfelder auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und bewahren Sie jede darauf verweisende Rolle auf.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie die zurückgegebene öffentliche Aufgaben- oder Vorgangs-ID und sämtliche Header auf. Lesen Sie ausschließlich die ursprüngliche Aufgabe aus; unknown oder result_pending_check berechtigt nicht zu einer weiteren Erstellung.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldpolling_url | Typstring |
Feldprovider_task_id | Typstring |
Feldtask_id | Typstring |
Feldstatus | Typstring |
Feldvideo_url | Typstring |
Aliasnamen
Modellaliasnamen
Ailoot Ultra minimaxi-hailuo-02
Aliasnamen für Methodenpfade
/v1/videos/generations
Zugehörige Aufrufer-IDs
FAQ · MiniMax: Hailuo 02
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·minimaxi-hailuo-02:text,image→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·minimaxi-hailuo-02:model,prompt,duration,end_image,image,resolution