Introdução
O Kling 2.1 Master Imagem para vídeo anima uma imagem inicial em um clipe de 5 ou 10 segundos em 1080p, sem trilha de áudio e sem opção de imagem final neste endpoint — só image_url.
Escolha um modo do Kling 2.1 Master pelo material de partida
| O que você tem no início | Modo |
|---|---|
| uma cena escrita | Kling 2.1 Master Texto para vídeo |
| uma imagem inicial aprovada | Kling 2.1 Master Imagem para vídeo |
Recursos e destaques
A imagem se mantém, o prompt fornece o movimento
O figurino, a pose, a luz e o cenário da imagem inicial permanecem exatamente como enviados; o prompt só precisa descrever o que acontece depois e para onde a câmera vai. Nos nossos testes, uma onda congelada e um vestido de baile debaixo d'água ganharam vida de forma convincente a partir de uma única imagem parada, com o enquadramento e o figurino intactos.
Sem imagem final neste endpoint
Diferente da imagem para vídeo padrão do Kling 2.1, a imagem para vídeo do Master aceita apenas image_url, sem last_image_url. Se uma pose final específica importa, descreva-a diretamente no prompt e deixe o modelo trabalhar rumo a ela, em vez de esperar que uma segunda imagem trave o final.
Imagens verticais podem deixar o rosto menor
Quando a imagem inicial é um recorte vertical, a renderização segue esse formato, e em um dos nossos testes o rosto ficou menor e um pouco menos detalhado do que ficaria com uma imagem horizontal. Um recorte de rosto mais fechado em uma imagem inicial vertical carrega mais detalhe para o clipe final.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva só o que acontece depois da imagem inicial: a ação e o movimento de câmera. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_url | Sim | Imagem inicial. Apenas JPEG ou PNG. |
duration_seconds | Não | Segundos inteiros, 5 ou 10. Influencia o preço. |
negative_prompt | Não | Uma lista curta do que o clipe deve evitar — útil para afastar defeitos comuns de renderização em movimentos de câmera complexos. no máximo 500 caracteres |
guidance_scale | Não | De 0 a 1. Mais alto se apega mais às suas palavras; mais baixo dá ao modelo mais liberdade. |
Preços
$0.216 / segundo
Cobrado por segundo do clipe de saída. Um envio que a Kling recusa não é cobrado.
Casos de uso
Trazer uma imagem específica ao seu melhor movimento
Use este nível quando a imagem inicial já estiver exatamente certa — luz, figurino, pose — e a renderização precisar ser a versão definitiva, não um rascunho para comparar com takes mais baratos.
Movimento atmosférico: tecido, água, fogo, poeira
Vestidos fluindo, ondas se enrolando, névoa à deriva e um lustre balançando renderizaram naturalmente nos nossos testes a partir de uma imagem parada mais um prompt descrevendo o movimento, o que combina com qualquer cena construída em torno de atmosfera em vez de diálogo ou ação rápida.
Um segundo clipe de alta fidelidade no mesmo projeto
Como este endpoint compartilha o preço mais alto do Master com seu equivalente de texto para vídeo, trate-o da mesma forma: reserve-o para uma cena já aprovada em outro lugar, e resolva o texto primeiro em um nível mais barato.
Guia de prompt e dicas práticas
Diga aos elementos da imagem parada quando se mover
Aponte para o que já está na imagem — uma onda, uma pose, uma roupa — e descreva a ordem em que deve ganhar vida, em vez de redescrever a cena inteira do zero; o modelo já sabe como a imagem se parece.
Combine um negative_prompt com uma câmera orbitando ou à deriva
Um negative_prompt curto, nomeando por exemplo rostos embaçados ou mãos distorcidas, é uma forma barata de afastar uma órbita lenta ou uma deriva estilo subaquático das falhas de renderização mais comuns deste modelo, especialmente quando o clipe chega aos 10 segundos completos.
Recorte o rosto um pouco mais fechado em imagens verticais
Se a imagem inicial é um recorte vertical, enquadre o rosto mais perto do que faria em uma cena horizontal; um recorte vertical amplo pode deixar o rosto pequeno quando o clipe entra em movimento, como aconteceu em um dos nossos testes com imagens verticais.
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.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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
