Introduzione
Kling 4.0 Flash reference-to-video crea una nuova scena a 720p usando un prompt obbligatorio e i riferimenti forniti. Aggiungi fino a 10 immagini e 5 clip video per una durata complessiva di 20 secondi. Nomina le immagini come @Image1 e i video come @Video1, proseguendo la numerazione nell’ordine di caricamento.
Spiega nel prompt il contributo di ciascun riferimento. Nell’esempio del deserto un’immagine identifica il soggetto, mentre due video guidano il movimento di macchina nella scena al crepuscolo. Le nuove clip durano 3–20 secondi interi, con 5 secondi come valore predefinito, e includono audio sincronizzato; keep_original_audio può conservare il suono di un video di riferimento. I file audio di riferimento non sono supportati.
Caratteristiche principali
- Associa nel prompt fino a 10 immagini di riferimento a soggetti, oggetti o dettagli della scena.
- Guida movimento e inquadratura con fino a 5 video per non più di 20 secondi complessivi.
- Collega la descrizione della scena ai file forniti usando le etichette @Image1 e @Video1.
- Genera un risultato a 720p di 3–20 secondi con audio, oppure mantieni il suono del video di riferimento tramite
keep_original_audio. - Segui l’inquadratura dell’input con auto oppure scegli 16:9, 9:16, 1:1 o 21:9.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Istruzioni di scena obbligatorie, senza testo preimpostato; assegna ruoli a @Image1, @Image2, @Video1 e ai caricamenti successivi. Il testo del prompt non comporta costi separati. almeno 1 caratteri |
reference_image_urls | No | Fornisci fino a 10 URL di immagini e nominale @Image1, @Image2 e così via nell’ordine di caricamento. Guidano la scena senza cambiare il prezzo. almeno 1 elementi · al massimo 10 elementi |
reference_video_urls | No | Fornisci fino a 5 URL di video per 20 secondi complessivi e nominali @Video1, @Video2 e così via. almeno 1 elementi · al massimo 5 elementi |
aspect_ratio | No | Scegli auto per seguire i riferimenti oppure seleziona 16:9, 9:16, 1:1 o 21:9. La forma dell’inquadratura non cambia la tariffa al secondo né aggiunge costi. |
keep_original_audio | No | Imposta true per conservare il suono del video di riferimento oppure false per generare una nuova colonna sonora; vale quando fornisci un video di riferimento. Predefinito: |
duration_seconds | No | La durata dell’output accetta secondi interi da 3 a 20, con 5 secondi come valore predefinito. Incide sul totale attraverso la durata di output addebitata. |
Prezzi
$0.113 / secondo
La generazione con riferimenti viene addebitata per secondo di output. Inserire un video di riferimento applica una tariffa al secondo più alta alla durata del risultato; la durata del video di riferimento non viene addebitata separatamente. Immagini di riferimento, testo del prompt, rapporto d’aspetto e keep_original_audio non comportano costi separati. Le richieste respinte dalla moderazione di Kling non vengono addebitate.
Casi d’uso
- Inserisci il soggetto di un’immagine in una scena social nel deserto guidata da brevi clip di movimento.
- Esplora una combinazione di personaggio e luogo usando immagini di riferimento nominate separatamente.
- Costruisci più bozze brevi attorno a un movimento di macchina scelto per valutare i contenuti.
Consigli avanzati
- Identifica il ruolo di ciascuna immagine, per esempio «@Image1 definisce il soggetto», prima di descrivere la nuova scena.
- Spiega cosa riprendere da un video, come «usa il lento avvicinamento di macchina di @Video1», per dare al riferimento uno scopo preciso.
- Descrivi la nuova ambientazione, per esempio «un deserto silenzioso al crepuscolo», per distinguere la scena richiesta dal materiale di riferimento.
- Mantieni breve l’azione richiesta, per esempio «il viaggiatore si ferma accanto al cartello», quando prepari un risultato di 3 secondi.
- Se generi una nuova colonna sonora, aggiungi un’indicazione come «Suono: vento secco e un treno lontano» per guidare l’audio incluso.
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-flash/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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.
