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
  • Empfohlen sind höchstens 500 chinesische Zeichen oder 1000 englische Wörter; 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
Minimum string length: 1
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:5

Dauer des Ausgabevideos in Sekunden. Standardwert: 5 Sekunden.

Wertebereich:

  • Nur Ganzzahlen von 5 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: 5 <= x <= 15
Beispiel:

5

quality
enum<string>
Standard:2k

Auflösung des Ausgabevideos. Standardwert: 2k.

Verfügbarer Wert:

  • 2k: derzeit die einzige unterstützte Auflösung

Hinweise:

  • 768p ist noch nicht verfügbar und führt zu einem Parameterfehler
  • Bitrate, Bildrate sowie Video- und Audiocodec werden von der Plattform festgelegt und sind nicht konfigurierbar
Verfügbare Optionen:
2k
Beispiel:

"2k"

aspect_ratio
enum<string>
Standard:adaptive

Seitenverhältnis des Ausgabevideos. Standardwert: adaptive.

Verfügbare Werte:

  • adaptive: Das Modell wählt anhand des Prompts ein geeignetes Seitenverhältnis
  • 21:9: Ultra-Breitbild
  • 16:9: Querformat
  • 4:3: Standard-Querformat
  • 1:1: Quadrat
  • 3:4: Standard-Hochformat
  • 9:16: Hochformat
Verfügbare Optionen:
adaptive,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
Beispiel:

"adaptive"

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