Introdução
O Kling 2.6 Motion Control copia os movimentos, expressões e gestos de um vídeo de referência para um personagem a partir de uma foto parada. Dê a ele uma foto nítida da pessoa e um clipe de 3 a 30 segundos mostrando a performance, e ele retorna um vídeo silencioso em 720p ou 1080p que dura exatamente o mesmo tempo do vídeo de referência.
Escolha um modo do Kling 2.6 pelo material de partida
| O que você tem no início | Modo |
|---|---|
| uma cena escrita | Kling 2.6 Texto para vídeo |
| uma imagem inicial aprovada | Kling 2.6 Imagem para vídeo |
| um vídeo de referência e uma foto de personagem | Kling 2.6 Motion Control |
Recursos e destaques
A foto do personagem prevalece em tudo que o vídeo de referência não dita
No nosso teste, uma coreografia de hip-hop performada por uma dançarina foi mapeada para um homem diferente, de terno azul-marinho de três peças: os movimentos bateram passo a passo, e o terno, os mocassins, o rosto e o loft de concreto da própria foto dele se mantiveram, em vez do fundo simples de estúdio do vídeo de referência.
Saída silenciosa, duração definida pelo vídeo de referência
Não há campo de áudio neste endpoint — o resultado renderiza silencioso — e também não há campo de duração, já que a saída sempre segue a duração do vídeo de referência, de 3 a 30 segundos.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Não | Opcional. Use-o só para o que o vídeo de referência ainda não mostra — o cenário a manter, um detalhe de figurino, qualquer coisa que você quer manter constante. no máximo 2500 caracteres |
image_url | Sim | O personagem a animar: uma foto nítida, de corpo inteiro ou meio corpo, da pessoa. Apenas JPEG ou PNG. |
video_url | Sim | Vídeo de referência, de 3 a 30 segundos: os movimentos, expressões e gestos a copiar. O resultado dura exatamente o mesmo tempo desse vídeo e não tem áudio. |
resolution | Não | 720p ou 1080p. Níveis mais altos custam mais por segundo. |
Preços
Cobrado por segundo da duração do vídeo de referência — a saída dura exatamente o mesmo tempo da sua entrada de vídeo.
| Especificação | Preço |
|---|---|
| $0.069 / segundo |
| $0.112 / segundo |
Casos de uso
Reaproveitando uma performance em vários personagens
Grave ou gere um único vídeo de referência uma vez, e então rode-o contra diferentes fotos de personagem para reelencar a mesma coreografia, caminhada ou gesto, sem reanimá-lo do zero a cada vez.
Dando movimento real a um design de personagem parado
Dê vida a um personagem que você já projetou ou gerou com uma performance existente, quando precisa que o movimento pareça deliberado, e não livre.
Guia de prompt e dicas práticas
Diga o que manter, não o que copiar
O vídeo de referência já carrega os movimentos, expressões e gestos — o campo de prompt serve para o que ele não consegue mostrar, na maioria das vezes qual cenário manter: o próprio ambiente do personagem, em vez do que aparece no vídeo de referência.
Combine o vídeo de referência e a foto no enquadramento
Nosso teste combinou um vídeo de referência de corpo inteiro com uma foto de personagem de corpo inteiro. Uma incompatibilidade de enquadramento entre os dois — uma foto de meio corpo guiada por um vídeo de corpo inteiro, por exemplo — é o tipo de entrada que vale testar primeiro em resolução baixa.
Confira se as duas entradas são largas o suficiente
Tanto a foto do personagem quanto o vídeo de referência precisam de cerca de 720 pixels ou mais em cada lado; um vídeo de referência abaixo disso é rejeitado antes de o job começar, não depois de você já ter pago por ele. Confira as duas dimensões do vídeo de referência, já que um vídeo pode passar na largura e mesmo assim falhar na altura se tiver sido gravado num enquadramento incomum.
Início rápido da 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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
