Einführung
Text zu Video mit MiniMax H3 HighSpeed macht aus einem geschriebenen Prompt eine MP4-Datei von 4 bis 15 Sekunden in 768p, deren Ton im selben Durchgang entsteht. Eine Auflösung müssen Sie nicht wählen; pro Clip entscheiden Sie nur über Idee, Bildformat und Länge.
Modus nach Ausgangsmaterial wählen
| Was Sie haben | Modus |
|---|---|
| nur eine Idee | MiniMax H3 HighSpeed Text zu Video |
| ein Standbild zum Animieren, optional mit Endbild | MiniMax H3 HighSpeed Bild zu Video |
| Personen, Outfits, Orte, Bewegungsclips oder Stimmen | MiniMax H3 HighSpeed Referenz zu Video |
Wichtige Funktionen und Highlights
Ton und Dialog in einem Durchgang
Jeder Clip kommt mit Ton. Worte in doppelten Anführungszeichen spricht die benannte Figur, Atmosphäre und Musik folgen Ihrer Beschreibung, sodass eine kurze Szene keinen nachträglichen Tondurchgang braucht.
Sechs Seitenverhältnisse
Wählen Sie pro Anfrage 16:9, 9:16, 1:1, 4:3, 3:4 oder 21:9. Der Preis bleibt gleich, sodass ein Prompt eine breite Fassung für den Feed und eine hohe für Reels oder Shorts liefern kann.
Ein fester Preis
Bei $0.072 pro Sekunde kostet ein Clip von 6 Sekunden $0.432 und einer von 10 Sekunden $0.72. Mit nur einer Auflösung lassen sich die Kosten einer ganzen Tageswarteschlange vorab berechnen.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Pflicht. Erlaubt sind 1 bis 7.000 Zeichen, längere Eingaben werden abgelehnt. mindestens 1 Zeichen · höchstens 7000 Zeichen |
aspect_ratio | Nein | Bildformat: standardmäßig 16:9, alternativ 9:16, 1:1, 4:3, 3:4 oder 21:9. Hat keinen Einfluss auf den Preis. |
resolution | Nein |
|
duration_seconds | Nein | Eine ganze Zahl von 4 bis 15 (Standard 5); jede Sekunde wird zum 768p-Preis berechnet. Eine Anfrage über 4 Sekunden kam als Clip von 3,75 Sekunden zurück. |
Preis
Bezahlt wird jede Sekunde des fertigen Clips in 768p; den aktuellen Preis zeigt die Modellseite.
| Spezifikation | Preis |
|---|---|
| $0.072 / Sekunde |
Anwendungsfälle
Tägliche Social-Posts
Ein 9:16-Clip von 5 bis 8 Sekunden mit einer kurzen Dialogzeile und etwas Atmosphäre kann direkt in einen Beitrag. Behalten Sie den Schauplatz von Tag zu Tag bei und ändern Sie nur Handlung und Zeile.
Produkt- und Anzeigenvarianten
Schreiben Sie dieselbe Produktszene pro Prompt mit anderer Kamerabewegung, Stimmung oder Sprechzeile und veröffentlichen Sie die Aufnahmen, die am besten wirken. Jede ist eine fertige 768p-Datei.
Schnelle Lieferung für Kunden
Wenn ein Kunde oder ein Trend nicht warten will, genügen etwa 22 bis 35 Sekunden (unsere Testclips von 4 Sekunden), um mehrmals in einer Sitzung zu prüfen und nachzubessern.
Prompt-Leitfaden und Praxistipps
Die Szene in der richtigen Reihenfolge beschreiben
Nennen Sie, wer da ist, was die Person zuerst und danach tut, wo die Kamera steht, und ergänzen Sie eine Audio:-Zeile für den Ton. Eine klare Abfolge bewegt sich besser als eine Reihe von Adjektiven; wer das Licht benennt, etwa goldene Stunde oder Neon, legt die Stimmung schnell fest.
Dialog kurz halten
In einen Clip von 5 bis 8 Sekunden passen ein bis zwei Zeilen in Anführungszeichen. Nennen Sie zu jeder Zeile die sprechende Person und verteilen Sie eine längere Rede lieber auf mehrere Clips, statt sie hineinzuquetschen.
Die Länge an die Handlung anpassen
Eine einzelne Geste wirkt in 4 bis 6 Sekunden gut; für längere Clips fügen Sie einen zweiten Beat hinzu, damit die Szene in Bewegung bleibt. In unserem Test kam eine Anfrage über 4 Sekunden mit 3,75 Sekunden zurück.
Bezahlt wird jede Sekunde des fertigen Clips in 768p; den aktuellen Preis zeigt die Modellseite.
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-highspeed/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
}
}'
# 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.
