Skip to Content
ModelleHailuo (MiniMax)

Hailuo-Reihe (MiniMax)

Die Hailuo-Videogenerierungsmodelle von MiniMax, insgesamt zwei, aufgerufen über den OfoxAI-Videoendpunkt POST /v1/videos. Aufgaben laufen asynchron: Nach dem Erstellen erhalten Sie eine Aufgaben-ID, über die Sie anschließend das Ergebnis abfragen.

Modellwahl

Kurz gesagtFür 2K-Ausgabe Hailuo 3 wählen; für 480p Hailuo 3 Max wählen. Keines der beiden Modelle unterstützt 720p oder 1080p.
ModellAuflösung (Standard)DauerSeitenverhältnis
Hailuo 3768p 2k (768p)4–15 Sekunden21:9 16:9 4:3 1:1 3:4 9:16 adaptive
Hailuo 3 Max480p 768p (768p)5–15 SekundenWie oben

Beide unterstützen Text-zu-Video, Bild-zu-Video und Videoreferenzen und können eine synchrone Tonspur erzeugen (generate_audio ist standardmäßig true). adaptive übernimmt das Seitenverhältnis des Eingabebilds.

Modell-IDs (exakt kopieren)
Hailuo 3minimax/hailuo-3768p, 2K
Hailuo 3 Maxminimax/hailuo-3-max480p, 768p, mindestens 5 Sekunden

Die Tabelle entspricht den video_attributes, die die Models API zurückgibt; ändern sich die Fähigkeiten eines Modells, ist die Antwort der API maßgeblich. Abgerechnet wird pro Sekunde; die tatsächlichen Kosten stehen in usage.video_cost des Aufgabenergebnisses. Preise finden Sie auf der Modellseite .

Aufrufbeispiele

Die folgenden Beispiele zeigen nur die Anfrage zum Erstellen der Aufgabe. Den vollständigen Ablauf mit Statusabfrage und Download des Ergebnisses finden Sie unter Video API · Schnellstart.

Nur prompt übergeben.

Terminal
curl -X POST https://api.ofox.io/v1/videos \ -H "Authorization: Bearer $OFOX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "minimax/hailuo-3", "prompt": "Breitbildaufnahme: Ein Oldtimer fährt auf einer Wüstenstraße der untergehenden Sonne entgegen", "duration": 6, "resolution": "768p", "aspect_ratio": "21:9" }'
  • frame_images und input_references dürfen nicht gemeinsam übergeben werden; andernfalls wird 400 references_conflict zurückgegeben.
  • Wenn Sie keine Tonspur benötigen, übergeben Sie "generate_audio": false.
  • Die vollständige Beschreibung der Feldstruktur finden Sie unter Videoaufgabe erstellen.

Schreibweise der Auflösung

Die Auflösungsstufen von Hailuo unterscheiden sich von denen anderer Reihen: 768p und 2k (kleines k). Die bei anderen Reihen üblichen Werte 720p und 1080p liefern 400.

Häufige Fehler

Kurz gesagtValidierungsfehler bei Parametern werden bereits beim Erstellen zurückgegeben; es wird keine Aufgabe angelegt, und es entstehen keine Kosten. Die Fehlermeldung nennt die zulässigen Werte.
HTTP · codeFehlermeldung (Original)UrsacheLösung
400 unsupported_parameterresolution "1080p" not supported; allowed: [768p 2k]Hailuo unterstützt kein 1080pBei Hailuo 3 768p oder 2k verwenden
400 unsupported_parameterduration 4 out of range [5, 15]Hailuo 3 Max erfordert mindestens 5 Sekunden5 Sekunden oder mehr angeben oder zu Hailuo 3 wechseln
400 references_conflictframe_images and input_references are mutually exclusiveBeide Eingabefelder wurden gleichzeitig übergebenNur eines der beiden verwenden
404 model_not_foundmodel not foundModell-ID falsch geschriebenModell-ID von dieser Seite kopieren

Alle Fehlercodes finden Sie unter Fehlercodes der Video API.

Offizielle Dokumentation

FAQ

Unterstützt Hailuo 3 1080p?

Nein. Hailuo 3 bietet die Auflösungen 768p und 2k, Hailuo 3 Max 480p und 768p. 720p oder 1080p liefern 400 resolution not supported.

Hailuo 3 Max meldet duration 4 out of range [5, 15]?

Hailuo 3 Max erzeugt pro Aufgabe mindestens 5 und höchstens 15 Sekunden. Für ein 4-Sekunden-Video verwenden Sie Hailuo 3.

Unterstützen Hailuo-Videos 21:9?

Ja. Hailuo 3 und Hailuo 3 Max unterstützen beide 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 und adaptive.

Zuletzt aktualisiert am