Einführung
FLUX 3 Bild-zu-Video animiert ein Standbild mit dem Videomodell FLUX 3 von Black Forest Labs. Geben Sie einen Anfangs-Frame und, wenn Sie möchten, einen Schluss-Frame vor; das Modell erzeugt 5 bis 20 Sekunden Bewegung mit synchronem Ton in 720p oder 1080p.
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
Das Bild bestimmt den Look
Person, Outfit und Umgebung stammen aus dem Anfangs-Frame, der Prompt muss also nur Handlung, Kamera und Ton beschreiben.
Anfangs- und Schluss-Frame
Mit einem letzten Bild bewegt sich der Clip von einem zum anderen. Frames mit ähnlichem Licht und ähnlicher Position gehen sanft ineinander über; weit auseinanderliegende Frames können mitten im Clip einen harten Schnitt erzeugen.
Das Format folgt dem Bild
Lassen Sie das Seitenverhältnis weg, und der Clip behält das Format des Anfangs-Frames.
Abrechnung je Sekunde
Der Preis folgt Länge und Stufe (Draft am günstigsten, dann Standard 720p, dann Standard 1080p); ein letzter Frame und die Tonoption kosten nichts extra.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Bis zu 5.000 Zeichen. Beschreiben Sie, was nach dem Anfangsbild geschieht: die Handlung, die Kamerabewegung und eine Sound:-Zeile. mindestens 1 Zeichen · höchstens 5000 Zeichen |
image_url | Ja | Der Anfangs-Frame, hochgeladen oder verlinkt. Das Motiv behält sein Aussehen aus diesem Bild. mindestens 1 Zeichen |
last_image_url | Nein | Optionaler Schluss-Frame. mindestens 1 Zeichen |
aspect_ratio | Nein | Eines von 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 oder 2:1. Lassen Sie es weg, um dem Anfangsbild zu folgen. |
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. Ein letzter Frame ändert den Preis nicht.
| Auflösung | Qualität: Entwurf | Qualität: Standard |
|---|---|---|
| $0.06 / Sekunde | $0.29 / Sekunde |
| $0.06 / Sekunde | $0.17 / Sekunde |
Anwendungsfälle
Porträts zum Leben erwecken
Ein Lächeln, eine Kopfdrehung, Wind im Haar, mit passendem Raumklang.
Vorher-nachher-Bewegungen
Tageszeitwechsel oder ein Positionswechsel von einem Start- zu einem End-Frame.
Produkt- und Ortsbilder
Ein langsamer Kamerabogen um ein Motiv, von dem Sie bereits ein Bild haben.
Prompt-Leitfaden und Praxistipps
Beschreiben Sie Bewegung, nicht das Bild
Das Bild zeigt bereits, wer und wo; schreiben Sie, was sich ändert.
Halten Sie die beiden Frames nah beieinander
Ähnliches Licht und ähnliche Position ergeben eine fließende Bewegung; sehr verschiedene Frames werden oft durch einen Schnitt verbunden.
Verlassen Sie sich nicht auf die Formulierung „eine Einstellung“
Die Bitte um eine durchgehende Einstellung garantiert sie nicht, prüfen Sie das Ergebnis also.
Rechnen Sie bei langen Bewegungen mit leichter Gesichtsabweichung
Das Gesicht kann sich bei großen Kopfdrehungen oder wenn Hände es verdecken leicht verändern.
Vorab im Draft ansehen
Testen Sie die Bewegung im Draft, bevor Sie voll rendern.
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/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"resolution": "720p"
}
}'
# 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.


























