Introduzione
Kling 4.0 Flash video-edit parte da una clip esistente e da un’istruzione obbligatoria su cosa cambiare. Fornisci una sorgente di 3–20 secondi e, se utili, fino a 10 immagini di riferimento. Il risultato a 720p conserva scena, soggetto, movimento e ripresa della sorgente applicando la modifica descritta.
La durata dell’output segue quella della sorgente; le sorgenti oltre i 20 secondi vengono tagliate a quel punto. Nei nostri test, il cambio d’abito nell’osservatorio ha mantenuto la sorgente di 5,04 secondi a 5,04 secondi. L’audio sorgente viene conservato per impostazione predefinita; imposta keep_original_audio su false per generare nuovo audio sincronizzato.
Caratteristiche principali
- Costruisci una variante visiva attorno a un’interpretazione e a un movimento di macchina esistenti.
- Aggiungi fino a 10 immagini quando la modifica richiede un riferimento visivo specifico.
- Mantieni i tempi della sorgente nel risultato, con un limite di 20 secondi per il materiale di partenza.
- Conserva la colonna sonora originale per impostazione predefinita oppure genera nuovo audio sincronizzato.
- Ricevi un output a 720p con inquadratura auto o uno dei quattro rapporti d’aspetto supportati.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Istruzioni di modifica obbligatorie, senza testo preimpostato; descrivi il cambiamento e la scena, il soggetto, il movimento e la ripresa da conservare. almeno 1 caratteri |
video_url | Sì | URL obbligatorio di una clip sorgente di 3–20 secondi, senza sorgente preimpostata; gli input più lunghi vengono tagliati a 20 secondi. almeno 1 caratteri |
reference_image_urls | No | Aggiungi facoltativamente fino a 10 URL di immagini per guidare la modifica, identificandole come @Image1, @Image2 e così via nell’ordine di caricamento. almeno 1 elementi · al massimo 10 elementi |
aspect_ratio | No | Usa auto per seguire il video sorgente oppure imposta 16:9, 9:16, 1:1 o 21:9 per la forma del risultato. Questa impostazione non modifica il costo della modifica. |
keep_original_audio | No | Il valore predefinito true conserva il suono sorgente; false genera una nuova colonna sonora sincronizzata. Cambiare questo valore non comporta costi separati. Predefinito: |
Prezzi
$0.151 / secondo
La modifica viene addebitata per secondo della sorgente arrotondato per eccesso all’intero successivo, fino a un massimo di 20 secondi conteggiati. Una sorgente di 5,04 secondi ne conta 6 ai fini dell’addebito, anche se l’output rimane di 5,04 secondi. Prompt, immagini di riferimento, rapporto d’aspetto e scelta dell’audio non comportano costi separati. Non paghi le richieste respinte dalla moderazione di Kling.
Casi d’uso
- Prova un abito da sera smeraldo nella clip di un osservatorio conservando l’azione.
- Valuta diversi colori di cappotto nelle versioni di una breve scena social.
- Prepara varianti visive di un movimento registrato mantenendo la colonna sonora sorgente.
Consigli avanzati
- Inizia da ciò che vuoi conservare, per esempio «mantieni la scena e il movimento di macchina», per definire gli elementi fissi della modifica.
- Indica un cambiamento mirato, come «rendi il cappotto grigio antracite», prima di richiedere più varianti.
- Assegna un ruolo a ogni immagine aggiunta, per esempio «usa la giacca mostrata in @Image1», per collegare il riferimento alla modifica.
- Descrivi insieme tessuto e colore, per esempio «un abito di velluto smeraldo», quando la modifica riguarda l’abbigliamento.
- Per una nuova colonna sonora, disattiva
keep_original_audioe aggiungi un’indicazione come «Suono: un sommesso ronzio di motore e vento serale».
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/video-edit",
"input": {
"aspect_ratio": "auto",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.
