black-forest-labs/flux-2-max/editA partir de 12 créditos por imagem· Editar imagem

A edição do FLUX.2 [max] recebe de uma a três imagens de origem e uma instrução, como novo fundo, nova luz ou uma cena combinada, em 1k ou 2k, no formato da origem ou em uma de nove proporções.

Chame com o nome de modelo black-forest-labs/flux-2-max/edit em POST /jobs/createTask, a partir de 12 créditos por imagem (US$ 0,12). Contas novas ganham 30 créditos grátis para você testar primeiro no Playground.

  • Criar imagem
  • Editar imagem
  • Até 2K
  • Até 3 imagens de referência
  • 9 proporções

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

Parâmetros da requisição

ParâmetroObrigatórioDescrição
aspect_ratioNãoO formato do quadro: horizontal, quadrado ou vertical. auto · 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Padrão: auto
image_urlsSimFotos para editar ou combinar. Diga no prompt o que cada uma traz.
promptSimSay what to change and what must stay the same.
resolutionNãoTamanho de saída. Maior fica mais nítido e custa mais. 1k · 2k · Padrão: 1k
seedNãoRepetir o mesmo número dá um resultado reproduzível. ≥ 0 · ≤ 2147483647

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
Padrão11,42US$ 0,11

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

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 Max 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-max/edit 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-max/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "aspect_ratio": "auto",
    "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 Max

Quanto custa a API do FLUX.2 Max?

O FLUX.2 Max custa a partir de 12 créditos (US$ 0,12) por imagem com Editar imagem, a tarefa mais barata. 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 Max na API?

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

O que é o FLUX.2 [max]?

É o modelo de maior qualidade da família FLUX.2 da Black Forest Labs, lançado em 16 de dezembro de 2025. Ele é voltado a pessoas e luz fotorrealistas, texto legível na imagem e edições que combinam várias referências.

Ele consegue escrever texto nas imagens?

Sim. Nosso exemplo de capa de revista gerou um título, uma chamada e uma linha de edição, todos escritos exatamente como no prompt. Coloque cada linha entre aspas e diga onde ela fica. Os valores de cor em hex no prompt são seguidos de perto.

Quantas imagens de referência posso usar?

De uma a três. No prompt, chame-as de imagem 1, imagem 2 e imagem 3 e diga o que cada uma traz. Nosso exemplo da livraria colocou duas mulheres de retratos separados em uma terceira foto de um ambiente.

O que o auto faz nas edições?

Com auto, o resultado mantém o formato da primeira imagem de origem, com cerca de um megapixel. Se você escolher uma proporção, poderá optar por 1k ou 2k.

Ele pesquisa na web ou aceita ajuste de passos e de guidance?

Não. Esses controles não são oferecidos aqui. Você usa o prompt, a proporção, o nível de tamanho e a seed.

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

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

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

Dá. O Playground roda o FLUX.2 Max 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 barato e mais rápido para o dia a dia. O Max é o indicado para retratos principais e capas.

Mais sobre o FLUX.2 Max