Pegue sua chave de API

da Black Forest Labs

Vídeo com som sincronizado e um nível de rascunho rápido

black-forest-labs/flux-3/text-to-videoA partir de 45 créditospor um clipe de 5 segundos · US$ 0,45
  • Até 1080p
  • Clipes de 5 a 20 s
  • Com som
  • Quadro inicial e final
  • 7 proporções
  • Criar vídeo
  • Imagem para vídeo
  • Estender vídeo
  • Melhorar vídeo

Sobre o FLUX 3

O FLUX 3 é o modelo de vídeo da Black Forest Labs, com a API de vídeo aberta desde 4 de agosto de 2026. Um único modelo gera imagem e som sincronizado juntos, a partir de um prompt ou de um primeiro quadro e, opcionalmente, de um último, em clipes de 5 a 20 segundos em 720p ou 1080p. Um nível de rascunho rápido pré-visualiza o plano pelo menor preço; a extensão continua um clipe pronto e a ampliação o aumenta.

Chame com o nome de modelo black-forest-labs/flux-3/text-to-video em POST /jobs/createTask, a partir de 45 créditos por um clipe de 5 segundos (US$ 0,45). Contas novas ganham 30 créditos grátis para você testar primeiro no Playground.

Por enquanto este guia está só em inglês. →

Parâmetros da requisição

ParâmetroObrigatórioDescrição
promptSimDescribe the subject, action, camera, light and sound for the shot.
qualityNãoMais tempo e preço em troca de detalhes mais finos. standard · draft · Padrão: standard
resolutionNãoTamanho de saída. Maior fica mais nítido e custa mais. 720p · 1080p · Padrão: 720p
aspect_ratioNãoO formato do quadro: horizontal, quadrado ou vertical. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 2:1 · Padrão: 16:9
generate_audioNãoAdiciona som combinando com a imagem: vozes, ambiente e efeitos. Padrão: true
duration_secondsNãoQuanto tempo dura o clipe. Cobrado por segundo. 5–20 · Padrão: 5

Preços

Os preços são em créditos, os mesmos que você usa no site (1 crédito = US$ 0,01). O valor é reservado quando a tarefa é aceita e acertado pelo custo real quando ela termina; tarefas com falha são reembolsadas.

OpçãoCréditos por segundo≈ USD
quality draft · resolution 1080p9US$ 0,09
quality draft · resolution 720p9US$ 0,09
quality standard · resolution 720p25,5US$ 0,26
quality standard · resolution 1080p43,5US$ 0,44

Para saber o valor exato antes de rodar, envie o mesmo corpo para POST /jobs/quote.

Início rápido da API

Chame a API do FLUX 3 em três passos

  1. Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow- e usam os mesmos créditos do site.
  2. Envie a requisição. Faça POST /jobs/createTask com model black-forest-labs/flux-3/text-to-video e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
  3. Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $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",
    "aspect_ratio": "16:9",
    "quality": "standard",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.

Perguntas sobre a API do FLUX 3

Quanto custa a API do FLUX 3?

O FLUX 3 custa a partir de 45 créditos (US$ 0,45) por um clipe de 5 segundos com Criar vídeo, a tarefa mais barata. Preços por opção: draft · 1080p 9 créditos por segundo, draft · 720p 9 créditos por segundo, standard · 720p 25,5 créditos por segundo, standard · 1080p 43,5 créditos por segundo. Os créditos são os mesmos do site (1 crédito = US$ 0,01), contas novas ganham 30 créditos grátis e tarefas que falham são reembolsadas.

Qual é o nome de modelo do FLUX 3 na API?

Coloque black-forest-labs/flux-3/text-to-video para Criar vídeo; black-forest-labs/flux-3/image-to-video para Imagem para vídeo; black-forest-labs/flux-3/video-extend para Estender vídeo; black-forest-labs/flux-3/upscale para Melhorar vídeo no campo model de POST /jobs/createTask.

A extensão de vídeo devolve o clipe inteiro?

Não. O resultado contém apenas o trecho recém-gerado, sem o seu clipe de origem, então una os dois em um editor. O novo trecho começa a partir do último quadro da origem; no nosso teste, ele abriu com uma breve dissolução e depois seguiu para a ação seguinte.

Posso fazer um único plano longo de 20 segundos?

Você pode pedir até 20 segundos, mas o modelo ainda pode cortar ou dissolver dentro de um clipe, principalmente quando a luz ou a ação mudam muito. Para ter controle, faça clipes mais curtos e encadeie-os com a extensão.

Posso dar um último quadro?

Sim, em imagem para vídeo. O clipe vai da primeira imagem até a última. Se os dois quadros forem muito diferentes em luz ou lugar, o modelo pode usar um corte seco no meio em vez de uma mudança gradual, então mantenha os quadros parecidos quando quiser um movimento suave.

Quais são os limites da API do FLUX 3?

Duração do clipe: 5–20 s; Resoluções: 720p · 1080p; Proporções: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 2:1; Tamanho do prompt (caracteres): 5,000. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.

Dá para testar o FLUX 3 sem escrever código?

Dá. O Playground roda o FLUX 3 com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.

Todos os modelos FLUX

O LTX 2.5 chega a 4K nativo e também vai a 20 segundos. O FLUX 3 acrescenta um nível de rascunho barato, além de extend e upscale no mesmo lugar.

Mais sobre o FLUX 3