Introduzione
Kling 2.6 Motion Control copia i movimenti, le espressioni e i gesti di un video guida su un personaggio da una foto statica. Dagli un'unica immagine chiara della persona e una clip da 3 a 30 secondi che mostra la performance, e restituisce un video silenzioso a 720p o 1080p che dura esattamente quanto la clip guida.
Scegli una modalità di Kling 2.6 in base al materiale di partenza
| Cosa hai all'inizio | Modalità |
|---|---|
| una scena scritta | Kling 2.6 Testo in video |
| un'immagine iniziale approvata | Kling 2.6 Immagine in video |
| una clip guida e una foto del personaggio | Kling 2.6 Motion Control |
Caratteristiche principali
La foto del personaggio prevale su tutto ciò che la clip guida non impone
Nel nostro test, una coreografia hip-hop eseguita da un ballerino è stata mappata su un uomo diverso in completo blu navy a tre pezzi: i movimenti corrispondevano passo per passo, e il suo completo, i mocassini, il volto e il loft di cemento dalla sua foto sono rimasti tutti, invece dello sfondo neutro dello studio della clip guida.
Output silenzioso, durata impostata dalla clip guida
Non c'è campo audio su questo endpoint: il risultato genera in silenzio, e non c'è nemmeno campo durata, dato che l'output rispetta sempre la lunghezza della clip guida, da 3 a 30 secondi.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | No | Opzionale. Usalo solo per ciò che la clip guida non mostra già: l'ambientazione da mantenere, un dettaglio del guardaroba, qualsiasi cosa tu voglia tenere costante. al massimo 2500 caratteri |
image_url | Sì | Il personaggio da animare: un'unica immagine chiara, a corpo intero o mezzo busto, della persona. Solo JPEG o PNG. |
video_url | Sì | Clip guida, da 3 a 30 secondi: i movimenti, le espressioni e i gesti da copiare. Il risultato dura esattamente quanto questa clip e non ha audio. |
resolution | No | 720p o 1080p. I livelli più alti costano di più al secondo. |
Prezzi
Fatturato al secondo della durata della clip guida: l'output dura esattamente quanto il tuo video in ingresso.
| Specifiche | Prezzo |
|---|---|
| $0.069 / secondo |
| $0.112 / secondo |
Casi d’uso
Riutilizzare una performance su più personaggi
Gira o genera una singola clip guida una volta, poi eseguila su foto di personaggi diversi per rifare la stessa coreografia, camminata o gesto senza rianimarla da zero ogni volta.
Aggiungere movimento a un design di personaggio statico
Dai vita a un personaggio che hai già progettato o generato con una performance esistente, quando ti serve che il movimento appaia deliberato piuttosto che casuale.
Consigli avanzati
Di' cosa mantenere, non cosa copiare
La clip guida porta già i movimenti, le espressioni e i gesti: il campo prompt serve per tutto ciò che non può mostrare, più spesso quale ambientazione mantenere, la stanza del personaggio piuttosto che quella della clip guida.
Fai corrispondere l'inquadratura tra clip guida e foto
Il nostro test ha abbinato una clip guida a corpo intero con una foto del personaggio a corpo intero. Una forte discrepanza di inquadratura tra i due, per esempio una foto a mezzo busto guidata da una clip a corpo intero, è il tipo di input da testare prima a bassa risoluzione.
Controlla che entrambi gli input siano abbastanza larghi
Sia la foto del personaggio sia la clip guida hanno bisogno di circa 720 pixel o più per lato; una clip guida sotto quella soglia viene rifiutata prima che il job inizi, non dopo che l'hai già pagata. Controlla entrambe le dimensioni della clip guida, perché un video può passare in larghezza e comunque fallire in altezza se è stato girato con un'inquadratura insolita.
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.6/character-animation",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"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.
