Pegue sua chave de API

da Black Forest Labs

Escreve títulos e rótulos exatamente como você digitou

black-forest-labs/flux-2-flex/text-to-imageA partir de 9 créditospor imagem · US$ 0,09
  • Até 2K
  • Até 3 imagens de referência
  • 9 proporções
  • Criar imagem
  • Editar imagem
Tea tin labelVer exemplos

Sobre o FLUX.2 Flex

O FLUX.2 [flex] é o modelo FLUX.2 da Black Forest Labs para layouts em que as letras importam, lançado em 25 de novembro de 2025. Ele escreve na imagem títulos, frases de efeito e rótulos entre aspas, segue valores de cor hex, gera em 1k ou 2k e nove proporções e edita com até três imagens de origem.

Chame com o nome de modelo black-forest-labs/flux-2-flex/text-to-image em POST /jobs/createTask, a partir de 9 créditos por imagem (US$ 0,09). 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
seedNãoRepetir o mesmo número dá um resultado reproduzível. ≥ 0 · ≤ 2147483647
promptSimDescribe the subject, setting, light and style in plain sentences.
resolutionNãoTamanho de saída. Maior fica mais nítido e custa mais. 1k · 2k · Padrão: 1k
aspect_ratioNãoO formato do quadro: horizontal, quadrado ou vertical. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Padrão: 1:1

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 imagem≈ USD
resolution 1K8,67US$ 0,087
resolution 2K13,21US$ 0,13

Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 9 créditos por imagem (US$ 0,09).

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.2 Flex 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-2-flex/text-to-image 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-2-flex/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'

# 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.2 Flex

Quanto custa a API do FLUX.2 Flex?

O FLUX.2 Flex custa a partir de 9 créditos (US$ 0,09) por imagem com Criar imagem, a tarefa mais barata. Preços por opção: 1K 8,67 créditos por imagem, 2K 13,21 créditos por imagem. 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.2 Flex na API?

Coloque black-forest-labs/flux-2-flex/text-to-image para Criar imagem; black-forest-labs/flux-2-flex/edit para Editar imagem no campo model de POST /jobs/createTask.

No que o FLUX.2 [flex] é melhor?

Em texto e layout. Nos nossos testes, um pôster de filme com título, frase de efeito e linha de estreia, uma capa de álbum com título em letra cursiva e o rótulo de uma lata de chá voltaram com todas as linhas entre aspas escritas como no prompt.

Os códigos de cor hex funcionam?

Em geral, sim. Um código ao lado de um objeto grande ou do tratamento de cor é seguido de perto; em uma linha pequena de letras, o tom pode mudar. No nosso teste de pôster, a linha de estreia foi pedida em um vermelho forte e voltou em um salmão mais claro.

Posso ajustar passos ou guidance?

Não. Esses ajustes não são oferecidos aqui. Você controla o resultado com o prompt, a proporção, o nível de tamanho e a seed.

Por que a edição para no 1k?

Edições com várias imagens de origem em 2k continuaram falhando nos nossos testes, então a edição é oferecida só em 1k. O texto para imagem oferece 1k e 2k.

FLUX.2 [flex] ou outro modelo FLUX.2?

Escolha o flex quando a imagem depender sobretudo de texto e layout. Os outros modelos FLUX.2 fazem trocas diferentes entre velocidade, realismo e abertura; compare-os nas páginas da família FLUX.2.

Quais são os limites da API do FLUX.2 Flex?

Resoluções: 1K · 2K; Proporções: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Tamanho do prompt (caracteres): 5,000. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.

Dá para testar o FLUX.2 Flex sem escrever código?

Dá. O Playground roda o FLUX.2 Flex 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 FLUX.2 Pro é mais rápido e mais barato para trabalho fotográfico com menos texto.

Mais sobre o FLUX.2 Flex