Introduzione
LTX 2.5 Immagine in video anima un fotogramma iniziale fornito da te per 5-20 secondi interi, a 720p, 1080p, 2K o 4K. image_url e prompt sono obbligatori; last_image_url aggiunge un fotogramma finale facoltativo, e duration_seconds, resolution e seed funzionano come in Testo in video. Il campo aspect_ratio non esiste: il fotogramma iniziale fissa soggetto e composizione e determina il formato dell’output. Le clip tornano con una colonna sonora generata e i task girano in modo asincrono. Carica solo immagini che sei autorizzato a usare; l’uso del risultato è una tua responsabilità.
Scegli il metodo in base al materiale di partenza
| Materiale di partenza | Metodo |
|---|---|
| Un brief scritto definisce scena, azione, camera e, quando serve, suono. | LTX 2.5 Testo in video |
| Un’immagine iniziale approvata fissa soggetto e composizione; l’istruzione dirige il movimento successivo. | LTX 2.5 Immagine in video |
Caratteristiche principali
Il fotogramma iniziale viene seguito da vicino
Identità, costumi, set e luce arrivano da image_url, e quel fotogramma viene seguito da vicino. È la strada affidabile per un risultato letterale: un fotogramma iniziale senza censura torna letterale anziché ammorbidito. Dato che l’immagine porta già il look, il prompt deve descrivere solo ciò che cambia dopo.
Un fotogramma facoltativo per il punto d’arrivo
last_image_url fissa la composizione finale ed è valido solo insieme a image_url. Vincola la fine, non il percorso: il movimento tra i due fotogrammi resta generato e, su una clip lunga, la parte centrale può allontanarsi parecchio. Due fotogrammi in disaccordo su luce o costumi producono una negoziazione visibile tra loro, quindi preparali come una coppia continua.
Stessa durata, risoluzione e audio dell’endpoint testuale
duration_seconds va da 5 a 20 secondi interi, e le clip più lunghe si allontanano di più da un fotogramma finale fornito. resolution offre 720p (default), 1080p, 2k (circa 2560 px di larghezza) e 4k. L’output include una traccia audio generata senza un campo per disattivarla; metti in conto di silenziarla o sostituirla in montaggio quando ti serve il tuo mix.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio. Descrivi che cosa cambia dopo il fotogramma – azione, camera, luce – non il fotogramma stesso. almeno 1 caratteri |
image_url | Sì | Il fotogramma di apertura. Fissa soggetto e composizione e determina la forma dell’uscita. |
last_image_url | No | Fotogramma di chiusura facoltativo, valido solo insieme a |
resolution | No | 720p, 1080p, 2k o 4k. Il 2k esce largo circa 2560 px. |
duration_seconds | No | Secondi interi, da 5 a 20. I clip più lunghi si allontanano di più da un fotogramma di chiusura fornito. |
seed | No | Tienilo fermo quando alzi la risoluzione, così è cambiata una sola variabile. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.09 / secondo |
| $0.13 / secondo |
| $0.19 / secondo |
| $0.30 / secondo |
Casi d’uso
Un cambio d’ora tra due fotogrammi approvati
Nell’esempio beach-to-bonfire, image_url mostra una coppia in spiaggia al tramonto e last_image_url gli stessi due di notte, avvolti in una coperta accanto a un falò. La richiesta dura 10 secondi a 1080p, e il prompt descrive il passaggio invece della destinazione: il sole che scende e la luce del fuoco che prende il sopravvento. Fissare la fine lascia al modello il compito di inventare la parte centrale senza superare un fotogramma già approvato.
Da una tavola dello storyboard all’altra, per il montaggio
Quando un’inquadratura deve partire da una tavola dello storyboard e chiudersi su un’altra, invia entrambe come image_url e last_image_url. La composizione in uscita si raccorda allora con lo stacco successivo, ed è questo che rende una clip generata utilizzabile in una timeline e non solo come pezzo isolato.
Movimento per un’immagine finita
Il fotogramma di candlelit-tub contiene già le candele, lo smalto e la seta smeraldo bagnata, quindi il prompt copre solo il cambiamento: scivolare nell’acqua, passare le mani tra i capelli fradici, aprire gli occhi verso la camera. L’esempio deco-pool-backfall è invece un momento fisico: una caduta all’indietro in acqua, bolle che salgono e riflessi che scorrono sulle colonne mentre la camera affonda con lei.
Consigli avanzati
Descrivi ciò che cambia, non ciò che c’è già
Tutto quello che si vede nel fotogramma iniziale lo stabilisce l’immagine. Usa il prompt per dire chi si muove, in che direzione e con che ritmo, poi la camera e i cambi di luce. Il prompt di candlelit-tub parte dalla prima azione ("She pushes up off the rim of the tub") e chiude con "Slow drift-in, warm candle light only".
Indica l’arrivo quando invii un fotogramma finale
Con last_image_url, scrivi nel prompt che l’inquadratura termina sul fotogramma finale fornito e descrivi cosa succede lungo il percorso. Il brief del falò fa proprio questo: "Begin on the two of them on the beach at sunset and end on the supplied final frame". Allinea soggetto, costumi e luce tra le due immagini prima ancora di scrivere.
Commisura la durata alla distanza da percorrere
Gli esempi con una sola azione durano 5 secondi; la transizione dal tramonto alla notte ne usa 10. Parti da una clip breve e verifica soggetto, contorni, luce e continuità della camera sull’intero output prima di allungarla. Scorri fotogramma per fotogramma le riprese con l’acqua, come l’esempio della piscina, perché è lì che un’immagine animata tende a sfaldarsi.
Dirigi il suono e blocca il seed
Poiché l’audio viene sempre generato, scrivi il suono nel prompt: il brief della piscina chiede "no music, only muffled underwater tone". Quando il movimento funziona, lascia invariati seed e prompt e alza solo resolution. Il seed rende i passaggi confrontabili, non identici fotogramma per fotogramma, quindi ricontrolla il render finale a piena risoluzione.
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": "lightricks/ltx-2.5/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",
"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.
