Skip to main content
POST
Minimax H3 Text-to-Video

Autorisierungen

Authorization
string
header
erforderlich

##Alle Schnittstellen erfordern eine Authentifizierung mit Bearer Token##

API Key erhalten:

Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API Key zu erhalten

Fügen Sie ihn im Anfrage-Header hinzu:

Body

application/json
model
enum<string>
Standard:minimax-h3-text-to-video
erforderlich

Name des Videogenerierungsmodells

Verfügbare Optionen:
minimax-h3-text-to-video
Beispiel:

"minimax-h3-text-to-video"

prompt
string
erforderlich

Beschreibt das gewünschte Video.

Anforderungen an den Prompt:

  • Erforderlich und darf nicht leer sein
  • Chinesisch und Englisch werden unterstützt
  • Maximal 7000 Zeichen (Chinesisch und Englisch werden jeweils nach Zeichen gezählt)
  • Bei zu langen Prompts kann das Modell Details ignorieren

Eingabebeschränkungen:

  • Dieses Modell erzeugt Videos ausschließlich aus Text
  • image_start, image_end, image_urls, video_urls und audio_urls werden nicht unterstützt
  • Die Angabe eines dieser Medienfelder führt zu einem Parameterfehler
Required string length: 1 - 7000
Beispiel:

"Epischer Weltraumoper-Kinotrailer: Eine Kapitänin steht allein vor einem riesigen Beobachtungsfenster, während sich draußen die letzte Flotte sammelt. Die Flotte springt in einem blendenden Lichtblitz davon, die Brücke bebt; als das Licht erlischt, bleibt sie allein im stillen Weltraum zurück. Filmische Beleuchtung, langsame Kamerafahrt, großartige und zugleich zurückhaltende Stimmung."

duration
integer
Standard:4

Dauer des Ausgabevideos in Sekunden. Standardwert: 4 Sekunden.

Wertebereich:

  • Nur Ganzzahlen von 4 bis einschließlich 15
  • Dezimalzahlen, numerische Zeichenketten, auto und -1 werden nicht unterstützt
  • Die Ausgabedauer wirkt sich direkt auf die Abrechnung aus
Erforderlicher Bereich: 4 <= x <= 15
Beispiel:

4

quality
enum<string>
Standard:768p

Auflösung des Ausgabevideos. Standardwert: 768p.

Verfügbare Werte:

  • 768p: Standardwert
  • 2k

Hinweise:

  • Ohne diesen Parameter wird in 768p ausgegeben; für 2K muss quality="2k" explizit gesendet werden
  • Bitrate, Bildrate sowie Video- und Audiocodec werden von der Plattform festgelegt und sind nicht konfigurierbar
Verfügbare Optionen:
768p,
2k
Beispiel:

"768p"

aspect_ratio
enum<string>
Standard:16:9

Seitenverhältnis des Ausgabevideos. Standardwert: 16:9.

Verfügbare Werte:

  • 16:9: Querformat
  • 21:9: Ultra-Breitbild
  • 4:3: Standard-Querformat
  • 1:1: Quadrat
  • 3:4: Standard-Hochformat
  • 9:16: Hochformat
Verfügbare Optionen:
16:9,
21:9,
4:3,
1:1,
3:4,
9:16
Beispiel:

"16:9"

callback_url
string<uri>

HTTPS-Callback-URL nach Aufgabenabschluss

Callback-Zeitpunkte:

  • Wird bei Aufgabenabschluss (completed) oder Fehler (failed) ausgelöst
  • Wird nach Bestätigung der Abrechnung gesendet

Sicherheitseinschränkungen:

  • Nur HTTPS-Protokoll unterstützt
  • Callbacks an interne IP-Adressen sind verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x usw.)
  • URL-Länge maximal 2048 Zeichen

Callback-Mechanismus:

  • Timeout: 10 Sekunden
  • Maximal 3 Wiederholungsversuche nach Fehler (jeweils nach 1/2/4 Sekunden)
  • Das Format des Callback-Antwortkörpers entspricht dem Rückgabeformat der Aufgabenabfrage-Schnittstelle
  • Ein 2xx-Statuscode gilt als Erfolg, andere Statuscodes lösen Wiederholungsversuche aus
Pattern: ^https://
Beispiel:

"https://your-domain.com/webhooks/video-task-completed"

Antwort

Videogenerierungsaufgabe erfolgreich erstellt

created
integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1761313744

id
string

Aufgaben-ID

Beispiel:

"task-unified-1774857405-abc123"

model
string

Tatsächlich verwendeter Modellname

Beispiel:

"minimax-h3-text-to-video"

object
enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:
video.generation.task
progress
integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100
Beispiel:

0

status
enum<string>

Aufgabenstatus

Verfügbare Optionen:
pending,
processing,
completed,
failed
Beispiel:

"pending"

task_info
object

Detaillierte Informationen zur Videoaufgabe

type
enum<string>

Ausgabetyp der Aufgabe

Verfügbare Optionen:
text,
image,
audio,
video
Beispiel:

"video"

usage
object

Nutzungs- und Abrechnungsinformationen