Introdução
O FLUX 3 Extensão de vídeo continua um clipe que você já tem. Ele recebe um MP4 de até 15 segundos, parte do último quadro e gera de 5 a 20 segundos novos com som sincronizado. O resultado é só o novo trecho; a sua origem não está incluída.
Escolha um modo conforme o material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | FLUX 3 Texto para vídeo |
| uma imagem para animar, com um último quadro opcional | FLUX 3 Imagem para vídeo |
| um clipe para continuar | FLUX 3 Extensão de vídeo |
| um clipe para ampliar | FLUX 3 Ampliação de vídeo |
Recursos e destaques
Retoma a partir do último quadro
O novo trecho começa onde o seu clipe terminou, com a mesma pessoa, o mesmo lugar e a mesma luz. No nosso teste, ele abriu com uma breve dissolução antes de a ação seguinte começar.
Só o novo trecho
Você recebe apenas os segundos acrescentados, então o corte final é montado no seu editor junto com o clipe original.
Cobrado pelos segundos novos
O preço acompanha a duração do novo trecho e o nível. Por segundo, custa mais que o texto para vídeo.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Descreva o que acontece em seguida: a ação, a câmera e uma linha Sound: que deem continuidade ao clipe. pelo menos 1 caracteres · no máximo 5000 caracteres |
video_url | Sim | O clipe a continuar, um MP4 de até 15 segundos. O novo trecho retoma a partir do último quadro dele. pelo menos 1 caracteres |
aspect_ratio | Não | Uma entre 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 ou 2:1. Deixe em branco para manter o formato do clipe de origem. |
quality | Não | standard (padrão) renderiza na resolução que você escolher; draft é uma prévia rápida e de menor custo, sempre em 720p ( |
resolution | Não | 720p (padrão) ou 1080p. O 1080p custa mais. |
duration_seconds | Não | Duração do novo trecho em segundos inteiros, de 5 a 20; 5 por padrão. O resultado contém só este trecho, e não o seu clipe de origem. |
generate_audio | Não | Gera som sincronizado com a imagem. Ativado por padrão; desativado, gera um arquivo mudo. Valor padrão: |
Preços
Cobrado por segundo apenas do novo trecho, conforme o nível (draft o mais barato, depois standard 720p e depois standard 1080p). Estender custa mais por segundo que o texto para vídeo. Com o som ligado ou desligado o custo é o mesmo. Pedidos recusados e com falha não são cobrados.
| Resolução | Qualidade: Rascunho | Qualidade: Padrão |
|---|---|---|
| $0.12 / segundo | $0.53 / segundo |
| $0.12 / segundo | $0.41 / segundo |
Casos de uso
Alongar um bom clipe
Pegue um plano de seis segundos de que você gosta e leve a cena adiante.
Montar sequências
Encadeie várias extensões, cada uma com uma ação clara.
Corrigir um final
Mantenha uma primeira metade forte e escreva uma nova continuação.
Guia de prompt e dicas práticas
Escreva a próxima ação
Descreva o que acontece depois do último quadro, e não o que o clipe já mostra. Em nossos testes, pedir que a câmera se afaste ou mude de ângulo gerou um corte para outro plano no meio do clipe; manter o mesmo enquadramento resultou em uma única tomada contínua.
Avance em passos pequenos
O modelo pode pular um movimento intermediário, como andar até outro ponto, então peça diretamente a ação de destino.
Espere uma mistura curta no início
A primeira fração de segundo pode mostrar uma dissolução com algum efeito fantasma; apare isso na edição se incomodar.
Combine o formato
Deixe a proporção em branco para manter o formato da origem.
Confira o som
Acrescente uma linha Sound: para que o novo trecho combine com o antigo.
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": "black-forest-labs/flux-3/video-extend",
"input": {
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"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.


























