Introduzione
Kling O3 Riferimento in video allestisce un'inquadratura da fino a 7 foto di riferimento, personaggi, abiti, oggetti o luoghi, invece che da un singolo fotogramma iniziale. Numera i riferimenti nel prompt (<<<image_1>>>, <<<image_2>>>, e così via) e di' cosa contribuisce ciascuno; il campo prompt accetta fino a 2.500 caratteri. Scegli una durata da 3 a 15 secondi interi, una risoluzione fino al 4K, un formato, e se generare audio nativo.
Scegli una modalità di Kling O3 in base al materiale di partenza
| Cosa hai all'inizio | Modalità |
|---|---|
| una scena scritta e nient'altro | Kling O3 Testo in video |
| un fotogramma iniziale approvato | Kling O3 Immagine in video |
| fino a 7 foto di riferimento | Kling O3 Riferimento in video |
| un video che hai già | Kling O3 Modifica video |
Caratteristiche principali
Più riferimenti, un'unica inquadratura
A differenza di immagine-in-video, che parte da un unico fotogramma, reference-to-video prende fino a 7 foto separate e combina ciò che mostra ciascuna. Il nostro esempio della carrozza ristorante ne usava tre: un uomo, una stanza e un oggetto, allestiti insieme in una scena che nessuna delle tre foto ritraeva da sola.
Ogni riferimento ha un compito
Il prompt è dove assegni il compito: "<<<image_1>>> è l'uomo, mantieni il suo cappotto e la barba incolta" è ciò che mantiene intatti quel volto e quel guardaroba invece che il modello li mediasse con gli altri riferimenti.
Audio generato con la scena allestita
generate_audio aggiunge ambiente, effetti e dialogo nello stesso passaggio. Tieni aspettative realistiche per il suono di sottofondo descritto solo in una frase o due: può generare piano nel mix finale invece che come uno strato dominante.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Di' cos'è ogni riferimento numerato (<<< |
reference_image_urls | Sì | Fino a 7 foto di riferimento per personaggi, oggetti, abiti o luoghi. JPEG o PNG. almeno 1 elementi · al massimo 7 elementi |
reference_video_urls | No | Video di riferimento facoltativo, una sola clip, da cui la nuova ripresa prende movimento, camera o personaggi; indicalo nel prompt come <<< |
elements | No | Un soggetto con nome per le esecuzioni in 4K: dagli un nome, una descrizione di una riga e da 2 a 4 foto della stessa persona o dello stesso oggetto (i campioni vocali da 5 a 30… al massimo 1 elementi |
aspect_ratio | No | 16:9, 9:16 o 1:1. Scegli prima di scrivere l'inquadratura così la composizione si adatta. |
resolution | No | 720p, 1080p o 4K. I livelli più alti costano di più al secondo. |
generate_audio | No | Aggiunge una colonna sonora generata nello stesso passaggio, dialogo tra virgolette, effetti, ambiente. Predefinito: |
keep_original_audio | No | Mantiene nel risultato l’audio originale del video di riferimento. Attivo per impostazione predefinita; conta solo se fornisci un video di riferimento. Predefinito: |
duration_seconds | No | Secondi interi, da 3 a 15. Determina il prezzo insieme alla risoluzione e all'audio. |
shot_type | No | single chiede un’unica ripresa continua (non una garanzia assoluta). multi lascia che il modello divida la scena in più inquadrature da solo. |
multi_prompt | No | La lista di inquadrature per |
Prezzi
Fatturato al secondo di output. La tariffa dipende dalla risoluzione, da se l'audio nativo è attivo e da se fornisci un video di riferimento.
| Specifiche | Prezzo |
|---|---|
| $0.0672 / secondo |
| $0.0896 / secondo |
| $0.419 / secondo |
| $0.0896 / secondo |
| $0.112 / secondo |
| $0.419 / secondo |
| $0.1008 / secondo |
| $0.1344 / secondo |
Casi d’uso
Metti una persona in un luogo dove non è mai stata fotografata
Dai a un volto il proprio riferimento e a una location il proprio, e descrivi l'azione che li mette insieme: il tipo di inquadratura che una singola foto di uno dei due non potrebbe fornire da sola.
Mantieni coerente un prop o un abito tra più inquadrature
Riferisci un oggetto specifico, un gioiello, un'auto, un abito distintivo, insieme a un riferimento di personaggio, e ricompare correttamente invece di essere ridisegnato leggermente diverso a ogni esecuzione.
Costruisci una scena intorno a tre elementi pianificati
Quando un'inquadratura dipende da una persona specifica, un'ambientazione specifica e un oggetto specifico che appaiono tutti insieme, come una lettera, una stanza e chi la legge, i riferimenti ti permettono di bloccare tutti e tre invece di descriverli da zero in prosa.
Consigli avanzati
Numera ogni riferimento e nomina il suo compito
Scrivi "<<<image_1>>> è X, mantieni Y" per ogni riferimento in ordine. Questo è il singolo fattore più importante nel determinare se un riferimento passa in modo pulito o si fonde con gli altri.
Usa tre o quattro foto chiare invece di sette sovrapposte
Più riferimenti non sono automaticamente migliori. Una manciata di foto chiare e distinte, una per il volto, una per l'abito, una per la stanza, mantiene l'identità meglio di sette foto che si sovrappongono in ciò che mostrano.
Descrivi il suono come uno strato di sottofondo
Quando chiedi un'atmosfera come pioggia o ruote di treno insieme al dialogo, aspettati che stia basso nel mix. Se l'atmosfera deve essere prominente, dillo esplicitamente invece di elencarla brevemente accanto al dialogo.
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/o3/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"generate_audio": false,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"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.












