Introdução
O Kling 3.0 Imagem para vídeo pega uma imagem inicial (image_url) e um prompt descrevendo o que acontece depois dela, e retorna de 3 a 15 segundos em 720p, 1080p ou 4K. Defina last_image_url para fixar também uma imagem final, para que o clipe precise chegar em algum lugar específico, em vez de só começar em algum lugar. Ative generate_audio para diálogo e ambiência gerados junto com a imagem.
Escolha um modo do Kling 3.0 pelo material de partida
| O que você tem no início | Modo |
|---|---|
| uma cena ou roteiro escrito | Kling 3.0 Texto para vídeo |
| uma imagem inicial, e opcionalmente uma final | Kling 3.0 Imagem para vídeo (você está aqui) |
| uma foto de personagem e um vídeo de referência | Kling 3.0 Motion Control |
Recursos e destaques
Uma imagem inicial e, se você definir, uma final
O clipe começa na sua imagem exatamente como ela é. Acrescente last_image_url e a Kling trabalha em direção a essa imagem, em vez de um final aberto — no nosso teste de uma caminhada por um píer coberto de neblina, a última imagem do clipe combinou quase exatamente com a imagem final, cachecol vermelho e tudo.
A imagem decide o visual, o prompt decide o movimento
Descreva só a ação, a câmera e o som — não o figurino ou o cenário, que a imagem inicial já fixa. Nosso exemplo do raio no pátio nunca redescreve a mulher ou o posto de gasolina a partir da sua imagem; ele só acrescenta o relâmpago, a caminhada dela na chuva e o trovão.
A proporção segue a imagem
Não há um campo aspect_ratio separado aqui: a saída assume o formato da sua imagem inicial, de uma paisagem larga a um corte de retrato alto.
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, a câmera e, com o som ativado, o som. pelo menos 1 caracteres · no máximo 2500 caracteres |
negative_prompt | Não | O que você não quer no clipe (objetos, visuais ou movimentos), até 2.500 caracteres. Opcional; não muda o preço. no máximo 2500 caracteres |
image_url | Sim | Imagem inicial. O clipe começa a partir dessa imagem e toma sua proporção dela. |
last_image_url | Não | Imagem final opcional. Em clipes longos, o meio pode divagar mais do que as pontas permanecem fixas. |
resolution | Não | 720p, 1080p ou 4K. Níveis mais altos custam mais por segundo. |
generate_audio | Não | Acrescenta uma trilha sonora gerada ao mesmo clipe. Em 720p e 1080p custa mais por segundo do que uma execução silenciosa; em 4K o preço não muda com o som ligado ou desligado. Valor padrão: |
duration_seconds | Não | Segundos inteiros, de 3 a 15. Influencia o preço. |
shot_type | Não | single mantém uma configuração na maior parte da execução, mas ainda pode cortar por conta própria; multi deixa a Kling cortar sua própria edição de múltiplas tomadas. |
multi_prompt | Não | A lista de tomadas para |
guidance_scale | Não | O quanto o clipe segue o prompt, de 0 a 1 (padrão 0,5). Valores mais altos seguem o texto mais de perto; mais baixos dão mais liberdade ao modelo. |
Preços
Cobrado por segundo de saída. A resolução e a chave de áudio mudam a taxa.
| Resolução | Gerar áudio: Não | Gerar áudio: Sim |
|---|---|---|
| $0.0672 / segundo | $0.1008 / segundo |
| $0.0896 / segundo | $0.1344 / segundo |
| $0.336 / segundo | $0.336 / segundo |
Casos de uso
Continue um personagem exatamente como projetado
Quando uma pessoa precisa parecer a mesma de um clipe para o outro, gere ou escolha uma imagem primeiro, e então anime-a aqui em vez de escrever um novo prompt de texto para vídeo que deixaria o figurino e o rosto ao acaso de novo.
Termine um clipe em um desfecho específico
Defina uma imagem final quando o último instante da tomada importar — uma expressão sustentada, uma mão na porta, uma figura entrando em foco — em vez de deixar o desfecho para o modelo.
Teste um produto ou uma foto de moda em movimento
Uma foto parada de um produto ou uma roupa, com um prompt para um movimento de câmera simples, já basta para ver como uma imagem estática soa uma vez que se move e, com áudio ativado, soa também em som.
Guia de prompt e dicas práticas
Descreva só o que a imagem ainda não mostra
Nosso exemplo do raio no pátio se atém ao que acontece depois da imagem parada: o clarão, o passo dela saindo do caminhão, a caminhada até a chuva forte. Ele nunca repete a roupa dela ou o cenário, que a imagem já fixou.
Trave a tomada quando a continuidade importar
Ao longo de 15 segundos, um detalhe no fundo pode divagar. Se um objeto ou layout específico precisa permanecer no lugar, nomeie-o diretamente ("the same red truck stays parked behind her the whole time") em vez de presumir que a imagem inicial fixa isso pelo clipe inteiro.
Diga "one continuous shot, no cuts" para um take único e ininterrupto
Nosso exemplo da amurada do iate cortou para um segundo ângulo e mudou de entardecer para luz do dia na primeira tentativa; acrescentar essa linha ao início do prompt, junto com uma descrição da luz permanecendo a mesma, manteve tanto o enquadramento quanto a cor ao longo do clipe inteiro no reteste.
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/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.












