Introduzione
Kling 3.0 Immagine in video prende un fotogramma iniziale (image_url) e un prompt che descrive cosa succede dopo, e restituisce da 3 a 15 secondi a 720p, 1080p o 4K. Imposta last_image_url per fissare anche un fotogramma finale, così la clip deve arrivare da qualche parte di specifico invece di limitarsi a iniziare da qualche parte. Attiva generate_audio per dialogo e ambiente generati con l'immagine.
Scegli una modalità di Kling 3.0 in base al materiale di partenza
| Cosa hai all'inizio | Modalità |
|---|---|
| una scena o sceneggiatura scritta | Kling 3.0 Testo in video |
| un fotogramma iniziale, e facoltativamente uno finale | Kling 3.0 Immagine in video (sei qui) |
| una foto del personaggio e una clip guida | Kling 3.0 Motion Control |
Caratteristiche principali
Un fotogramma iniziale e, se lo imposti, uno finale
La clip inizia sulla tua immagine esattamente com'è. Aggiungi last_image_url e Kling lavora verso quel fotogramma invece che verso un finale aperto: nel nostro test di una camminata su un molo nebbioso, l'ultimo fotogramma della clip corrispondeva quasi esattamente all'immagine finale, sciarpa rossa compresa.
Il fotogramma decide l'aspetto, il prompt decide il movimento
Descrivi solo l'azione, la camera e il suono, non il guardaroba o l'ambientazione, che il fotogramma iniziale già fissa. Il nostro esempio forecourt-lightning non ridescrive mai la donna o la stazione di servizio dal suo fotogramma; aggiunge solo il fulmine, la sua camminata nella pioggia e il tuono.
Il formato segue il fotogramma
Non c'è un campo aspect_ratio separato qui: l'output assume la forma della tua immagine iniziale, da un paesaggio largo a un ritaglio verticale stretto.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Descrivi solo ciò che accade dopo il fotogramma iniziale: l'azione, la camera e, con l'audio attivo, il suono. almeno 1 caratteri · al massimo 2500 caratteri |
negative_prompt | No | Ciò che non vuoi nella clip (oggetti, stili o movimenti), fino a 2.500 caratteri. Facoltativo; non cambia il prezzo. al massimo 2500 caratteri |
image_url | Sì | Fotogramma iniziale. La clip parte da questa immagine e ne prende il formato. |
last_image_url | No | Fotogramma finale opzionale. Su clip lunghe il centro può divagare più di quanto restino fissi gli estremi. |
resolution | No | 720p, 1080p o 4K. I livelli più alti costano di più al secondo. |
generate_audio | No | Aggiunge una colonna sonora generata alla stessa clip. In 720p e 1080p costa di più al secondo di un'esecuzione silenziosa; in 4K il prezzo è lo stesso con o senza audio. Predefinito: |
duration_seconds | No | Secondi interi, da 3 a 15. Determina il prezzo. |
shot_type | No | single mantiene un'unica ambientazione per la maggior parte del tempo ma può comunque tagliare da solo; multi lascia che Kling scelga il proprio montaggio multi-inquadratura. |
multi_prompt | No | La lista di inquadrature per |
guidance_scale | No | Quanto la clip segue il prompt, da 0 a 1 (predefinito 0,5). Valori più alti restano più fedeli al testo, valori più bassi lasciano più libertà al modello. |
Prezzi
Fatturato al secondo di output. Risoluzione e interruttore audio cambiano entrambi la tariffa.
| Risoluzione | Genera l’audio: No | Genera l’audio: Sì |
|---|---|---|
| $0.0672 / secondo | $0.1008 / secondo |
| $0.0896 / secondo | $0.1344 / secondo |
| $0.336 / secondo | $0.336 / secondo |
Casi d’uso
Continua un personaggio esattamente come progettato
Quando una persona deve apparire uguale da una clip alla successiva, genera o scegli prima un'istantanea, poi animala qui invece di scrivere un nuovo prompt testo-in-video che lascerebbe di nuovo guardaroba e volto al caso.
Fai atterrare una clip su un finale specifico
Imposta un fotogramma finale quando l'ultimo momento dell'inquadratura conta, un'espressione trattenuta, una mano su una porta, una figura che entra a fuoco, invece di lasciare il finale al modello.
Testa un'istantanea di prodotto o moda in movimento
Una foto statica di un prodotto o di un abito, con un prompt per un semplice movimento di camera, basta per vedere come un'immagine statica si comporta una volta in movimento e, con l'audio attivo, come suona.
Consigli avanzati
Descrivi solo ciò che il fotogramma non mostra già
Il nostro esempio forecourt-lightning si attiene a ciò che accade dopo l'istantanea: il lampo, il suo scendere dal camion, la camminata nel diluvio. Non ripete mai il suo abito o l'ambientazione, entrambi già fissati dall'immagine.
Blocca l'inquadratura quando la continuità conta
Su 15 secondi un dettaglio sullo sfondo può andare alla deriva. Se un oggetto o una disposizione specifici devono restare fermi, nominali direttamente ("lo stesso camion rosso resta parcheggiato dietro di lei per tutto il tempo") invece di presumere che il fotogramma iniziale lo fissi per l'intera clip.
Di' "una sola ripresa continua, nessuno stacco" per una ripresa ininterrotta
Il nostro esempio yacht-rail ha tagliato a una seconda angolazione ed è passato dal crepuscolo alla luce diurna al primo tentativo; aggiungere quella riga all'inizio del prompt, insieme a una descrizione della luce che resta costante, ha mantenuto stabili sia l'inquadratura che il colore per tutta la clip nel ritest.
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/3.0/image-to-video",
"input": {
"duration_seconds": 5,
"generate_audio": false,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.












