Introduzione
FLUX 3 Da immagine a video anima un’immagine statica con il modello video FLUX 3 di Black Forest Labs. Dagli un fotogramma iniziale e, se vuoi, uno finale; genera da 5 a 20 secondi di movimento con audio sincronizzato a 720p o 1080p.
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
L’immagine definisce l’aspetto
Persona, abiti e ambientazione arrivano dal fotogramma iniziale, quindi il prompt deve solo descrivere l’azione, la camera e il suono.
Fotogramma iniziale e finale
Con un’ultima immagine la clip passa dall’una all’altra. I fotogrammi vicini per luce e posizione si fondono in modo fluido; quelli molto distanti possono produrre uno stacco netto nel mezzo.
Il formato segue l’immagine
Se ometti le proporzioni, la clip mantiene il formato del fotogramma iniziale.
Si paga al secondo
Il prezzo segue durata e livello (prima la bozza, poi lo standard 720p, poi lo standard 1080p); un ultimo fotogramma e l’impostazione dell’audio non costano nulla in più.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. Descrivi cosa succede dopo l’immagine iniziale: l’azione, il movimento di camera e una riga Sound:. almeno 1 caratteri · al massimo 5000 caratteri |
image_url | Sì | Il fotogramma iniziale, caricato o collegato. Il soggetto mantiene il proprio aspetto da questa immagine. almeno 1 caratteri |
last_image_url | No | Fotogramma finale facoltativo. almeno 1 caratteri |
aspect_ratio | No | Uno tra 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 o 2:1. Omettilo per seguire l’immagine iniziale. |
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. Aggiungere un ultimo fotogramma non cambia il prezzo.
| Risoluzione | Qualità: Bozza | Qualità: Standard |
|---|---|---|
| $0.06 / secondo | $0.29 / secondo |
| $0.06 / secondo | $0.17 / secondo |
Casi d’uso
Dare vita ai ritratti
Un sorriso, una rotazione della testa, il vento tra i capelli, con il suono d’ambiente corrispondente.
Movimenti prima e dopo
Cambi di ora del giorno o di posa da un fotogramma iniziale a uno finale.
Immagini di prodotti e location
Un lento arco di camera attorno a un soggetto di cui hai già una foto.
Consigli avanzati
Descrivi il movimento, non l’immagine
L’immagine mostra già chi e dove; scrivi cosa cambia.
Tieni vicini i due fotogrammi
Luce e posizione simili danno un passaggio fluido; fotogrammi molto diversi tendono a essere uniti da uno stacco.
Non fare affidamento sulla formula dell’inquadratura unica
Chiedere un’unica inquadratura continua non lo garantisce, quindi controlla il risultato.
Aspettati piccole derive del volto sui movimenti lunghi
Il volto può cambiare leggermente durante ampie rotazioni della testa o quando le mani lo attraversano.
Fai l’anteprima in bozza
Prova il movimento in bozza prima di un rendering completo.
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/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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.


























