Introdução
O FLUX 3 Texto para vídeo é o modelo de vídeo da Black Forest Labs, com a API aberta desde 4 de agosto de 2026. Ele transforma um prompt escrito em um clipe de 5 a 20 segundos com som sincronizado, em 720p ou 1080p e sete formatos, e tem um nível de rascunho rápido para conferir um plano pelo menor preço.
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
Imagem e som juntos
O som é gerado na mesma passada que a imagem. As falas entre aspas coincidiram palavra por palavra com os nossos prompts, e uma linha Sound: orienta o ruído ambiente, como chuva ou passos. Desativar o som custa o mesmo.
Nível de rascunho
O rascunho é uma prévia rápida e de baixo custo, sempre em 720p. O detalhe é mais suave que no standard, mas basta para avaliar enquadramento, ação e clima antes da renderização completa.
Cobrado por segundo
O preço acompanha a duração e o nível: o rascunho é o mais barato, depois o standard 720p e depois o standard 1080p. A proporção e o ajuste de som não o alteram, e pedidos recusados ou com falha não são cobrados.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Descreva o assunto, a ação, a câmera, a luz e o som; acrescente uma linha Sound: para o ruído ambiente e ponha as falas entre aspas. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Uma entre 16:9 (padrão), 9:16, 1:1, 4:3, 3:4, 21:9 ou 2:1. O formato não altera o preço. |
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. 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
Cenas de diálogo e de atmosfera
Um personagem, uma fala, um som de ambiente e um movimento lento de câmera.
Storyboards
Faça a prévia de cada plano em rascunho e renderize de novo os que você mantiver.
Clipes sociais e verticais
9:16 e 1:1 já vêm incluídos, e 21:9 e 2:1 cobrem quadros largos de cinema.
Guia de prompt e dicas práticas
Escreva como um plano
Assunto e figurino, cenário, ação, movimento de câmera, luz e, por fim, uma linha que comece com Sound:.
Ponha as falas entre aspas
Coloque as palavras faladas entre aspas, no idioma em que você quer ouvi-las.
Uma ação por clipe
Uma única ação clara e um único movimento de câmera se sustentam melhor; grandes mudanças de luz ou de lugar podem fazer o modelo cortar ou dissolver.
Rascunho primeiro
Acerte o enquadramento no rascunho e depois rode o mesmo prompt em standard.
Mantenha as expectativas quanto ao conteúdo
Apenas os looks de nível Leve são renderizados; qualquer coisa mais forte é recusada e não cobrada.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.


























