Introduzione
Kling 3.0 Motion Control prende un'unica foto chiara di un personaggio (image_url) e una clip guida (video_url, da 3 a 30 secondi) e rigioca i movimenti, le espressioni e i gesti delle mani della clip guida su quel personaggio, mantenendo il suo volto, l'abito e l'ambientazione dalla foto. L'output dura esattamente quanto la clip guida ed è fatturato su quella durata, non su una durata che scegli. prompt è opzionale: usalo per tutto ciò che la clip guida non mostra, come l'ambientazione o l'aspetto.
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 |
| 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 (sei qui) |
Caratteristiche principali
Una foto, una clip guida, la stessa performance due volte
Registra o licenzia una clip guida, una danza, una camminata, un gesto, ed eseguila su tutte le foto di personaggi che ti servono. Nel nostro test la coreografia della stessa clip guida è tornata corrispondente battito per battito su due personaggi diversi, ciascuno mantenendo il proprio volto, abito e sfondo.
Il risultato dura quanto la clip guida
Non c'è campo durata da impostare: la lunghezza dell'output corrisponde sempre alla clip guida, da 3 a 30 secondi, e la fatturazione segue la stessa durata.
720p o 1080p
Motion Control non arriva al 4K. La risoluzione cambia il prezzo allo stesso modo degli altri endpoint di Kling 3.0.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | No | Opzionale. Usalo solo per ciò che la clip guida non mostra: l'ambientazione, l'aspetto, qualsiasi cosa da aggiungere. 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 |
image_url | Sì | Il personaggio da animare: un'unica immagine chiara, a corpo intero o mezzo busto, della persona. |
video_url | Sì | Clip guida, da 3 a 30 secondi: i movimenti, le espressioni e i gesti da copiare. Il risultato dura quanto questa clip ed è fatturato su quella durata. |
resolution | No | 720p o 1080p. Il livello più alto costa di più al secondo. |
keep_original_audio | No | Mantiene nel risultato l’audio originale della clip guida. Attivo per impostazione predefinita. Predefinito: |
character_orientation | No | Verso dove guarda il personaggio nel risultato: video (predefinito) segue la persona della clip guida, image segue la persona della tua foto. |
shot_type | No | Come vengono pianificate le inquadrature: customize (predefinito) si attiene ai tuoi input, intelligent lascia che il modello le pianifichi da solo. Non cambia il prezzo. |
Prezzi
Fatturato sulla durata della clip guida (video_url), arrotondata per eccesso al secondo intero, da 3 a 30 secondi, non su una durata che imposti. La risoluzione cambia la tariffa.
| Specifiche | Prezzo |
|---|---|
| $0.1008 / secondo |
| $0.1344 / secondo |
Casi d’uso
Riusa una performance su più personaggi
Coreografa o licenzia una singola clip guida una volta, poi applicala a ogni foto di personaggio di una serie, una coreografia, il gesto di un presentatore di prodotto, un saluto ricorrente, senza rigirare il movimento ogni volta.
Dai a una foto statica di un personaggio un movimento reale e diretto
Invece di descrivere il movimento a parole sperando in un gesto specifico, Motion Control ti permette di mostrare il movimento esatto una volta, come clip guida, e applicarlo con precisione.
Localizza una performance in una nuova ambientazione
Usa il prompt opzionale per collocare il personaggio in una location diversa dallo sfondo proprio della clip guida, mentre il movimento stesso resta identico.
Consigli avanzati
Lascia che la clip guida porti il movimento
Il prompt non deve descrivere alcun movimento: la clip guida lo fornisce già. Usalo solo per ciò che la clip non mostra, come la stanza, un dettaglio del guardaroba, o l'atmosfera.
Tieni la foto del personaggio chiara e a soggetto singolo
Una foto chiara, a corpo intero o mezzo busto, di una persona, ben illuminata e senza ostacoli, dà a Motion Control la corrispondenza più chiara. Una foto con il personaggio parzialmente nascosto o a un'angolazione insolita lascia più cose da indovinare al modello.
Controlla che entrambi gli input siano abbastanza larghi
Sia la foto del personaggio che la clip guida hanno bisogno di circa 720 pixel o più su ogni lato; una clip guida sotto quella soglia viene rifiutata prima che il lavoro inizi, non dopo che l'hai già pagato.
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/character-animation",
"input": {
"character_orientation": "video",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "customize",
"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.












