Introdução
O FLUX 3 Ampliação de vídeo aumenta um clipe de vídeo pronto de 1,5 a 3 vezes. Ele aceita um MP4 de até 20 segundos, mantém a proporção e o som original e oferece um modo precise, fiel à origem, e um modo creative, que reconstrói detalhes finos.
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
Precise e creative
O precise só aumenta a nitidez: no nosso teste em 2x, a barba por fazer, as bordas do cabelo e as dobras do tecido ficaram mais nítidas, sem detalhes inventados. O creative também reconstrói detalhes finos, guiado opcionalmente por um prompt, e custa mais.
Preço pela duração, não pelo fator
A cobrança acompanha a duração do clipe de entrada, arredondada para cima em segundos inteiros. Ampliar em 1,5x ou em 3x custa o mesmo.
Som mantido
A faixa de áudio original permanece com o clipe ampliado.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
video_url | Sim | O clipe a ampliar, um MP4 de até 20 segundos. Cobrado pela duração dele, arredondada para cima em segundos inteiros. pelo menos 1 caracteres |
upscale_mode | Não | precise (padrão) é fiel à origem e aumenta a nitidez; creative também reconstrói detalhes finos e custa mais. |
upscale_factor | Não | Quantas vezes maior, de 1,5 a 3; 2 por padrão. A proporção é mantida e o fator não altera o preço. |
prompt | Não | Opcional e usado só no modo creative: o detalhe que você quer acrescentar, como textura de pele ou trama de tecido. Até 5.000 caracteres. pelo menos 1 caracteres · no máximo 5000 caracteres |
Preços
Cobrado por segundo do clipe de entrada, arredondado para cima em segundos inteiros. O fator de ampliação não altera o preço. O modo creative custa mais que o precise. Pedidos recusados e com falha não são cobrados.
| Especificação | Preço |
|---|---|
| $0.528 / segundo |
| $0.7584 / segundo |
Casos de uso
Preparar um corte final
Renderize e edite em 720p e amplie só os clipes que você mantiver.
Resgatar um rascunho
Leve um bom clipe do nível de rascunho a um tamanho maior.
Tamanhos de entrega
Escolha um fator entre 1,5x e 3x para combinar com a sua saída.
Guia de prompt e dicas práticas
Comece pelo precise
Ele não mexe no conteúdo e é o modo mais barato.
Use o creative com moderação
Escolha-o só quando a filmagem precisar de detalhes reconstruídos e descreva no prompt a textura que você quer.
Não espere que o detalhe ausente volte
Elementos pequenos que estão borrados na origem continuam borrados.
Planeje o tempo
O nosso teste em 2x de um clipe de cinco segundos levou cerca de 17 minutos.
Fique atento ao tamanho do arquivo
Um clipe em 2x saiu com cerca de 17 MB para cinco segundos.
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/upscale",
"input": {
"upscale_mode": "precise",
"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.


























