Introdução
Kling 4.0 Texto para vídeo transforma um roteiro escrito em um clipe de 3 a 30 segundos em 720p ou 1080p, em 16:9, 9:16, 1:1 ou 21:9 ultralargo. Todo clipe volta com uma trilha estéreo gerada na mesma passagem: diálogos que você escreve entre aspas, efeitos e ambiente. Não há chave de áudio e não há custo extra por isso.
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 (você está aqui) |
| um quadro inicial, e opcionalmente um quadro final e quadros intermediários | Kling 4.0 Imagem para vídeo |
| fotos, clipes ou amostras de voz para montar o elenco | Kling 4.0 Referência para vídeo |
Recursos e destaques
Até 30 segundos em uma só tomada
As durações vão de 3 a 30 segundos inteiros, o dobro do teto do Kling 3.0. Uma tomada longa deixa a cena respirar — um guindaste lento, uma travessia completa do cenário — sem emendar clipes mais curtos.
Som sempre ligado
Cada clipe traz uma trilha de dois canais. Nos nossos testes, o ronco do motor da cúpula, o vento e uma fala sussurrada vieram todos da linha Sound: do prompt, sincronizados com a imagem.
21:9 ultralargo
Além de 16:9, 9:16 e 1:1, o Kling 4.0 renderiza um quadro 21:9 de verdade. Nosso teste ultralargo em 1080p saiu em 2200x940.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva o sujeito, a ação, a câmera e o som. Coloque as falas entre aspas e o som em uma linha própria. pelo menos 1 caracteres |
aspect_ratio | Não | 16:9 (padrão), 9:16, 1:1 ou 21:9 ultralargo. 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
Planos de abertura com som
Uma paisagem, um prédio, uma estrada ao entardecer — descreva o lugar, a luz, um movimento de câmera e o ambiente, e o clipe já serve como abertura com o som no lugar.
Cenas curtas com uma fala
Coloque a fala entre aspas depois da ação. Uma fala clara por clipe é mais fácil de sincronizar para o modelo do que diálogos sobrepostos.
Vídeos verticais para redes sociais
Escolha 9:16 e enquadre o sujeito no terço central; o modelo compõe para o quadro vertical em vez de recortar uma imagem horizontal.
Guia de prompt e dicas práticas
Escreva na ordem em que acontece
Sujeito e figurino, ação, movimento de câmera, aparência e, em seguida, uma linha Sound: separada. O nosso exemplo do observatório segue exatamente essa ordem.
Rascunhe curto e depois alongue
A geração é lenta: um teste de 3 segundos levou de dois a quatro minutos, e as requisições rodam uma após a outra, não em paralelo. Encontre o enquadramento com 3 a 5 segundos em 720p e depois renderize a versão longa ou em 1080p.
Descreva o som que você quer
Como o áudio é sempre gerado, deixar o som de fora do prompt não dá silêncio — dá o que o modelo escolher. Nomeie o ambiente que você quer ou escreva "silêncio de sala".
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/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.










