Introdução
O Kling O3 Referência para vídeo monta uma cena a partir de até 7 fotos de referência — personagens, roupas, objetos ou lugares — em vez de uma única imagem inicial. Numere as referências no prompt (<<<image_1>>>, <<<image_2>>>, e assim por diante) e diga o que cada uma contribui; 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, uma proporção e se quer gerar áudio nativo.
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
Várias referências, uma cena
Diferente da imagem para vídeo, que parte de uma única imagem, a referência para vídeo pega até 7 fotos separadas e combina o que cada uma mostra. Nosso exemplo do vagão-restaurante usou três: um homem, um cômodo e um objeto, reunidos em uma cena que nenhuma das três fotos mostrava sozinha.
Cada referência faz uma função
O prompt é onde você atribui a função: "<<<image_1>>> is the man, keep his coat and stubble" é o que mantém aquele rosto e figurino intactos, em vez de o modelo misturá-los com as outras referências.
Som gerado com a cena montada
generate_audio acrescenta ambiência, efeitos e diálogo na mesma passada. Mantenha expectativas realistas para som de fundo descrito só em uma frase ou duas — ele pode renderizar baixo na mixagem final, em vez de como uma camada dominante.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Diga o que cada referência numerada é (<<< |
reference_image_urls | Sim | Até 7 fotos de referência para personagens, objetos, roupas ou lugares. JPEG ou PNG. pelo menos 1 itens · no máximo 7 itens |
reference_video_urls | Não | Vídeo de referência opcional, um único clipe, do qual a nova tomada aproveita movimento, câmera ou personagens; cite-o no prompt como <<< |
elements | Não | Um sujeito nomeado para execuções em 4K: dê a ele um nome, uma descrição de uma linha e de 2 a 4 fotos da mesma pessoa ou objeto (amostras de voz de 5 a 30 segundos são opcionai… no máximo 1 itens |
aspect_ratio | Não | 16:9, 9:16 ou 1:1. Escolha antes de escrever a tomada para que a composição se encaixe. |
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: |
keep_original_audio | Não | Mantém no resultado o som original do vídeo de referência. Ligado por padrão; só faz diferença quando você passa um vídeo de referê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 (não é uma garantia rígida). multi deixa o modelo dividir a cena em várias tomadas sozinho. |
multi_prompt | Não | A lista de tomadas para |
Preços
Cobrado por segundo de saída. A taxa depende da resolução, de o áudio nativo estar ativado e de você passar um vídeo de referência.
| Especificação | Preço |
|---|---|
| $0.0672 / segundo |
| $0.0896 / segundo |
| $0.419 / segundo |
| $0.0896 / segundo |
| $0.112 / segundo |
| $0.419 / segundo |
| $0.1008 / segundo |
| $0.1344 / segundo |
Casos de uso
Coloque uma pessoa em um lugar onde ela nunca foi fotografada
Dê a um rosto sua própria referência e a um lugar a sua própria referência, e descreva a ação que os coloca juntos — o tipo de cena que uma única foto de qualquer um dos dois não conseguiria fornecer sozinha.
Mantenha um adereço ou uma roupa consistente entre cenas
Referencie um objeto específico — uma joia, um carro, uma roupa característica — junto com uma referência de personagem, e ele se repete corretamente, em vez de ser redesenhado ligeiramente diferente a cada execução.
Construa uma cena em torno de três elementos planejados
Quando uma cena depende de uma pessoa específica, um cenário específico e um objeto específico aparecendo todos juntos — como uma carta, um cômodo e quem a lê — as referências permitem travar os três, em vez de descrevê-los do zero em prosa.
Guia de prompt e dicas práticas
Numere cada referência e nomeie sua função
Escreva "<<<image_1>>> is X, keep Y" para cada referência em ordem. Este é o fator isolado mais importante para saber se uma referência se mantém limpa ou acaba se misturando com as outras.
Use três ou quatro fotos claras em vez de sete sobrepostas
Mais referências não são automaticamente melhores. Um punhado de fotos claras e distintas — uma para o rosto, uma para a roupa, uma para o cômodo — mantém a identidade melhor do que sete fotos que se sobrepõem no que mostram.
Descreva o som como uma camada de fundo
Quando você pede ambiência como chuva ou rodas de trem junto com diálogo, espere que fique baixo na mixagem. Se a ambiência precisa ser proeminente, diga isso explicitamente, em vez de listá-la rapidamente junto com o diálogo.
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/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"generate_audio": false,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"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.












