Skip to main content
POST
Modellwahl: Verwenden Sie MiniMax-H3-Max, wenn Geschwindigkeit im Vordergrund steht und Text-zu-Video oder Start-/Endbild-Steuerung genügt. Für 2K, Zwischenbilder, Referenzbilder, -videos oder -audio verwenden Sie MiniMax-H3.

Authentifizierung

string
erforderlich
Alle Endpunkte erfordern Bearer-Token-Authentifizierung. Den Schlüssel erhalten Sie auf der API-Key-Seite.

Das richtige Modell wählen

MiniMax-H3-Max unterstützt kein 2K und kann nicht als Quelle für Regeneration dienen.

Generierungsmodi

Die Felder der Anfrage bestimmen den Modus automatisch; senden Sie kein mode-Feld.
Dieses Modell unterstützt weder image_urls, video_urls und audio_urls noch image_with_roles[].role = "reference_image". Referenzmedien führen synchron zu HTTP 400; es wird keine Aufgabe erstellt oder berechnet.

Anfrageparameter

string
erforderlich
Fester Wert: MiniMax-H3-Max. Modell-IDs sind nicht groß-/kleinschreibungssensitiv; minimax-h3-max wird ebenfalls akzeptiert.
string
erforderlich
Nicht leere Videobeschreibung, in jedem Modus erforderlich. Maximal 7000 Zeichen.
integer
Standard:"5"
Videodauer in Sekunden: Ganzzahl von 5 bis 15, Standard 5. Vier Sekunden werden nicht unterstützt.
string
Standard:"768P"
Ausgabeauflösung: 768P (Standard) oder 480P.
2K, 1440P und 2048P werden nicht unterstützt. Ungültige Werte geben HTTP 400 zurück und werden nicht automatisch herabgestuft.
string
Ausgabe-Seitenverhältnis. Die Aliasfelder size und ratio werden ebenfalls akzeptiert.Für Text-zu-Video: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
  • T2V ohne Feld oder mit adaptive: Rückfall auf 16:9
  • I2V: wird durch das Eingabebild bestimmt; dieses Feld wird ignoriert
string
Öffentliche Bild-URL für das Startbild.
string
Öffentliche Bild-URL für das Endbild. Kann allein oder zusammen mit first_frame_image verwendet werden.
object[]
Rollenbasiertes Bildarray als Alternative zu first_frame_image und last_frame_image.Pro Rolle ist höchstens ein Bild zulässig; role darf nicht leer sein.
boolean
Standard:"false"
AIGC-Wasserzeichen hinzufügen. Alias: aigc_watermark.
string
Empfängt eine Benachrichtigung, wenn die Aufgabe erfolgreich oder fehlgeschlagen beendet wurde.
Verwenden Sie webhook statt MiniMax’ callback_url. Das Gateway reserviert callback_url für interne Zwecke.

Nicht unterstützte Parameter

Diese Werte geben vor Aufgabenerstellung und Abrechnung HTTP 400 zurück:
Für Referenzmedien, 2K, Zwischenbilder oder vier Sekunden verwenden Sie MiniMax-H3.

Bildbeschränkungen

Der gesamte Anfragekörper darf höchstens 64 MB groß sein. Verwenden Sie öffentliche URLs; Base64 wird nicht unterstützt.

Beispiele

Bild-zu-Video mit Startbild

Bild-zu-Video mit Start- und Endbild

Aufgabe abfragen

Die Übermittlung gibt eine task_id zurück. Fragen Sie den Aufgabenstatus alle 5–10 Sekunden ab; empfohlenes Client-Timeout: 15 Minuten.
Generierte Video-URLs laufen in der Regel nach etwa 24 Stunden ab. Laden Sie das Ergebnis rechtzeitig herunter.

Preise

Gesamtkosten = Sekundenpreis × Videodauer. Start- und Endbilder sind kostenlos. Bei Übermittlung wird der geschätzte Betrag reserviert. Fehlgeschlagene Aufgaben werden vollständig erstattet; maßgeblich ist cost in der Aufgabenantwort.

Fehler

Fehler während der Generierung liefern status = failed und error.message; die Kosten werden automatisch erstattet.

Response

integer
Antwortstatuscode; bei Erfolg 200
array
Übermittlungsergebnis mit anfänglichem Aufgabenstatus und Aufgaben-ID