Introduzione
Kling 2.1 Master Immagine in video anima un fotogramma iniziale in una clip di 5 o 10 secondi a 1080p, senza traccia audio e senza opzione di fotogramma finale su questo endpoint: solo image_url.
Scegli una modalità di Kling 2.1 Master in base al materiale di partenza
| Cosa hai all'inizio | Modalità |
|---|---|
| una scena scritta | Kling 2.1 Master Testo in video |
| un fotogramma iniziale approvato | Kling 2.1 Master Immagine in video |
Caratteristiche principali
L'inquadratura resta ferma, il prompt fornisce il movimento
Guardaroba, posa, luce e ambientazione dell'inquadratura iniziale restano esattamente come inviate; il prompt deve solo descrivere cosa succede dopo e dove va la camera. Nei nostri test, un'onda oceanica congelata e un abito da ballo subacqueo hanno preso vita entrambi in modo convincente da una singola immagine ferma, con inquadratura e costume intatti.
Nessuna inquadratura finale su questo endpoint
A differenza dell'image-to-video standard di Kling 2.1, quello di Master accetta solo image_url, non last_image_url. Se una posa finale specifica conta, descrivila direttamente nel prompt e lascia che il modello ci lavori, invece di aspettarti che una seconda immagine fissi il finale.
Le inquadrature verticali possono far apparire il viso più piccolo
Quando l'inquadratura iniziale è un ritaglio verticale, il rendering segue quel formato, e in uno dei nostri test il viso è risultato più piccolo e leggermente meno dettagliato rispetto a un'inquadratura orizzontale. Un ritaglio del viso più stretto su un'inquadratura verticale porta più dettaglio nella clip finita.
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. |
duration_seconds | No | Secondi interi, 5 o 10. Determina il prezzo. |
negative_prompt | No | Un breve elenco di ciò che la clip dovrebbe evitare: utile per allontanare i difetti di rendering più comuni sui movimenti di camera complessi. 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
$0.216 / secondo
Fatturato al secondo della clip in output. Un caricamento rifiutato da Kling non viene addebitato.
Casi d’uso
Portare un'immagine ferma specifica alla sua migliore qualità di movimento
Usa questo livello quando l'inquadratura iniziale è già esattamente quella giusta - luce, guardaroba, posa - e il rendering deve essere la versione da tenere, non una bozza da confrontare con take più economici.
Movimento atmosferico: tessuto, acqua, fuoco, polvere
Abiti che ondeggiano, onde che si sollevano, nebbia alla deriva e un lampadario che oscilla sono stati resi tutti in modo naturale nei nostri test partendo da un'immagine ferma più un prompt che descrive il movimento, il che si adatta a qualsiasi inquadratura costruita sull'atmosfera più che sul dialogo o sull'azione veloce.
Una seconda clip ad alta fedeltà nello stesso progetto
Poiché questo endpoint condivide il prezzo più alto di Master con la sua controparte text-to-video, trattalo allo stesso modo: riservalo per un'inquadratura già approvata altrove, e sistema prima il testo su un livello più economico.
Consigli avanzati
Di' agli elementi dell'inquadratura ferma quando muoversi
Indica cosa è già presente nell'inquadratura - un'onda, una posa, un abito - e descrivi l'ordine in cui deve prendere vita, invece di ridescrivere l'intera scena da zero; il modello sa già come appare l'immagine.
Abbina negative_prompt a una camera che orbita o va alla deriva
Un negative_prompt breve, che ad esempio nomina volti sfocati o mani distorte, è un modo economico per allontanare un'orbita lenta o una deriva in stile subacqueo dai difetti di rendering più comuni di questo modello, soprattutto quando la clip arriva ai suoi 10 secondi completi.
Ritaglia il viso un po' più stretto sulle inquadrature verticali
Se l'inquadratura iniziale è un ritaglio verticale, inquadra il viso più da vicino rispetto a quanto faresti per un'inquadratura orizzontale; un ritaglio verticale ampio può far apparire il viso piccolo una volta che la clip è in movimento, come è successo in uno dei nostri test su inquadrature verticali.
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-master/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"
}
}'
# 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.
