Einführung
MiniMax H3 Max Text-zu-Video macht aus einem geschriebenen Prompt einen Clip von 5 bis 15 ganzen Sekunden in 480p oder 768p; Atmo, Foley und Musik entstehen im selben Durchgang. MiniMax beschreibt H3 Max als die Variante von H3 für schnelle Generierung. Zwei Standardwerte sind vor dem ersten Lauf wichtig: Das Seitenverhältnis steht auf 1:1 und die Dauer auf 8 Sekunden. Setzen Sie beide ausdrücklich, wenn Sie ein Lieferformat im Kopf haben.
Modus nach dem Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| ein freigegebenes Startbild | MiniMax H3 Max Bild-zu-Video |
| eine geschriebene Szene oder ein Skript | MiniMax H3 Max Text-zu-Video |
Wichtige Funktionen und Highlights
Sechs Bildformate, standardmäßig quadratisch
aspect_ratio akzeptiert 21:9, 16:9, 4:3, 1:1, 3:4 und 9:16 und steht standardmäßig auf 1:1 – ein Breitbild-Briefing ohne dieses Feld kommt quadratisch zurück. Das Beispiel snow-train-window-hands ist für 21:9 gebaut: ein Zug, der die volle Bildbreite durchquert, während sich zwei Hände auf beiden Seiten der Abteilscheibe treffen – eine Komposition, die einen quadratischeren Zuschnitt nicht übersteht.
480p für Entwürfe, 768p für den finalen Take
resolution nimmt 480p oder 768p an, Standard ist 768p. Optionen für 720p, 1080p oder 4K gibt es nicht, und das Schema lehnt diese Werte ab, bevor die Anfrage in die Warteschlange kommt. 480p kostet pro Sekunde weniger und eignet sich damit, um Wortlaut, Dauer und Bildausschnitt auszuprobieren; den Take, den Sie behalten, rendern Sie in 768p.
Prompt-Erweiterung nur auf Wunsch
enable_prompt_expansion ist standardmäßig aus, der Prompt wird also so umgesetzt, wie er dasteht. Eingeschaltet erweitert MiniMax ein kurzes Briefing zuerst zu einer ausführlicheren Beschreibung von Einstellung, Ton und Musik – dann können Details auftauchen, die Sie nicht geschrieben haben, und die Anfrage wird zum Tarif für Prompt-Erweiterung abgerechnet. Die veröffentlichten Beispiele begegnen dem mit Genauigkeit: Der Prompt von night-train-beckon nennt grünen Samt, poliertes Messing, Wurzelnussholz, eine einzelne Leselampe und die genaue Geste, der die Kamera folgen soll.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Wie einen Shot schreiben: Motiv, Bewegung, Kamera, Licht, Ton – in der Reihenfolge, in der sie passieren. mindestens 1 Zeichen · höchstens 7000 Zeichen |
aspect_ratio | Nein | Steht auf 1:1. Setzen Sie 21:9 für anamorph, 9:16 für vertikal. |
duration_seconds | Nein | Ganze Sekunden, 5 bis 15. Ohne Angabe bekommen Sie 8, nicht 5. |
resolution | Nein | 480p oder 768p, Standard ist 768p. Beide werden nativ gerendert; 480p kostet pro Sekunde weniger. |
enable_prompt_expansion | Nein | Standardmäßig aus – der Prompt wird genau so verwendet, wie er dasteht. Standardwert: |
Preis
| Spezifikation | Preis |
|---|---|
| $0.05 / Sekunde |
| $0.08 / Sekunde |
Anwendungsfälle
Mode- und Kampagnenbewegung
Das Beispiel silver-corridor ist eine Kampagnen-Einstellung aus einem einzigen Absatz: ein flüssig-silbernes Kleid, das hartes Kantenlicht fängt, Haar in einer Windmaschine und am Ende ein Blick direkt in die Linse, in 21:9 über fünf Sekunden, mit tiefem Synth-Drone im Ton. Stoffbewegung, Licht und der abschließende Blick sind geschrieben; nichts davon wurde als Bild geliefert.
Epochen-Looks beim Namen genannt
Filmmaterial-Charakter lässt sich direkt anfordern. Das Beispiel roller-rink verlangt einen 1970er-Look mit starker Halation, verblassten Farben, dickem Korn und leichtem Bildstandswackeln und bringt eine zweiteilige Handlung in fünf Sekunden unter: eine langsame Runde über die Bahn, dann rückwärts mit ausgebreiteten Armen auf die Kamera zu.
Material- und Lichtstudien
Szenen, in denen mehrere Oberflächen auf bewegtes Licht reagieren, eignen sich für ein geschriebenes Briefing. In night-train-beckon ziehen Bahnsteiglichter Lichtbalken über Gesicht, Satin und Beine, während die Kamera mit extrem geringer Schärfentiefe heranfährt. Prüfen Sie mit einem solchen Briefing, ob eine Lichtidee trägt, bevor Sie Anfangsbilder für image-to-video bauen.
Prompt-Leitfaden und Praxistipps
Die Einstellung chronologisch schreiben
Führen Sie Motiv, Bewegung, Kamera, Licht und Ton in der Reihenfolge auf, in der sie geschehen. Der Prompt von silver-corridor geht die Einstellung vom ersten Schritt bis zum letzten Blick durch, ergänzt dann die Bildanmutung („anamorphic 2.39:1, deep blacks, glossy specular highlights“) und schließt mit dem Ton („low synth drone“).
Grenzen ebenso benennen wie die Handlung
Wenn Sie die Erweiterung einschalten, schreiben Sie auf, was feststehen muss, nicht nur, was passieren soll. Der Prompt von night-train-beckon endet mit ausdrücklichen Vorgaben: Nachthemd und Strümpfe bleiben durchgehend an, und es gibt keinen Text, kein Logo und keine weitere Person im Bild. Prosa überlässt Garderobe, Körper und Bildausschnitt dem Modell; ohne diese Angaben driften aufeinanderfolgende Läufe.
Für ein wörtliches Ergebnis zu image-to-video wechseln
Trifft ein Take die Idee, aber das Motiv nicht genau so wie entworfen, erzeugen oder wählen Sie ein Still und wechseln zu image-to-video: Einem Anfangsbild wird weit genauer gefolgt als derselben Beschreibung im Prompt. Setzen Sie auch die Dauer bewusst, denn ohne Angabe laufen 8 Sekunden, nicht 5.
API-Schnellstart
# 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-max/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "1:1",
"duration_seconds": 8,
"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.
