Introdução
O Kling O3 Edição de vídeo muda um vídeo que você já tem, em vez de gerar um do zero. Envie o clipe de origem e escreva um prompt descrevendo só o que deve mudar — estação, figurino, cenário, estilo — e tudo o que você deixar de fora permanece como foi filmado. Opcionalmente acrescente até 4 fotos de referência para incluir um novo personagem, roupa ou objeto. O resultado dura exatamente o mesmo tempo do seu clipe de origem, de 3 a 10 segundos, em 720p ou 1080p.
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
Muda só o que você nomeia
O prompt é uma lista de mudanças, não uma descrição completa da cena: diga que a estação deve virar neve, ou que o figurino deve trocar para um casaco de inverno, e o enquadramento, o movimento e o ritmo do clipe de origem seguem intocados.
Duração e formato seguem sua origem
Não há campo de duração para definir — o clipe editado segue a duração do vídeo que você enviou, de 3 a 10 segundos, e sua resolução fica limitada a 720p ou 1080p, em vez do 4K disponível nos outros três modos.
Fotos de referência para o que a origem nunca mostrou
Acrescente até 4 imagens de referência quando a edição precisa introduzir algo que o clipe de origem não contém — uma roupa, adereço ou visual específico e novo — junto com as mudanças descritas no prompt.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Diga o que mudar — o assunto, a roupa, o cenário, o estilo ou o clima. Tudo o que você não mencionar permanece como está no clipe editado. pelo menos 1 caracteres · no máximo 2500 caracteres |
video_url | Sim | Clipe de origem para editar, de 3 a 10 segundos, com pelo menos cerca de 720 pixels no lado mais curto. O resultado editado dura exatamente o mesmo tempo desse clipe. |
elements | Não | Um sujeito nomeado para colocar no clipe editado: 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… no máximo 1 itens |
reference_image_urls | Não | Opcional, até 4 fotos de referência para um novo personagem, roupa, objeto ou estilo a incluir na edição. JPEG ou PNG. pelo menos 1 itens · no máximo 4 itens |
resolution | Não | 720p ou 1080p. O nível mais alto custa mais por segundo. |
keep_original_audio | Não | Mantém no resultado editado o som original do clipe de origem. Ligado por padrão. Valor padrão: |
Preços
Cobrado por segundo da duração do seu vídeo de origem (3 a 10 segundos), por resolução.
| Especificação | Preço |
|---|---|
| $0.1252 / segundo |
| $0.168 / segundo |
Casos de uso
Reaproveite um clipe em outra estação ou clima
Pegue uma cena que você já gosta e mude só a estação ou o clima — de verão para neve, de céu claro para chuva — sem refilmar ou regerar a cena inteira do zero.
Troque o figurino ou o cenário de uma tomada aprovada
Quando o enquadramento e a atuação de um clipe estão certos, mas a roupa ou o lugar atrás do assunto precisa mudar, a edição de vídeo atualiza só esse elemento.
Reestilize um clipe que você já gerou em outro lugar
Traga um vídeo de uma execução de texto para vídeo ou imagem para vídeo neste ou em outro modelo e leve-o para um estilo visual diferente usando o prompt, opcionalmente guiado por fotos de referência.
Guia de prompt e dicas práticas
Escreva como uma lista de mudanças, não uma cena
Parta do que já existe no clipe e nomeie as diferenças: "change the season to snow," "put him in a charcoal coat instead." Uma descrição completa da cena convida o modelo a refazer mais do que você pretendia.
Confira primeiro as dimensões do seu vídeo de origem
A origem precisa ter cerca de 720 pixels ou mais no lado mais curto. Um clipe pequeno demais será recusado antes de a geração começar, então verifique isso antes de uma tarefa que também inclui fotos de referência.
Acrescente referências só para o que a edição introduz
Fotos de referência servem para trazer algo novo para a cena — uma roupa, um objeto, um visual que o clipe de origem não tem. Para mudanças puramente descritivas, como uma troca de estação ou cor, o prompt sozinho costuma bastar.
Detalhe o figurino distinto por pessoa
Quando um clipe tem mais de uma pessoa e cada uma precisa de uma roupa nova diferente, nomeie-as separadamente — "the rider in front in a navy coat, the one behind in a grey coat" — em vez de uma descrição compartilhada. Sem especificar, nosso teste de inverno deu o mesmo casaco aos dois ciclistas.
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/video-edit",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.












