Introdução
O Kling O3 Imagem para vídeo anima sua própria imagem inicial. Envie uma imagem, opcionalmente acrescente uma imagem final para fixar o desfecho, e descreva o que acontece entre as duas — o campo de prompt aceita até 2.500 caracteres. Escolha uma duração de 3 a 15 segundos inteiros, uma resolução de até 4K, e se quer gerar áudio nativo junto com a imagem.
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
A imagem inicial é seguida de perto
Quem e o que estiver na sua imagem — as pessoas, o figurino, o ambiente — é o que o clipe mantém. No nosso exemplo do guarda-chuva, os rostos das duas mulheres bateram com a imagem inicial do início ao fim de um clipe de cinco segundos; o prompt só teve que descrever a nova ação.
Uma imagem final opcional fixa o desfecho
Acrescente last_image_url e o clipe é construído para chegar naquela imagem, em vez de onde o modelo pararia por conta própria. Mantenha as duas imagens próximas em luz, ângulo e enquadramento — um salto grande entre elas é o que faz o meio de um clipe longo divagar.
Som gerado com o movimento
generate_audio acrescenta diálogo, efeitos e ambiência na mesma passada que a animação, sincronizados com a ação que você descreve, em vez de acrescentados depois em uma etapa separada.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva só o que acontece depois da imagem inicial: a ação, o movimento de câmera e, com o som ativado, o diálogo e os efeitos. A imagem já definiu quem e onde. pelo menos 1 caracteres · no máximo 2500 caracteres |
image_url | Sim | Imagem inicial. JPEG ou PNG. |
last_image_url | Não | Imagem final opcional na qual o clipe deve terminar. |
resolution | Não | 720p, 1080p ou 4K. Níveis mais altos custam mais por segundo. |
generate_audio | Não | Acrescenta uma trilha sonora gerada na mesma passada — diálogo entre aspas, efeitos, ambiência. 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 (o Kling O3 ainda pode cortar por conta própria; acrescente "one continuous shot, no cuts" se isso importar). |
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
Anime uma imagem que você já aprovou
Quando as pessoas exatas, o figurino e a composição importam, gere ou selecione a imagem primeiro e envie ela aqui, em vez de deixar esses detalhes para um prompt de texto — que os redesenha do zero a cada execução.
Faça a ponte entre duas imagens que você já tem
Com image_url e last_image_url definidos, o clipe preenche um caminho de movimento crível entre um início aprovado e um final aprovado — útil para uma cena que precisa terminar em uma composição final específica.
Acrescente diálogo a uma imagem que você já gosta
Ative generate_audio e descreva uma fala junto com a ação; a imagem fornece o visual, o prompt fornece o movimento e as palavras.
Guia de prompt e dicas práticas
Descreva o depois, não o que já está lá
Não redescreva quem está na imagem ou o que está vestindo — a imagem já responde isso. Use o prompt para o que muda: a ação, o movimento de câmera, o som.
Mantenha uma imagem final próxima da inicial
Se você usa last_image_url, escolha ou gere uma imagem com luz e enquadramento parecidos com a imagem inicial. Uma correspondência próxima mantém o movimento entre as duas crível; um salto grande pede ao modelo para inventar mais do que ele consegue manter estável.
Trave a tomada quando a continuidade importar
Shot_type single é uma preferência, não uma garantia. Para uma cena que não pode ser cortada — uma única reação ininterrupta, por exemplo — acrescente "one continuous shot, no cuts" 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/image-to-video",
"input": {
"duration_seconds": 5,
"generate_audio": false,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.












