MiniMax-H3
MiniMax-H3-Max Videogenerierung
- Schnelle Version von MiniMax Video Generation V2 mit asynchroner Aufgabenübermittlung
- Unterstützt Text-zu-Video und Bild-zu-Video mit Start-, End- oder Start-und-Endbild
- Unterstützt 768P / 480P und 5 bis 15 Sekunden lange Videos mit Ton
- Keine Unterstützung für 2K, Zwischenbilder oder multimodale Referenzgenerierung
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
Generierungsmodi
Die Felder der Anfrage bestimmen den Modus automatisch; senden Sie keinmode-Feld.
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.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 auf16: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: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 einetask_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