Introdução
Edição de vídeo do Kling 4.0 muda um vídeo que você já tem, em vez de criar um do zero. Envie um clipe de 3 a 30 segundos e escreva o que deve mudar: um sujeito, o cenário, o clima, a hora do dia ou o estilo. A cena, o sujeito e o movimento permanecem como foram filmados. Você pode adicionar até 10 imagens de referência para trazer uma pessoa, um objeto ou um visual. Os resultados voltam em 720p ou 1080p, com som.
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 |
| um clipe que você quer alterar | Kling 4.0 Edição de vídeo (você está aqui) |
| um clipe que você quer continuar | Kling 4.0 Extensão de vídeo |
Recursos e destaques
Mantém a cena e o movimento
O modelo segue o seu clipe de origem, então o movimento de câmera, a pose e o tempo se mantêm. No nosso teste, um homem apoiado em um conversível antigo em um posto de gasolina no deserto virou uma nevasca forte: a neve se acumulou no capô e na cobertura, e a pose dele, o mapa de estradas, o carro e o movimento lento de travelling continuaram iguais à origem.
Troque uma pessoa a partir de uma imagem de referência
Envie um retrato como @Image1 e diga quem ele substitui. No nosso teste, a astrônoma do nosso clipe do observatório virou a mulher do retrato de referência — cabelo, rosto e jaqueta de veludo cotelê —, enquanto a mão no volante, o giro da cabeça e a subida do guindaste se mantiveram quadro a quadro.
Cite seus uploads no prompt
Chame o clipe de @Video1 e as imagens de referência de @Image1, @Image2 e assim por diante, na ordem em que você as enviou. Diga qual é qual e depois diga o que mudar.
O som pode ficar ou ser novo
keep_original_audio vem ligado por padrão e mantém o som próprio do clipe de origem. Desligue-o e o modelo gera um áudio novo, sincronizado.
A duração segue a origem, ou você define
Deixe a duração em “Match source” (igualar à da origem) e o resultado terá o mesmo tempo do seu clipe, arredondado para o segundo inteiro. Ou escolha qualquer número inteiro de 3 a 30 segundos.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva a edição. Chame o clipe de origem de @Video1 e as imagens de referência de @Image1, @Image2 e assim por diante, na ordem de envio. pelo menos 1 caracteres |
video_url | Sim | O clipe a editar, em MP4 ou WebM, de 3 a 30 segundos. A cena, o sujeito e o movimento são mantidos. pelo menos 1 caracteres |
reference_image_urls | Não | Opcional, até 10 imagens de uma pessoa, um objeto ou um estilo a trazer, de 10 MB cada. Cite-as como @Image1, @Image2 na ordem de envio. pelo menos 1 itens · no máximo 10 itens |
aspect_ratio | Não | auto (padrão) segue o clipe de origem; 16:9, 9:16, 1:1 ou 21:9 você define. Não altera o preço. |
resolution | Não | 720p (padrão) ou 1080p. 1080p custa mais por segundo. |
keep_original_audio | Não | Ligado por padrão, o que mantém o som próprio do clipe de origem. Desligue-o e o modelo gera um áudio novo e sincronizado. Valor padrão: |
duration_seconds | Não | Duração do resultado: um número inteiro de 3 a 30 segundos, ou -1 para “Match source” (padrão), que segue o clipe de origem arredondado para o segundo inteiro. |
Preços
Cobrado por segundo na taxa de edição, sobre os segundos de saída mais os segundos do clipe de origem. A origem é contada como no mínimo tão longa quanto a saída, em segundos inteiros, até 30 segundos. 1080p custa mais por segundo do que 720p. Imagens de referência e a chave de som não alteram o preço. Requisição recusada ou com falha não é cobrada.
| Especificação | Preço |
|---|---|
| $0.1128 / segundo |
| $0.1692 / segundo |
Casos de uso
Mude o clima ou a hora do dia
Mantenha um plano de que você já gosta e transforme uma tarde ensolarada em neve, chuva ou entardecer sem filmar de novo.
Troque o cenário ou o estilo
Leve a mesma atuação para outro lugar, ou redefina o estilo de um clipe enquanto o movimento permanece igual.
Traga uma pessoa ou um objeto
Adicione imagens de referência quando a edição precisar de algo que a origem nunca mostrou, como uma jaqueta específica, um carro ou um personagem.
Guia de prompt e dicas práticas
Diga o que deve permanecer igual
Nomeie as partes a proteger: “mantenha o homem, os movimentos dele e o movimento de câmera como estão”. Depois descreva a mudança. Isso evita que o modelo refaça mais do que você pretendia.
Espere um clipe um pouco mais longo com “Match source”
Com a duração em “Match source”, o resultado tem a duração da origem arredondada para o segundo inteiro, e o modelo continua o movimento por essa última fração. Um clipe de origem de 5,04 segundos voltou com 6,04 segundos no nosso teste. O som próprio da origem termina um instante antes da imagem.
Use referências só para o que é novo
Imagens de referência servem para algo que o clipe ainda não contém. Para uma mudança como clima ou hora do dia, o prompt sozinho costuma bastar.
Escolha 1080p quando o trabalho pedir
Faça um rascunho em 720p para conferir a mudança e depois renderize em 1080p quando o resultado estiver certo. 1080p custa mais por segundo.
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/video-edit",
"input": {
"aspect_ratio": "auto",
"duration_seconds": -1,
"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.










