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:

Anfrageparameter

string
erforderlich
Unterstützte Modelle:
  • MiniMax-Hailuo-2.3 – Hailuo 2.3
  • MiniMax-Hailuo-2.3-Fast – Hailuo 2.3 Fast (geringere Latenz)
MiniMax-Hailuo-2.3-Fast:
Für dieses Modell ist first_frame_image erforderlich.
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 (max. 2000 Zeichen)Beschreiben Sie Szenen, Aktionen und Stile detailliert für bessere Generierungsergebnisse. Unterstützt Kamerabewegungs-Befehle (siehe Abschnitt „Kamerabewegungs-Befehle” weiter unten).Beispiel: "A cute kitten running on the grass"
integer
Standard:"6"
Videodauer (Sekunden)Optionen:
  • 6 – 6-Sekunden-Video
  • 10 – 10-Sekunden-Video
Standard: 6
1080p-Einschränkung: Bei 1080p-Auflösung wird nur eine Dauer von 6 Sekunden unterstützt
string
Standard:"768p"
VideoauflösungOptionen:
  • 768p – Hohe Auflösung
  • 1080p – Full HD (nur 6 Sekunden Dauer)
Standard: 768p
string
Erstes Einzelbild des VideosZwei Formate werden unterstützt:
  • Öffentliche URL: https://example.com/start.jpg
  • Base64-codiert: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Wenn angegeben, wird dieses Bild als Anfangsbild des Videos verwendet
MiniMax-Hailuo-2.3-Fast:
Für dieses Modell ist first_frame_image erforderlich.
boolean
Standard:"true"
Soll der Prompt automatisch optimiert werden?Bei Aktivierung optimiert das System Ihren Prompt automatisch für bessere GenerierungsergebnisseStandard: true
boolean
Standard:"false"
Soll die Optimierungszeit verkürzt werden?Bei Aktivierung ist die Verarbeitung schneller, aber die Optimierungsqualität kann leicht beeinträchtigt seinStandard: false
boolean
Standard:"false"
Soll ein Wasserzeichen hinzugefügt werden?Standard: false

Auflösungs- und Dauerkombinationen

Kamerabewegungs-Befehle

Verwenden Sie die Syntax [Befehl] im prompt, um Kamerabewegungen zu steuern. 15 Befehle werden unterstützt: Anwendungsbeispiel:

Antwort

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

Anwendungsfälle

Fall 1: Schnelle Text-zu-Video-Generierung

Fall 2: Hochwertiges 1080p-Video

Fall 3: Bild-zu-Video mit erstem Einzelbild

Fall 4: Kamerabewegungs-Befehle

Fall 5: Schneller Vorverarbeitungsmodus

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.