Introdução
O Kling 3.0 Turbo Texto para vídeo transforma uma cena escrita em um clipe de 3 a 15 segundos inteiros, em 720p ou 1080p, com som gerado na mesma passada. Não há modo silencioso neste endpoint: descreva o diálogo e o som ambiente que você quer no prompt e eles renderizam junto com a imagem.
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
O som não é opcional, e esse é o ponto
Todo clipe que sai deste endpoint carrega uma trilha sonora gerada: o diálogo que você coloca entre aspas renderiza como falas ditas, e qualquer som ambiente que você nomeia — música, passos, trânsito — volta misturado com a imagem. Nos nossos testes, as falas bateram com o prompt palavra por palavra em todo clipe que rodamos. Não há campo para desligar o áudio; para um clipe silencioso em 1080p, use o Kling 2.5 Turbo.
Um take contínuo, sem campo de corte de tomada
Este endpoint não tem configuração de múltiplas tomadas, então todo clipe é reproduzido como um único take ininterrupto. Escreva uma ação clara do início ao fim — uma dança, uma corrida e um salto, uma virada para a câmera — em vez de vários momentos que você quer costurados juntos.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Escreva como uma tomada: quem está em quadro, a ação, o movimento de câmera, e então o som — diálogo entre aspas e os sons ambientes que você quer. pelo menos 1 caracteres · no máximo 2500 caracteres |
aspect_ratio | Não | 16:9, 9:16 ou 1:1. Escolha antes de escrever o prompt para que o briefing posicione o assunto para esse formato. |
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
Cenas de diálogo para shorts e reels
Duas pessoas conversando, rindo ou trocando uma fala funciona bem aqui, já que o áudio volta sincronizado com a imagem, em vez de dublado depois. Uma cena de cozinha que testamos trouxe a fala, a música de fundo e o som de uma panela borbulhando, tudo no mesmo arquivo, sem precisar de uma etapa de áudio separada antes de postar.
Clipes de ação e movimento com som correspondente
Parkour, dança e outras ações físicas vêm com passos, impactos e respiração embutidos no mesmo arquivo que o movimento, sem uma etapa de foley separada para acrescentar.
Clipes sociais de giro rápido que precisam de som desde o início
Como o áudio é gerado na mesma passada que a imagem, este endpoint serve para qualquer clipe curto destinado direto a um feed ou reel, onde esperar por uma etapa separada de design de som atrasaria a publicação.
Guia de prompt e dicas práticas
Escreva a tomada na ordem em que acontece
Estruture o prompt como assunto, ação, câmera, e então som. O prompt da salsa na cozinha é um modelo funcional: quem está dançando e o que está vestindo, o que fazem (giram, esbarram no balcão), a câmera (plano médio, câmera na mão suave), e então o som (música, risadas, a panela borbulhando).
Combine o som com a ação, não só com o clima
Nomeie sons que são causados por algo em quadro — passos no concreto, uma panela borbulhando, o motor de uma scooter — em vez de uma trilha de clima genérica. Nos nossos testes, o som ligado a uma ação visível renderizou de forma mais consistente e sincronizada com a imagem do que uma indicação ambiente sem nada em quadro para produzi-la.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.











