Einführung
FLUX 3 Text-zu-Video ist das Videomodell von Black Forest Labs; die API öffnet am 4. August 2026. Es macht aus einem geschriebenen Prompt einen Clip von 5 bis 20 Sekunden mit synchronem Ton, in 720p oder 1080p und sieben Formaten, und hat eine schnelle Draft-Stufe, um eine Einstellung zum niedrigsten Preis zu prüfen.
Den Modus nach dem Ausgangsmaterial wählen
| Was Sie haben | Modus |
|---|---|
| ein geschriebenes Briefing | FLUX 3 Text-zu-Video |
| ein Standbild zum Animieren, optional mit letztem Frame | FLUX 3 Bild-zu-Video |
| ein Clip zum Fortsetzen | FLUX 3 Video-Erweiterung |
| ein Clip zum Vergrößern | FLUX 3 Video-Upscale |
Wichtige Funktionen und Highlights
Bild und Ton zusammen
Der Ton entsteht im selben Durchlauf wie das Bild. Zitierte Dialoge entsprachen unseren Prompts wortgetreu, und eine Sound:-Zeile steuert Umgebungsgeräusche wie Regen oder Schritte. Ausgeschalteter Ton kostet gleich viel.
Draft-Stufe
Draft ist eine schnelle, günstigere Vorschau, immer in 720p. Die Details sind weicher als im Standard, reichen aber, um Bildausschnitt, Handlung und Stimmung vor dem vollen Rendering zu beurteilen.
Abrechnung je Sekunde
Der Preis folgt Länge und Stufe: Draft ist am günstigsten, dann Standard 720p, dann Standard 1080p. Seitenverhältnis und Tonoption ändern ihn nicht, und abgelehnte oder fehlgeschlagene Anfragen werden nicht berechnet.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Bis zu 5.000 Zeichen. mindestens 1 Zeichen · höchstens 5000 Zeichen |
aspect_ratio | Nein | Eines von 16:9 (Standard), 9:16, 1:1, 4:3, 3:4, 21:9 oder 2:1. Das Format ändert den Preis nicht. |
quality | Nein | standard (Standard) rendert in der gewählten Auflösung; draft ist eine schnelle, günstigere Vorschau, die immer in 720p ( |
resolution | Nein | 720p (Standard) oder 1080p. 1080p kostet mehr. |
duration_seconds | Nein | Länge in ganzen Sekunden, 5 bis 20; standardmäßig 5. Die Abrechnung erfolgt je Sekunde, die Länge bestimmt also zusammen mit der Stufe den Preis. |
generate_audio | Nein | Erzeugt synchronen Ton zum Bild. Standardmäßig an; aus ergibt eine stumme Datei. Standardwert: |
Preis
Abrechnung je Sekunde Video nach Stufe: Draft ist am günstigsten, dann Standard 720p, dann Standard 1080p. Ton an oder aus kostet gleich viel, und das Seitenverhältnis ändert den Preis nicht. Abgelehnte und fehlgeschlagene Anfragen werden nicht berechnet.
| Auflösung | Qualität: Entwurf | Qualität: Standard |
|---|---|---|
| $0.06 / Sekunde | $0.29 / Sekunde |
| $0.06 / Sekunde | $0.17 / Sekunde |
Anwendungsfälle
Dialog- und Stimmungsszenen
Eine Figur, ein Satz, ein Raumklang und eine langsame Kamerabewegung.
Storyboards
Sehen Sie jede Einstellung im Draft vorab an und rendern Sie die behaltenen neu.
Social- und Hochformat-Clips
9:16 und 1:1 sind eingebaut, 21:9 und 2:1 decken breite, kinoartige Bilder ab.
Prompt-Leitfaden und Praxistipps
Schreiben Sie wie eine Einstellung
Motiv und Kleidung, Umgebung, Handlung, Kamerabewegung, Licht, dann eine letzte Zeile, die mit Sound: beginnt.
Dialog in Anführungszeichen
Setzen Sie gesprochene Worte in Anführungszeichen, in der Sprache, in der Sie sie hören wollen.
Eine Handlung pro Clip
Eine einzige klare Handlung samt Kamerabewegung hält am besten zusammen; große Wechsel von Licht oder Ort können das Modell zu einem Schnitt oder einer Überblendung verleiten.
Zuerst im Draft
Klären Sie den Bildausschnitt im Draft und lassen Sie denselben Prompt dann in Standard laufen.
Erwartungen beim Inhalt
Nur Looks der Stufe Mild werden gerendert; alles Stärkere wird abgelehnt und nicht berechnet.
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": "black-forest-labs/flux-3/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"resolution": "720p",
"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.


























