Introdução
Extensão de vídeo do Kling 4.0 dá continuidade a um clipe que você já tem. Envie um vídeo de até 60 segundos e, se quiser, um prompt para o que acontece em seguida. O último quadro do seu clipe vira o quadro inicial de um novo segmento de 3 a 30 segundos, feito com o modo imagem para vídeo do Kling 4.0. Você recebe um único MP4 com o original e o novo segmento unidos, e também o novo segmento sozinho.
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 |
| um clipe que você quer continuar | Kling 4.0 Extensão de vídeo (você está aqui) |
Recursos e destaques
O último quadro define a cena
O novo segmento começa no seu quadro final, então as pessoas, o cenário e a luz se mantêm. O movimento não se mantém da mesma forma, porque o modelo vê apenas uma imagem parada. Descreva o movimento que você quer continuar.
Escolha onde termina
Adicione last_image_url e o novo segmento termina nessa imagem. Se você não a incluir, o modelo decide como o segmento termina.
Um arquivo de volta, mais o trecho novo
O arquivo unido mantém a taxa de quadros e o enquadramento do seu clipe, sem barras pretas. Para alinhar a emenda, a imagem pode ser cortada ou ajustada em alguns por cento nas bordas, e o som faz crossfade na emenda. Seu clipe mantém o próprio som, e o novo segmento sempre tem som estéreo gerado.
A forma segue o seu clipe
Não há configuração de proporção. O novo segmento segue a forma da sua origem.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Não | Opcional. Descreva o que acontece em seguida: a ação, a câmera e o som. pelo menos 1 caracteres |
video_url | Sim | O clipe a continuar, em MP4 ou WebM, de até 60 segundos. O último quadro dele abre o novo segmento, então termine-o em um quadro limpo e nítido. pelo menos 1 caracteres |
last_image_url | Não | Quadro final opcional. O novo segmento deve terminar nesta imagem. |
resolution | Não | 720p (padrão) ou 1080p. Use a mesma resolução da origem para que a emenda não mostre uma mudança de nitidez. |
duration_seconds | Não | Duração do novo segmento: um número inteiro de 3 a 30 segundos (padrão 5). Define o preço. |
Preços
Cobrado por segundo do novo segmento, na taxa de imagem para vídeo da resolução escolhida. O clipe de origem que você envia não é cobrado. Requisição recusada ou com falha não é cobrada.
| Especificação | Preço |
|---|---|
| $0.1884 / segundo |
| $0.282 / segundo |
Casos de uso
Termine um plano que acabou cedo demais
Uma caminhada que para antes da porta, um movimento de câmera que corta no meio: estenda-o por alguns segundos e descreva apenas o que ainda falta acontecer.
Monte uma cena mais longa aos poucos
Estenda um clipe e depois estenda o resultado unido de novo. Cada etapa é cobrada só pelos segundos que acrescenta.
Chegue a um quadro final planejado
Dê um quadro final e o clipe chega à composição que você precisa, como um produto de volta ao ângulo principal.
Guia de prompt e dicas práticas
Descreva o próximo momento, não a cena inteira
O quadro já mostra quem e onde. Use o prompt para a ação seguinte, a câmera e o som. Sem prompt, o modelo dá continuidade à cena sozinho.
Termine a origem em um quadro limpo
O último quadro é tudo o que o modelo vê. Um final borrado ou cortado pela metade passa direto para o novo segmento, então corte antes o seu clipe em um quadro nítido.
Use a mesma resolução
Escolha a mesma resolução da sua origem para que a emenda não mostre uma mudança de nitidez. Faça o rascunho com um segmento curto e depois peça o mais longo.
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-extend",
"input": {
"duration_seconds": 5,
"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.










