Introdução
O modo de referência para vídeo do Kling 4.0 Flash gera uma cena nova em 720p com um prompt obrigatório e as referências enviadas. Adicione até 10 imagens e até 5 clipes de vídeo, com duração combinada de 20 segundos. Identifique as imagens como @Image1 e os vídeos como @Video1, continuando a numeração na ordem de envio.
Explique no prompt a contribuição de cada referência. No exemplo do deserto, uma imagem identifica a personagem e dois vídeos orientam o movimento de câmera em uma cena ao anoitecer. Os novos clipes duram de 3 a 20 segundos inteiros, com padrão de 5 segundos e áudio sincronizado; keep_original_audio permite manter o som de um vídeo de referência. Arquivos de áudio de referência não são aceitos.
Recursos e destaques
- Associe até 10 imagens de referência a personagens, objetos ou detalhes da cena no prompt.
- Oriente movimento e enquadramento com até 5 vídeos, sem ultrapassar 20 segundos no total.
- Use as identificações @Image1 e @Video1 para relacionar a descrição da cena aos arquivos enviados.
- Gere um resultado em 720p de 3 a 20 segundos com áudio ou preserve o som do vídeo de referência com
keep_original_audio. - Acompanhe o enquadramento da entrada com auto ou selecione 16:9, 9:16, 1:1 ou 21:9.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Instruções de cena obrigatórias, sem texto predefinido; atribua funções a @Image1, @Image2, @Video1 e aos demais arquivos enviados. O texto do prompt não gera cobrança à parte. pelo menos 1 caracteres |
reference_image_urls | Não | Envie até 10 URLs de imagens e identifique-as como @Image1, @Image2 e assim por diante na ordem de envio. Elas orientam a cena sem alterar o preço. pelo menos 1 itens · no máximo 10 itens |
reference_video_urls | Não | Envie até 5 URLs de vídeos que somem 20 segundos e identifique-os como @Video1, @Video2 e assim por diante. pelo menos 1 itens · no máximo 5 itens |
aspect_ratio | Não | Escolha auto para seguir as referências ou selecione 16:9, 9:16, 1:1 ou 21:9. O formato do quadro não afeta a taxa por segundo nem gera cobrança adicional. |
keep_original_audio | Não | Defina true para manter o som do vídeo de referência ou false para gerar uma trilha nova; essa opção se aplica quando há um vídeo de referência. Valor padrão: |
duration_seconds | Não | A duração da saída aceita segundos inteiros de 3 a 20 e usa 5 segundos por padrão. Ela altera o total cobrado pela duração de saída faturada. |
Preços
$0.113 / segundo
A geração com referências é cobrada por segundo de saída. Incluir um vídeo de referência aplica uma taxa por segundo mais alta à duração de saída; a duração do vídeo de referência não é cobrada separadamente. Imagens de referência, texto do prompt, proporção e keep_original_audio não geram cobrança à parte. Requisições recusadas pela moderação do Kling não são cobradas.
Casos de uso
- Leve a personagem de uma imagem para uma cena no deserto para redes sociais, orientada por clipes curtos de movimento.
- Explore a combinação de personagem e local com imagens de referência identificadas separadamente.
- Crie vários rascunhos de cenas curtas em torno de um movimento de câmera escolhido para avaliar o conteúdo.
Guia de prompt e dicas práticas
- Identifique a função de cada imagem, como “@Image1 fornece a personagem”, antes de descrever a nova cena.
- Explique o que aproveitar de um vídeo, como “use a aproximação lenta de câmera de @Video1”, para dar uma finalidade definida à referência.
- Descreva o novo cenário, como “um deserto silencioso ao anoitecer”, para distinguir a cena solicitada do material de referência.
- Mantenha a ação solicitada concisa, como “a viajante para ao lado da placa”, ao criar um rascunho de 3 segundos.
- Ao gerar uma trilha nova, inclua uma indicação como “Som: vento seco e um trem distante” para orientar o áudio incluído.
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-flash/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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.
