Skip to main content
POST
Modellwahl: MiniMax-H3-Max eignet sich für schnelle Text-zu-Video-, Start-/Endbild- und multimodale Referenzgenerierung mit 480P, 768P oder 1080P. Für 2K oder Zwischenbilder 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.
Start-/Endbild-Felder dürfen nicht mit Referenzmedien kombiniert werden. Referenzaudio benötigt mindestens ein Referenzbild oder -video. Ungültige Kombinationen liefern synchron HTTP 400; keine Aufgabe wird 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: 480P, 768P (Standard) oder 1080P.Bei 1080P müssen watermark und der Alias aigc_watermark entfallen, auch wenn der Wert false ist.
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
  • Multimodale Referenzen: optional, Standard adaptive; ein konkretes Seitenverhältnis ist ebenfalls möglich
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, last_frame_image oder image_urls.Höchstens ein Startbild und ein Endbild. Referenzbilder aus diesem Array und image_urls zusammen: maximal 9. Bildrollen für Start/Ende dürfen nicht mit Referenzbildrollen gemischt werden.
string[]
Array öffentlicher Referenzbild-URLs. Zusammen mit Referenzbildern in image_with_roles maximal 9 Bilder. Alle Bilder gelten als Referenzen, nie automatisch als Start-/Endbilder. Dafür first_frame_image oder die Rolle first_frame verwenden.
string[]
Array öffentlicher Referenzvideo-URLs; für ein Video auch video_url (string). Maximal 3 Clips, jeweils 2–15 Sekunden, Referenzvideos insgesamt höchstens 15 Sekunden.Die Referenzvideodauer wird bei Übermittlung zur Abrechnung ermittelt. Ist dies nicht möglich, wird synchron HTTP 400 zurückgegeben; keine Aufgabe wird erstellt oder berechnet.
string[]
Array öffentlicher Referenzaudio-URLs; für einen Clip auch audio_url (string). Maximal 3 Clips, jeweils 2–15 Sekunden, Referenzaudio insgesamt höchstens 15 Sekunden. Mindestens ein Referenzbild oder -video ist erforderlich; Audio allein ist nicht zulässig.
boolean
Standard:"false"
AIGC-Wasserzeichen hinzufügen. Alias: aigc_watermark.Wasserzeichen sind nur bei 480P / 768P unterstützt. Bei 1080P müssen watermark und der Alias aigc_watermark entfallen, auch wenn der Wert false ist.
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.

Parameterbeschränkungen

Diese ungültigen Parameter oder Kombinationen geben vor Aufgabenerstellung und Abrechnung HTTP 400 zurück: Jeder Referenzvideo- und Audioclip muss 2–15 Sekunden lang sein. Video- und Audiosummen werden getrennt berechnet und dürfen jeweils höchstens 15 Sekunden betragen. Zu lange Medien sind ungültig und müssen vorher gekürzt werden.
Bei 1080P müssen watermark und der Alias aigc_watermark entfallen, auch wenn der Wert false ist.
Für 2K, Zwischenbilder oder ein 4-Sekunden-Video verwenden Sie MiniMax-H3 und passen die Parameter an.

Grenzen für Eingabemedien

Der gesamte Anfragekörper darf höchstens 64 MB groß sein. Für Bilder, Videos und Audio öffentliche URLs verwenden, kein Base64.

Bilder

Referenzvideos

Referenzaudio

Referenzaudio benötigt ein Referenzbild oder -video. Video- und Audiosummen werden getrennt berechnet; jeweils höchstens 15 Sekunden. Unzulässige Eingabemedien können während der Generierung zum Fehlschlag führen; fehlgeschlagene Aufgaben werden automatisch erstattet.

Beispiele

Bild-zu-Video mit Startbild

Bild-zu-Video mit Start- und Endbild

1080P Text-zu-Video

Bei 1080P müssen watermark und der Alias aigc_watermark entfallen, auch wenn der Wert false ist.

Multimodale Referenzgenerierung

Jeder Referenzvideo- und Audioclip muss 2–15 Sekunden lang sein. Video- und Audiosummen werden getrennt berechnet und dürfen jeweils höchstens 15 Sekunden betragen. Zu lange Medien sind ungültig und müssen vorher gekürzt werden.

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

Die Gesamtkosten umfassen generiertes Video, zusätzliche Eingabebilder und Referenzvideo:
Start-, End- und Referenzbilder werden zusammengezählt. Erste 2 Bilder kostenlos, weitere einzeln berechnet. Referenzvideos insgesamt maximal 15 Sekunden. Alle Preise richten sich nach den Modellpreisen. Im 1080P-Beispiel mit 2 Referenzbildern und Referenzaudio sind Bilder und Audio 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