Introdução
Kling 4.0 Referência para vídeo monta um clipe novo a partir do que você envia: até 10 imagens de referência para pessoas, objetos e lugares, até 5 vídeos de referência (30 segundos no total) para movimento, câmera e ritmo, e até 3 clipes de áudio para uma voz ou um som. Cite cada um no prompt como @Image1, @Image2, @Video1 ou @Audio1, numerados na ordem de envio. Os clipes têm de 3 a 30 segundos em 720p ou 1080p, com trilha estéreo.
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 |
| 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 (você está aqui) |
Recursos e destaques
Imagens, vídeos e vozes em uma só requisição
O Kling 4.0 aceita os três tipos de referência juntos. As imagens definem quem e o que aparece, os vídeos definem como a câmera e o sujeito se movem, e os clipes de áudio definem como alguém soa.
Cite cada referência no prompt
Escreva @Image1, @Image2 e assim por diante na ordem de envio, e diga o que cada uma é. No nosso exemplo do trailer, "@Image1 é a mulher, @Image2 é o trailer cromado" bastou para colocar aquela mulher em frente àquele trailer.
Pegue um movimento de câmera emprestado de um clipe
Um vídeo de referência transmite o seu movimento e ritmo. Ative keep_original_audio para manter o som próprio desse clipe em vez de gerar um áudio novo. Os segundos do vídeo de referência também são cobrados, a uma taxa menor do que os segundos de saída.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Diga o que é cada referência e o que o plano faz com ela. Escreva @Image1, @Image2 para imagens, @Video1 para vídeos e @Audio1 para clipes de áudio, numerados na ordem de envio. pelo menos 1 caracteres |
reference_image_urls | Não | Até 10 imagens de pessoas, objetos, figurinos ou lugares, citadas como @Image1, @Image2 e assim por diante. Não alteram o preço. pelo menos 1 itens · no máximo 10 itens |
reference_video_urls | Não | Até 5 vídeos, 30 segundos no total, para movimento, câmera e ritmo, citados como @Video1, @Video2. pelo menos 1 itens · no máximo 5 itens |
reference_audio_urls | Não | Até 3 clipes de áudio de 5 a 30 segundos cada, para uma voz ou um som, citados como @Audio1, @Audio2. Escreva as palavras faladas no prompt. pelo menos 1 itens · no máximo 3 itens |
aspect_ratio | Não | auto (padrão) segue as imagens ou o vídeo de referência; 16:9, 9:16, 1:1 ou 21:9 você define. Não altera o preço. |
resolution | Não | 720p ou 1080p (padrão 720p). 1080p custa mais por segundo. |
keep_original_audio | Não | Desligado por padrão. Ligado mantém o som próprio do vídeo de referência em vez de gerar uma trilha nova; só faz diferença quando você envia um vídeo de referência. Valor padrão: |
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, mais os segundos de qualquer vídeo de referência (cada clipe arredondado para o segundo inteiro seguinte) a uma taxa menor por segundo. 1080p custa mais por segundo do que 720p. Imagens de referência e clipes de áudio não alteram o preço. Requisição recusada ou com falha não é cobrada.
| Especificação | Preço |
|---|---|
| $0.216 / segundo |
| $0.324 / segundo |
Casos de uso
Coloque uma pessoa em um lugar onde nunca foi fotografada
Um retrato somado a uma foto de um local vira uma cena dessa pessoa ali, com a ação que você descrever.
Mantenha um objeto ou veículo consistente
Dê a um carro, uma motocicleta ou um figurino a sua própria imagem de referência para que ele apareça igual em todos os clipes.
Combine uma voz
Adicione uma amostra de voz de 5 a 30 segundos como @Audio1 e escreva a fala entre aspas; a fala falada segue essa voz.
Guia de prompt e dicas práticas
Abra com a lista do elenco
Comece com uma frase por referência — "@Image1 é o homem, @Image2 é a motocicleta" — e depois descreva o plano.
Poucas referências claras valem mais que muitas parecidas
Uma foto nítida por pessoa ou objeto funciona melhor do que várias quase iguais que o modelo precisa fazer uma média.
Deixe aspect_ratio em auto
No auto, o clipe segue a forma das suas referências; defina a proporção só quando precisar de um enquadramento específico.
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/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.










