Introduzione
FLUX 3 Da testo a video è il modello video di Black Forest Labs, con API disponibile dal 4 agosto 2026. Trasforma un prompt scritto in una clip da 5 a 20 secondi con audio sincronizzato, a 720p o 1080p in sette formati, e ha un livello bozza veloce per controllare un’inquadratura al prezzo più basso.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| un brief scritto | FLUX 3 Da testo a video |
| un’immagine da animare, con ultimo fotogramma facoltativo | FLUX 3 Da immagine a video |
| una clip da continuare | FLUX 3 Estensione video |
| una clip da ingrandire | FLUX 3 Upscale video |
Caratteristiche principali
Immagine e audio insieme
L’audio viene generato nella stessa passata dell’immagine. I dialoghi tra virgolette corrispondevano parola per parola ai nostri prompt e una riga Sound: orienta i rumori d’ambiente come pioggia o passi. Disattivare l’audio costa uguale.
Livello bozza
La bozza è un’anteprima rapida e più economica, sempre a 720p. I dettagli sono più morbidi dello standard, ma bastano per giudicare inquadratura, azione e atmosfera prima del rendering completo.
Si paga al secondo
Il prezzo segue durata e livello: la bozza è la più economica, poi lo standard 720p, poi lo standard 1080p. Proporzioni e impostazione dell’audio non lo cambiano, e le richieste rifiutate o fallite non vengono addebitate.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. Descrivi soggetto, azione, camera, luce e suono; aggiungi una riga Sound: per i rumori d’ambiente e metti le parole pronunciate tra virgolette. almeno 1 caratteri · al massimo 5000 caratteri |
aspect_ratio | No | Uno tra 16:9 (predefinito), 9:16, 1:1, 4:3, 3:4, 21:9 o 2:1. Il formato non cambia il prezzo. |
quality | No | standard (predefinito) rende alla risoluzione che scegli; draft è un’anteprima rapida e più economica, sempre a 720p ( |
resolution | No | 720p (predefinito) o 1080p. Il 1080p costa di più. |
duration_seconds | No | Durata in secondi interi, da 5 a 20; 5 per impostazione predefinita. Si paga al secondo, quindi insieme al livello determina il prezzo. |
generate_audio | No | Genera l’audio sincronizzato insieme all’immagine. Attivo per impostazione predefinita; disattivandolo ottieni un file muto. Predefinito: |
Prezzi
Si paga al secondo di video, in base al livello: la bozza è la più economica, poi lo standard 720p, poi lo standard 1080p. Audio attivo o disattivo costa uguale e le proporzioni non cambiano il prezzo. Le richieste rifiutate o fallite non vengono addebitate.
| Risoluzione | Qualità: Bozza | Qualità: Standard |
|---|---|---|
| $0.06 / secondo | $0.29 / secondo |
| $0.06 / secondo | $0.17 / secondo |
Casi d’uso
Scene di dialogo e atmosfera
Un personaggio, una battuta, un suono d’ambiente e un lento movimento di camera.
Storyboard
Fai l’anteprima di ogni inquadratura in bozza, poi rifai quelle che tieni.
Clip social e verticali
9:16 e 1:1 sono già inclusi, mentre 21:9 e 2:1 coprono i formati cinematografici panoramici.
Consigli avanzati
Scrivilo come un’inquadratura
Soggetto e abbigliamento, ambientazione, azione, movimento di camera, luce, poi una riga finale che inizia con Sound:.
Metti il dialogo tra virgolette
Scrivi le parole pronunciate tra virgolette, nella lingua in cui vuoi sentirle.
Una sola azione per clip
Una singola azione chiara e un solo movimento di camera reggono meglio; grandi cambi di luce o di luogo possono spingere il modello a tagliare o sfumare.
Prima la bozza
Metti a punto l’inquadratura in bozza, poi lancia lo stesso prompt in standard.
Mantieni realistiche le aspettative sui contenuti
Vengono renderizzati solo gli stili di livello Lieve; tutto ciò che è più forte viene rifiutato e non addebitato.
Avvio rapido dell’API
# 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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.


























