Introduzione
Kling 2.1 Immagine in video è l'unica modalità offerta da questa generazione: invia un fotogramma iniziale e un prompt che descrive cosa succede dopo, scegli una resolution tra 720p (standard) e 1080p (pro), e ricevi indietro una clip silenziosa di 5 o 10 secondi. Un fotogramma finale (last_image_url) viene accettato solo a 1080p.
Scegli una risoluzione in base al budget
| Cosa vuoi | Risoluzione |
|---|---|
| il livello più economico della gamma | 720p (standard) |
| una clip più nitida, con fotogramma finale opzionale | 1080p (pro) |
Caratteristiche principali
Un'inquadratura finale, ma solo a 1080p
Imposta resolution su 1080p e aggiungi un'inquadratura finale accanto a quella iniziale, e la clip viene costruita per atterrare esattamente su quella posa nell'ultimo fotogramma. A 720p un'inquadratura finale non viene accettata: una richiesta che ne include una viene rifiutata prima dell'esecuzione, senza addebito, quindi ometti questo campo a questo livello e lascia che la clip vada dall'inquadratura iniziale fino a dove il modello decide di fermarsi.
Nessuna traccia audio su nessuno dei due livelli
Questo modello non genera alcun suono, né a 720p né a 1080p. È un fatto semplice da pianificare, non un difetto - si adatta a materiale destinato a un montaggio che aggiungerà in seguito voce, musica o sound design propri.
L'inquadratura iniziale e quella finale possono collegarsi in modo pulito
In uno dei nostri test, una camminata su un molo che iniziava nella nebbia e finiva su una posa ravvicinata rivolta verso la camera è atterrata quasi esattamente sull'inquadratura finale fornita, con vento e color grading coerenti per tutti e cinque i secondi.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Descrivi solo ciò che accade dopo il fotogramma iniziale: l'azione e il movimento di camera. almeno 1 caratteri · al massimo 5000 caratteri |
image_url | Sì | Fotogramma iniziale. Solo JPEG o PNG. |
last_image_url | No | Fotogramma finale opzionale, accettato solo a 1080p. Una richiesta a 720p che lo include viene rifiutata, senza addebito. |
resolution | No | 720p (standard, il livello più economico) o 1080p (pro, l'unico livello che accetta un fotogramma finale). |
duration_seconds | No | Secondi interi, 5 o 10. Determina il prezzo. |
negative_prompt | No | Un breve elenco di ciò che la clip dovrebbe evitare. al massimo 500 caratteri |
guidance_scale | No | Da 0 a 1. Valori più alti restano più fedeli al tuo testo; valori più bassi danno al modello più libertà. |
Prezzi
Fatturato al secondo della clip in output; il livello pro 1080p costa di più al secondo rispetto al livello standard 720p. Un caricamento rifiutato da Kling non viene addebitato.
| Specifiche | Prezzo |
|---|---|
| $0.035 / secondo |
| $0.068 / secondo |
Casi d’uso
Il test più economico di un fotogramma iniziale
Esegui prima il livello standard 720p per vedere se un'azione, un movimento di camera o un'inquadratura funzionano come desideri, prima di spendere di più su un livello superiore o una generazione più recente.
Una sequenza a due fotogrammi con un finale bloccato
Usa il livello pro 1080p con sia image_url che last_image_url quando la posa finale esatta conta, come per l'ultima inquadratura prima di uno stacco.
Consigli avanzati
Descrivi un'azione continua, dall'inizio alla fine
L'esempio della spada sul tetto qui sopra nomina un unico arco, dallo slancio alla posizione di guardia finale; questa struttura a un solo momento è più affidabile su questa generazione rispetto a diverse azioni distinte inserite in un unico prompt.
Non aspettarti che i dettagli lunghi e trascinati mantengano la forma
Capelli lunghi, tessuti che si trascinano o accessori fluttuanti sono il tipo di dettaglio che questa generazione tende a perdere nell'arco di 10 secondi - uno strascico lungo di velluto si è visibilmente accorciato a metà di uno dei nostri test su una scalinata. Tieni questi dettagli brevi, oppure pianifica un ritocco successivo.
Adatta la risoluzione a ciò che serve all'inquadratura
Fai prima una prova a 720p mentre stai ancora sistemando l'azione o il movimento di camera, e riserva il livello pro a 1080p - con la sua inquadratura finale opzionale - per il take che vuoi tenere.
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/2.1/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.
