MiniMax H3 API

MiniMax H3 Text-zu-Video erzeugt einen Clip allein aus einem Prompt, ohne Bild und ohne Referenzsatz. Sie wählen eine Länge von 5 bis 15 ganzen Sekunden, eine Auflösung von 768p oder 2k und eines von sechs Seitenverhältnissen; der Ton entsteht im selben Durchgang wie das Bild. Das Prompt-Feld fasst bis zu 7.000 Zeichen – genug für eine vollständige Einstellungsbeschreibung statt einer Bildunterschrift.

Modus nach dem Ausgangsmaterial wählen

Sechs Bildformate, pro Anfrage gewählt

aspect_ratio akzeptiert 16:9 (Standard), 9:16, 1:1, 4:3, 3:4 und 21:9. Mit 21:9 entsteht ein anamorphotischer Letterbox-Rahmen; so wurde das veröffentlichte Beispiel noir-window erzeugt: rot pulsierendes Neon, Jalousieschatten und eine langsame Kopfdrehung, alles in einem Absatz für das breite Format geschrieben. Legen Sie das Format fest, bevor Sie schreiben, damit das Briefing das Motiv für genau diesen Rahmen platziert.

Ton im selben Briefing inszenieren

Audio wird mit dem Bild erzeugt und nicht nachträglich angelegt, deshalb gehört auch der Soundtrack in den Prompt: Raumton, Foley, Musik oder ein gesprochener Satz. Im Beispiel thunder-wheat-field kommt der Donner in derselben Datei wie die Blitze zurück und sitzt damit auf den Einschlägen, statt im Schnitt angelegt werden zu müssen.

768p und 2k, beide nativ

Beide Auflösungen sind native Ausgaben; 480p und 720p gibt es nicht, das Schema lehnt diese Werte ab. Dauer und Auflösung bestimmen beide den Preis. Üblich ist daher, in 768p zu entwerfen, bis Handlung und Bildausschnitt stimmen, und den gewünschten Take dann in 2k zu erzeugen. Der Endpunkt nimmt keinen Seed an, der 2k-Lauf ist also ein neuer Take desselben Briefings und keine schärfere Kopie des Entwurfs.

Eine Einstellung aus einer bloßen Idee beginnen

text-to-video ist der H3-Endpunkt, der keine Bildeingabe braucht. Das Beispiel curtain-silhouette zeigt die Art Briefing, die über mehrere Läufe am stabilsten bleibt: statische Kamera, ein hauchdünner Vorhang, dahinter eine warme Lampe und eine Silhouette, von der nur der Umriss lesbar ist. Je weniger ein Briefing offenlässt, desto näher liegen aufeinanderfolgende Takes beieinander.

Eine Licht- oder Timing-Idee testen

Licht, das sich über die Zeit verändert, wird vollständig im Prompt geschrieben. Das Briefing von thunder-wheat-field verlangt eine unterbrochene Enthüllung: Jeder Blitz zeichnet ein durchnässtes Hemd für einen Augenblick weiß und lässt es wieder im Dunkel versinken, über sechs Sekunden in 768p und 16:9. Solche kurzen Entwürfe zeigen, ob ein Effekt trägt, bevor Sie einen 2k-Lauf dafür ausgeben.

Eine Sequenz eröffnen, die anderswo weitergeht

H3 hat keinen Bearbeitungs-Endpunkt, und eine Anfrage endet spätestens nach 15 Sekunden. Für eine längere Szene erzeugen Sie hier die erste Einstellung und setzen sie mit MiniMax H3 Video-Verlängerung fort: Sie eröffnet die nächste Einstellung auf dem letzten Bild des freigegebenen Clips und liefert beide verbunden in einer Datei. Muss das Motiv exakt wie entworfen aussehen, wechseln Sie stattdessen zu image-to-video: Prosa überlässt Garderobe, Körper und Bildausschnitt dem Modell, und aufeinanderfolgende Läufe driften.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/h3/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "768p",
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "enable_prompt_expansion": false
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.