Introdução
O Kling O3 Texto para vídeo transforma um prompt escrito em um clipe de 3 a 15 segundos, sem envolver imagem ou referência. Escolha uma duração em segundos inteiros, uma resolução de 720p a 4K, e se quer gerar áudio nativo junto com a imagem. O campo de prompt aceita até 2.500 caracteres, o suficiente para descrever o assunto, a ação, a câmera e, com o som ativado, o diálogo.
Escolha um modo do Kling O3 pelo material de partida
| O que você tem no início | Modo |
|---|---|
| uma cena escrita e nada mais | Kling O3 Texto para vídeo |
| uma imagem inicial aprovada | Kling O3 Imagem para vídeo |
| até 7 fotos de referência | Kling O3 Referência para vídeo |
| um vídeo que você já tem | Kling O3 Edição de vídeo |
Recursos e destaques
Cortes em múltiplas tomadas por conta própria
Defina shot_type como multi e descreva mais de uma tomada no prompt — um plano geral, um close, um ângulo baixo — e o Kling O3 corta entre elas em um único clipe, mantendo o cenário e as pessoas consistentes de uma tomada para a outra. Nosso exemplo do tango encharcado de chuva é um único prompt descrevendo três tomadas em ordem, e o clipe pronto cortou para cada uma no momento certo.
Áudio nativo na mesma passada
Ative generate_audio e diálogo, efeitos e ambiência são gerados junto com a imagem, em vez de acrescentados depois. Diálogo escrito entre aspas volta sincronizado com a ação: as duas falas do nosso exemplo do clube de jazz bateram com o prompt palavra por palavra.
720p até 4K, um único prompt
As três resoluções renderizam a partir do mesmo prompt, então o padrão mais comum é rascunhar em 720p até a tomada e o diálogo funcionarem, e então rodar de novo a melhor versão em 1080p ou 4K. Resolução e áudio influenciam o preço.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva o assunto, a ação, a câmera e, com o som ativado, o diálogo e os sons. Para um prompt de múltiplas tomadas, numere as tomadas em ordem. pelo menos 1 caracteres · no máximo 2500 caracteres |
aspect_ratio | Não | 16:9, 9:16 ou 1:1. Escolha antes de escrever a tomada para que o prompt posicione pessoas e enquadramento para esse formato. |
resolution | Não | 720p, 1080p ou 4K. Níveis mais altos custam mais por segundo. |
generate_audio | Não | Acrescenta uma trilha sonora gerada — diálogo entre aspas, efeitos, ambiência — na mesma passada. Valor padrão: |
duration_seconds | Não | Segundos inteiros, de 3 a 15. Influencia o preço junto com resolução e áudio. |
shot_type | Não | single pede uma tomada contínua única (não é uma garantia rígida — acrescente "one continuous shot, no cuts" no prompt se um corte aparecer mesmo assim). |
multi_prompt | Não | A lista de tomadas para |
Preços
Cobrado por segundo de saída. A taxa depende da resolução e de o áudio nativo estar ativado.
| Resolução | Gerar áudio: Não | Gerar áudio: Sim |
|---|---|---|
| $0.0672 / segundo | $0.0896 / segundo |
| $0.0896 / segundo | $0.112 / segundo |
| $0.336 / segundo | $0.336 / segundo |
Casos de uso
Abra uma cena sem nenhuma imagem em mãos
Texto para vídeo é o único modo do Kling O3 que não precisa de nada além de palavras. Use quando a tomada existe só na sua cabeça, ou quando precisa de vários takes rápidos para ver qual enquadramento funciona antes de comprometer uma imagem inicial em imagem para vídeo.
Cubra uma cena em vários ângulos a partir de uma solicitação
Em vez de escrever quatro prompts separados para quatro ângulos, descreva a sequência uma vez e defina shot_type como multi. É o jeito mais rápido de conseguir um plano geral, um close e uma tomada de reação a partir de uma única tarefa.
Teste o timing de diálogo antes de uma edição mais longa
Como o áudio renderiza junto com a imagem, um rascunho curto de texto para vídeo é um jeito rápido de conferir se uma fala soa natural contra a ação, antes de se comprometer com uma execução mais longa ou em resolução maior.
Guia de prompt e dicas práticas
Numere suas tomadas quando quiser um corte
Para um prompt de múltiplas tomadas, organize as tomadas na ordem que você quer e descreva a câmera de cada uma — plano geral, close, ângulo baixo — do jeito que nosso exemplo do tango faz. O Kling O3 usa essa estrutura para decidir onde cortar.
Nomeie a posição da câmera, não só o clima
"Seen from the end of the keyboard so both faces are clear" é uma instrução de câmera real que o modelo consegue seguir; "two men on a piano bench" deixa o ângulo ao acaso, e um ângulo ao acaso pode esconder uma pessoa atrás da outra. Diga onde a câmera está em relação aos seus assuntos sempre que mais de um precisar ficar visível.
Peça uma tomada travada explicitamente
single é uma preferência, não uma garantia — o Kling O3 ainda pode cortar por conta própria. Se uma cena depende de um take único e ininterrupto, acrescente uma linha como "one continuous shot, no cuts, the light staying the same throughout" ao fim do prompt.
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/o3/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"shot_type": "single",
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": false,
"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.












