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.
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Videoauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
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ösungOptionen:
  • 2K (Standard)
  • 768P
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.