Introdução
Kling 4.0 Imagem para vídeo anima o seu quadro inicial em um clipe de 3 a 30 segundos em 720p ou 1080p. Adicione um quadro final para fixar onde ele termina e até 8 quadros intermediários, em ordem, para direcionar o caminho entre os dois. O prompt é opcional; todo clipe volta com uma trilha estéreo.
Escolha um modo do Kling 4.0 pelo material inicial
| O que você tem no início | Modo |
|---|---|
| um roteiro ou cena escrita | Kling 4.0 Texto para vídeo |
| um quadro inicial, e opcionalmente um quadro final e quadros intermediários | Kling 4.0 Imagem para vídeo (você está aqui) |
| fotos, clipes ou amostras de voz para montar o elenco | Kling 4.0 Referência para vídeo |
Recursos e destaques
Primeiro quadro, quadros intermediários, último quadro
image_url define o início, last_image_url o final e keyframe_image_urls os momentos entre eles, na ordem em que devem aparecer. No nosso teste, uma astrônoma no telescópio (início), inclinando-se para a ocular (intermediário) e apoiada no corrimão com os braços cruzados (final) virou um único movimento contínuo de 3 segundos passando pelas três poses.
A forma segue o seu quadro
Deixe aspect_ratio em auto e o clipe mantém a forma do quadro inicial; escolha 16:9, 9:16, 1:1 ou 21:9 para substituí-la.
O som vem junto
Todo clipe traz uma trilha de dois canais. Descreva o som no prompt para direcioná-lo.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Não | Opcional. Descreva o que acontece depois do quadro inicial — a ação, a câmera e o som. pelo menos 1 caracteres |
image_url | Sim | O quadro inicial, em JPEG ou PNG. O clipe começa a partir desta imagem. |
last_image_url | Não | Quadro final opcional. O clipe termina nesta imagem; mantenha o mesmo personagem, cenário e posição de câmera do quadro inicial. |
keyframe_image_urls | Não | Quadros intermediários opcionais, até 8, na ordem em que devem aparecer entre o quadro inicial e o final. Não são citados no prompt e não alteram o preço. pelo menos 1 itens · no máximo 8 itens |
aspect_ratio | Não | auto (padrão) mantém a forma do quadro inicial; 16:9, 9:16, 1:1 ou 21:9 a substituem. Não altera o preço. |
resolution | Não | 720p ou 1080p (padrão 720p). 1080p custa mais por segundo. |
duration_seconds | Não | Segundos inteiros, de 3 a 30 (padrão 5). Define o preço. |
Preços
Cobrado por segundo de saída. 1080p custa mais por segundo do que 720p. Todo clipe vem com trilha estéreo sem custo extra. Requisição recusada ou com falha não é cobrada.
| Especificação | Preço |
|---|---|
| $0.216 / segundo |
| $0.324 / segundo |
Casos de uso
Dê vida a uma imagem parada
Um retrato, a foto de um produto ou um quadro de um clipe anterior — descreva apenas o que acontece depois, e a aparência, o figurino e o cenário vêm da sua imagem.
De storyboard para movimento
Desenhe ou gere as poses principais de um plano, envie-as como quadros inicial, intermediários e final, e o modelo preenche o movimento entre elas.
Continue uma cena
Use o último quadro de um clipe anterior como quadro inicial do próximo para manter um personagem e um cenário consistentes entre os planos.
Guia de prompt e dicas práticas
Mantenha os quadros consistentes
Os quadros inicial, intermediários e final devem compartilhar o mesmo personagem, figurino, cenário e posição de câmera. Quadros que não batem forçam um corte ou uma transformação.
Descreva o movimento, não a imagem
A imagem já mostra como tudo é. Use o prompt para a ação, o movimento de câmera e o som.
Menos quadros-chave, e mais claros
Cada quadro intermediário é um ponto por onde o clipe precisa passar. Para um clipe curto, um ou dois bastam; muitos em poucos segundos deixam o movimento apressado.
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/4.0/image-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.










