Introduzione
Kling 3.0 Testo in video trasforma un prompt scritto in una clip senza alcuna immagine o video guida coinvolti. Imposta una durata da 3 a 15 secondi interi, una risoluzione tra 720p, 1080p e 4K, e un formato tra 16:9, 9:16 o 1:1. Attiva generate_audio per ottenere dialogo, effetti e ambiente generati nello stesso passaggio, e scegli shot_type per mantenere un'unica ambientazione continua o lasciare che Kling scelga il proprio montaggio multi-inquadratura.
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 (sei qui) |
| un fotogramma iniziale, e facoltativamente uno finale | Kling 3.0 Immagine in video |
| una foto del personaggio e una clip guida | Kling 3.0 Motion Control |
Caratteristiche principali
Dialogo e ambiente nello stesso file
Con generate_audio attivo, una battuta scritta tra virgolette nel prompt torna come dialogo udibile, sincronizzato con l'immagine, insieme a qualsiasi suono ambientale che descrivi. Nel nostro test la battuta "Don't wait up" è tornata parlata sopra un quartetto d'archi e il mormorio di una gala, tutto da un solo paragrafo.
Due modi per gestire più inquadrature
shot_type impostato su single mantiene la camera su un'unica ambientazione per la maggior parte del tempo, anche se può comunque tagliare da solo: nei nostri test due clip a ripresa singola hanno preso uno stacco extra a metà, una volta con la luce che cambiava nel mezzo. Aggiungere "una sola ripresa continua, nessuno stacco" al prompt ha tenuto insieme l'inquadratura nel nostro ritest. Imposta shot_type su multi e Kling decide i propri stacchi.
720p, 1080p e 4K
Tutte e tre le risoluzioni e l'interruttore audio cambiano il prezzo. Abbozza i tempi e l'inquadratura a 720p, poi esegui la ripresa che ti piace a 4K una volta che merita il rendering.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Descrivi il soggetto, l'azione, la camera e, con l'audio attivo, il dialogo e il suono che vuoi. 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 |
aspect_ratio | No | 16:9, 9:16 o 1:1. Fisso per l'intera clip: non c'è un fotogramma sorgente da seguire. |
resolution | No | 720p, 1080p o 4K. I livelli più alti costano di più al secondo. |
generate_audio | No | Aggiunge una colonna sonora generata, dialogo tra virgolette, effetti, ambiente, alla stessa clip. 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
Apri una scena con audio reale
Un brindisi, una confessione, un addio: scrivi la battuta e attiva l'audio, e il dialogo, il rumore d'ambiente e l'immagine arrivano in un unico file. Il nostro esempio della festa sul tetto finisce con un intero gruppo che grida una riga insieme, sincronizzato con le bottiglie che tintinnano e la musica sotto.
Abbozza un look prima di impegnarti sul 4K
Testo-in-video non ha bisogno di un'immagine sorgente, quindi è il modo più veloce per testare un'idea di luce, un movimento di camera o una battuta di dialogo prima di spendere un rendering 4K.
Passa il testimone a immagine-in-video per la continuità
Testo-in-video decide guardaroba, volto e inquadratura da zero a ogni esecuzione. Quando un personaggio deve apparire uguale su più clip, genera qui la prima inquadratura, poi porta il suo ultimo fotogramma in immagine-in-video come fotogramma iniziale della successiva.
Consigli avanzati
Scrivilo nell'ordine in cui accade
Struttura il prompt come soggetto e guardaroba, azione, movimento di camera, aspetto, poi suono. L'esempio palazzo-terrace-gown segue quest'ordine: chi è e cosa indossa, cosa fa (cammina, si gira, parla), la camera e la luce, poi il suono ambientale.
Dai all'intero gruppo un'unica riga su cui atterrare
Quando più persone sono in scena, nominare un unico momento, una riga, pronunciata insieme, proprio alla fine del brief, dà al modello un momento chiaro su cui far atterrare il dialogo invece di indovinare quando più voci dovrebbero sovrapporsi.
Di' "una sola ripresa continua, nessuno stacco" quando conta
shot_type: single non è una garanzia assoluta contro gli stacchi. Se la ripresa deve mantenere un'unica ambientazione dall'inizio alla fine, aggiungi quell'istruzione direttamente nel prompt; ha mantenuto stabili sia l'inquadratura che l'illuminazione nel nostro ritest di un'inquadratura che aveva tagliato e cambiato luce al primo tentativo.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"shot_type": "single",
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": false,
"duration_seconds": 5
}
}'
# 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.












