Introdução
O Kling 3.0 Turbo Imagem para vídeo pega uma imagem inicial e um prompt descrevendo o que acontece depois, e retorna um clipe de 3 a 15 segundos inteiros com som gerado para combinar. A imagem fixa a tomada inteira: o Kling 3.0 Turbo mantém a pessoa, a roupa e o cenário da sua imagem e inventa o movimento, a câmera e o áudio.
Escolha um modo do Kling 3.0 Turbo pelo material de partida
| O que você tem no início | Modo |
|---|---|
| uma cena escrita | Kling 3.0 Turbo Texto para vídeo |
| uma imagem inicial aprovada | Kling 3.0 Turbo Imagem para vídeo |
Recursos e destaques
A imagem inicial fixa o clipe inteiro
Nos nossos testes, o rosto e a roupa da primeira imagem se mantiveram em todo o clipe: um acompanhamento em primeira pessoa por um mercado noturno manteve o rosto da mesma parceira durante toda a corrida, e um casal em uma scooter manteve as jaquetas e a cor da moto do primeiro ao último quadro. Escreva só o que acontece depois da imagem.
O som chega sincronizado com o movimento
Não há campo aspect_ratio neste endpoint — o formato do quadro do clipe segue sua imagem de origem, então recorte-a no formato que você quer antes de enviá-la. O som sempre renderiza e, nos nossos testes, combinou com a ação visível: ruído de motor e vento no clipe da scooter, barulho de mercado e uma fala gritada no clipe do mercado noturno.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva só o que acontece depois da imagem: a ação, o movimento de câmera e, já que o áudio sempre renderiza, o diálogo ou som ambiente. pelo menos 1 caracteres · no máximo 2500 caracteres |
image_url | Sim | Imagem inicial. A pessoa, a roupa e o cenário nesta imagem se mantêm durante o clipe — só o movimento, a câmera e o som são novos. |
resolution | Não | 720p ou 1080p. Níveis mais altos custam mais por segundo. |
duration_seconds | Não | Segundos inteiros, de 3 a 15. Influencia o preço junto com a resolução. |
Preços
Cobrado por segundo de saída; resolução e duração influenciam a taxa.
| Especificação | Preço |
|---|---|
| $0.112 / segundo |
| $0.14 / segundo |
Casos de uso
Transformar uma imagem aprovada em um momento em movimento e sonorizado
Anime um personagem, produto ou local que você já fixou em uma imagem, em vez de descrever a cena inteira do zero, quando o visual exato precisa ser preciso.
Clipes em POV que começam com uma única imagem
Uma imagem inicial em primeira pessoa mais um prompt curto sobre a ação já bastam para uma tomada de acompanhamento em primeira pessoa com diálogo e som ambiente correspondentes. No nosso teste no mercado noturno, o rosto da mesma parceira se manteve durante toda uma caminhada de mão na mão, com o barulho do mercado e uma fala gritada chegando sincronizados com o movimento.
Dando vida a uma cena de casal ou dupla
Uma imagem parada de duas pessoas - de bicicleta, à mesa, andando juntas - mantém os dois rostos e figurinos enquanto o prompt fornece o que elas fazem e dizem a seguir, o que é mais rápido do que redescrever duas pessoas a partir de um prompt em branco no texto para vídeo.
Guia de prompt e dicas práticas
Descreva o próximo momento, não a cena inteira
Como a imagem já define o visual, o prompt só precisa do movimento, da câmera e do som: o que o assunto faz a seguir, como a câmera acompanha, e — já que o áudio sempre gera — o diálogo ou som ambiente que você quer. Redescrever o figurino, o veículo ou o cenário que a imagem já mostra só desperdiça palavras que o modelo poderia usar na ação.
Nomeie uma fonte de som que realmente esteja em quadro
Nos nossos testes, o áudio ligado a algo visível - um motor, vento, barulho de mercado - renderizou de forma mais consistente do que uma indicação genérica de clima. Se o quadro mostra uma scooter ou uma multidão, nomeie o som que aquela cena realmente faria em vez de descrever um ambiente sem nada em tela para produzi-lo.
Recorte antes de enviar
Não há campo para escolher uma proporção aqui: a saída assume o formato da sua imagem de origem. Recorte para 16:9, 9:16 ou quadrado antes de enviar, se o formato do quadro importa para você.
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/3.0-turbo/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",
"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.











