Introduzione
Kling 4.0 Image to video anima il tuo fotogramma iniziale in una clip da 3 a 30 secondi a 720p o 1080p. Aggiungi un fotogramma finale per fissare dove finisce, e fino a 8 fotogrammi intermedi, in ordine, per guidare il percorso tra i due. Il prompt è facoltativo; ogni clip torna con una colonna sonora stereo.
Scegli una modalità Kling 4.0 in base al materiale di partenza
| Cosa hai all’inizio | Modalità |
|---|---|
| una scena o uno script scritti | Kling 4.0 Text to video |
| un fotogramma iniziale, e facoltativamente un fotogramma finale e fotogrammi intermedi | Kling 4.0 Image to video (sei qui) |
| foto, clip o campioni vocali da cui fare il cast | Kling 4.0 Reference to video |
Caratteristiche principali
Primo fotogramma, fotogrammi intermedi, ultimo fotogramma
image_url imposta l’inizio, last_image_url la fine e keyframe_image_urls i momenti intermedi, nell’ordine in cui devono comparire. Nel nostro test un astronomo al telescopio (inizio), piegato sull’oculare (intermedio) e appoggiato alla ringhiera con le braccia incrociate (fine) è uscito come un unico movimento continuo di 3 secondi attraverso tutte e tre le pose.
La forma segue il tuo fotogramma
Lascia aspect_ratio su auto e la clip mantiene la forma del fotogramma iniziale; scegli 16:9, 9:16, 1:1 o 21:9 per cambiarla.
Il suono arriva insieme
Ogni clip ha una colonna sonora a due canali. Descrivi il suono nel prompt per guidarlo.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | No | Facoltativo. Descrivi cosa succede dopo il fotogramma iniziale - l’azione, la ripresa e il suono. almeno 1 caratteri |
image_url | Sì | Il fotogramma iniziale, JPEG o PNG. La clip parte da questa immagine. |
last_image_url | No | Fotogramma finale facoltativo. La clip finisce su questa immagine; mantieni lo stesso personaggio, il set e la posizione di macchina del fotogramma iniziale. |
keyframe_image_urls | No | Fotogrammi intermedi facoltativi, fino a 8, nell’ordine in cui devono comparire tra il fotogramma iniziale e quello finale. Non vengono citati nel prompt e non cambiano il prezzo. almeno 1 elementi · al massimo 8 elementi |
aspect_ratio | No | auto (predefinito) mantiene la forma del fotogramma iniziale; 16:9, 9:16, 1:1 o 21:9 la sostituiscono. Non cambia il prezzo. |
resolution | No | 720p o 1080p (predefinito 720p). 1080p costa di più al secondo. |
duration_seconds | No | Secondi interi, da 3 a 30 (predefinito 5). Determina il prezzo. |
Prezzi
Addebitato al secondo di output. 1080p costa di più al secondo rispetto a 720p. Ogni clip include una colonna sonora stereo senza costi extra. Una richiesta rifiutata o fallita non viene addebitata.
| Specifiche | Prezzo |
|---|---|
| $0.216 / secondo |
| $0.324 / secondo |
Casi d’uso
Dai vita a un’immagine ferma
Un ritratto, lo scatto di un prodotto o un fotogramma di una clip precedente: descrivi solo ciò che succede dopo, e l’aspetto, l’abbigliamento e l’ambientazione arrivano dalla tua immagine.
Dallo storyboard al movimento
Disegna o genera le pose chiave di un’inquadratura, caricale come fotogrammi iniziale, intermedi e finale, e il modello riempie il movimento tra di esse.
Continua una scena
Usa l’ultimo fotogramma di una clip precedente come fotogramma iniziale della successiva per mantenere personaggio e set coerenti tra le inquadrature.
Consigli avanzati
Mantieni coerenti i fotogrammi
Fotogramma iniziale, intermedi e finale dovrebbero condividere lo stesso personaggio, l’abbigliamento, il set e la posizione di macchina. Fotogrammi discordanti costringono a un taglio o a una morfatura.
Descrivi il movimento, non l’immagine
L’immagine mostra già com’è tutto. Spendi il prompt su azione, movimento di macchina e suono.
Meno fotogrammi intermedi, ma più chiari
Ogni fotogramma intermedio è un punto che la clip deve attraversare. Per una clip breve ne bastano uno o due; troppi in pochi secondi rendono il movimento frettoloso.
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": "kling/4.0/image-to-video",
"input": {
"aspect_ratio": "auto",
"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.










