Skip to main content
POST

Autorisierung

string
erforderlich
Alle API-Endpunkte erfordern eine Bearer-Token-AuthentifizierungAPI-Key abrufen:Besuchen Sie die Seite zur API-Key-Verwaltung, um Ihren API-Key zu erhaltenFügen Sie ihn zum Request-Header hinzu:

Generierungsmodi

MiniMax-H3 wählt den passenden Modus automatisch anhand der Anfragefelder. Kein mode-Feld erforderlich:
Strikte gegenseitige Ausschließlichkeit: Image-to-Video-Felder (first_frame_image / last_frame_image sowie first_frame / last_frame in image_with_roles) können nicht mit multimodalen Referenzfeldern (image_urls, video_urls, audio_urls und reference_image in image_with_roles) kombiniert werden. Eine Mischung gibt 400 zurück.
Audio allein ist nicht erlaubt. Wenn Sie audio_urls übergeben, müssen Sie auch mindestens ein Referenzbild oder Referenzvideo angeben.

Anfrageparameter

Allgemeine Felder

string
erforderlich
Fester Wert: MiniMax-H3
model ist erforderlich und muss explizit gesendet werden. Clients, die bereits mit Hailuo integriert sind, können umschalten, indem sie model auf MiniMax-H3 setzen.
string
erforderlich
Beschreibung des Videoinhalts. In jedem Szenario erforderlich und nicht leer, maximal 7000 Zeichen pro Anfrage.Beschreiben Sie Szene, Subjekt, Bewegung und Stil detailliert für bessere Ergebnisse.Beispiel: "A boy playing basketball by the sea at dusk, waves crashing, cinematic camera work"
integer
Standard:"5"
Ausgabedauer (Sekunden)
  • Bereich: Ganzzahl von 4 bis 15
  • Standard: 5
string
Standard:"2K"
Videoauflösung
  • Unterstützter Wert: nur 2K (Standard)
string
Seitenverhältnis. Sie können auch size oder ratio mit derselben Wirkung übergeben.Zulässige Verhältnisse: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16Das Verhalten je Szenario ist unten unter „Regeln zum Seitenverhältnis“ beschrieben.
boolean
Standard:"false"
Ob ein AIGC-Wasserzeichen hinzugefügt werden sollStandard: falseKompatibler Alias: aigc_watermark
string
URL, die eine Benachrichtigung erhält, wenn die Aufgabe einen Endzustand erreicht (Erfolg / Fehler)
Verwenden Sie webhook. Übergeben Sie nicht die offizielle callback_url. callback_url ist für den internen Gebrauch reserviert und wird von Benutzern nicht akzeptiert.

Image-to-Video-Felder

Für Image-to-Video mit erstem / letztem Einzelbild Rollen explizit angeben. Nicht aus der Anzahl von image_urls ableiten.
string
URL des ersten EinzelbildesWenn angegeben, wird dieses Bild als Anfangsbild des Videos verwendet.
string
URL des letzten EinzelbildesWenn angegeben, wird dieses Bild als Endbild verwendet. Mit first_frame_image für die Steuerung von Erst- und Endbild kombinieren.

Multimodale Referenzfelder

string[]
Array von Referenzbild-URLs
Jedes Bild in image_urls wird als Referenzbild (reference_image) behandelt, unabhängig von der Anzahl. Sie werden nie automatisch anhand der Array-Länge dem ersten / ersten+letzten Einzelbild zugeordnet.
  • Anzahl: ≤ 9
string[]
Array von Referenzvideo-URLs
  • Anzahl: ≤ 3
  • Format und Grenzen: siehe „Eingabe-Medienlimits“ unten
string[]
Array von Referenzaudio-URLs
  • Anzahl: ≤ 3
  • Kann nicht allein verwendet werden; muss mit einem Referenzbild oder Referenzvideo kombiniert werden

Gemeinsames Bild-Array (optionale Form)

object[]
Rollenmarkiertes Bild-Array. Kann first_frame_image / last_frame_image / image_urls ersetzen. Jedes Element:Beispiel (erstes + letztes Einzelbild):
Beispiel (Referenzbild):

Regeln zum Seitenverhältnis

Zulässige konkrete Verhältnisse: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.

Eingabe-Medienlimits

Gesamtgröße des Request-Bodys ≤ 64 MB. Für große Dateien öffentliche URLs verwenden; kein Base64 verwenden.

Bilder

Video (nur multimodale Referenz)

Audio (nur multimodale Referenz)

Parameter-Einschränkungen

Verstöße werden mit 400 abgelehnt (sensibler Inhalt kann 422 zurückgeben) und werden nicht abgerechnet:

Antwort

integer
Statuscode der Antwort, 200 bei Erfolg
array
Datenarray der Antwort

Anfragebeispiele

Fall 1: Text-zu-Video

Fall 2: Bild-zu-Video — Erstes Einzelbild

Fall 3: Bild-zu-Video — Erstes + letztes Einzelbild

Fall 4: Multimodale Referenz-zu-Video

Fall 5: Erstes + letztes Einzelbild über image_with_roles

Aufgabenergebnisse abfragenDie Videogenerierung ist eine asynchrone Aufgabe, die nach der Übermittlung eine task_id zurückgibt. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um den Generierungsfortschritt und die Ergebnisse abzufragen.Empfohlenes Abfrageintervall: alle 5 ~ 10 Sekunden. Client-Timeout: 15 Minuten. Bei Erfolg ist result.videos[0].url die mp4-URL. Video-URLs laufen in etwa 24 Stunden ab — speichern Sie sie zeitnah. Fehlgeschlagene Aufgaben werden automatisch erstattet.