Introdução
O FLUX 3 Imagem para vídeo anima uma imagem parada com o modelo de vídeo FLUX 3 da Black Forest Labs. Dê a ele um quadro inicial e, se quiser, um quadro final; ele gera de 5 a 20 segundos de movimento com som sincronizado em 720p ou 1080p.
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
A imagem define o visual
A pessoa, a roupa e o cenário vêm do quadro inicial, então o prompt só precisa descrever a ação, a câmera e o som.
Quadro inicial e final
Com uma última imagem, o clipe vai de uma à outra. Quadros próximos em luz e posição se misturam com suavidade; quadros muito distantes podem gerar um corte seco no meio.
O formato segue a imagem
Deixe a proporção em branco e o clipe mantém o formato do quadro inicial.
Cobrado por segundo
O preço acompanha a duração e o nível (rascunho o mais barato, depois standard 720p e depois standard 1080p); um último quadro e o ajuste de som não custam nada a mais.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Descreva o que acontece depois da imagem inicial: a ação, o movimento de câmera e uma linha Sound:. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_url | Sim | O quadro inicial, enviado ou por link. O assunto mantém o visual dessa imagem. pelo menos 1 caracteres |
last_image_url | Não | Quadro final opcional. O clipe vai da imagem inicial até esta; quando as duas são muito diferentes, o modelo pode usar um corte seco no meio em vez de uma mudança gradual. 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 seguir a imagem inicial. |
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 em segundos inteiros, de 5 a 20; 5 por padrão. Cobrada por segundo, então define o preço junto com o nível. |
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 de vídeo, conforme o nível: o draft é o mais barato, depois o standard 720p e depois o standard 1080p. Com o som ligado ou desligado o custo é o mesmo, e a proporção não altera o preço. Acrescentar um último quadro não altera o preço. Pedidos recusados e com falha não são cobrados.
| Resolução | Qualidade: Rascunho | Qualidade: Padrão |
|---|---|---|
| $0.06 / segundo | $0.29 / segundo |
| $0.06 / segundo | $0.17 / segundo |
Casos de uso
Dar vida a retratos
Um sorriso, uma virada de cabeça, vento no cabelo, com o som de ambiente correspondente.
Movimentos de antes e depois
Mudanças de hora do dia ou de pose, de um quadro inicial a um final.
Fotos de produto e de locação
Um arco lento de câmera em torno de um assunto de que você já tem uma imagem.
Guia de prompt e dicas práticas
Descreva o movimento, não a imagem
A imagem já mostra quem e onde; escreva o que muda.
Mantenha os dois quadros próximos
Luz e posição parecidas dão um movimento suave; quadros muito diferentes tendem a ser unidos por um corte.
Não conte com o texto de plano único
Pedir um plano contínuo não garante que ele saia assim, então confira o resultado.
Espere pequenas variações no rosto em movimentos longos
O rosto pode mudar um pouco em viradas de cabeça grandes ou quando as mãos passam na frente dele.
Faça a prévia em rascunho
Teste o movimento no rascunho antes da renderização completa.
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/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"resolution": "720p"
}
}'
# 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.


























