Chave de API do Flux: preços, plano gratuito e documentação da Black Forest Labs

Você procurou uma chave de API do Flux porque quer gerar imagens a partir de código e quer saber o preço antes de cadastrar um cartão. Faz sentido. A Black Forest Labs vende o Flux por meio de uma API baseada em créditos, e as respostas sobre preços, uso gratuito e limites estão espalhadas por várias páginas da documentação. Este artigo reúne tudo em um só lugar, com base na documentação oficial conforme consultada em outubro de 2026.

Resumindo: 1 crédito equivale a $0.01, você paga por imagem (ou por segundo de vídeo), a documentação não anuncia nenhum crédito gratuito para contas novas, e o teto padrão é de 24 tarefas ativas ao mesmo tempo. O restante desta página mostra como esses fatos se aplicam na prática, com uma tabela de todos os preços atuais e uma requisição que você pode executar hoje.

💡 Os preços mudam. Todos os valores aqui vêm da página de preços e da central de ajuda da Black Forest Labs. Confira a página atualizada antes de orçar um trabalho grande, porque novos modelos e faixas de resolução aparecem com frequência.

Como configurar sua conta na Black Forest Labs

Tudo começa em dashboard.bfl.ai. A conta, as credenciais e a cobrança ficam todas lá, e a configuração leva cerca de cinco minutos.

Crie a conta

Abra o painel, clique em Login e cadastre-se com um e-mail e senha ou com o Google. O cadastro cria automaticamente uma Default Organization e um Default Project, então não há nada extra para configurar. A organização guarda sua cobrança e o saldo de créditos. O projeto guarda suas credenciais de API. Se depois você dividir o trabalho entre clientes ou produtos, pode adicionar projetos sem abrir uma segunda conta.

Gere e guarde a chave secreta

Dentro do seu projeto, vá em API, depois em Keys, e clique em Add Key. Dê a ela um nome descritivo, como production-images. A chave de API completa aparece uma única vez, então copie-a direto para um gerenciador de senhas ou para uma variável de ambiente. Três cuidados vão poupar dor de cabeça:

• Mantenha o segredo fora do Git e fora do código do navegador. Quem tiver a chave pode gastar seus créditos.
• Crie uma credencial para cada ambiente, para que revogar a chave de homologação nunca derrube a produção.
• Envie-a no cabeçalho x-key de toda requisição, exatamente como faz o exemplo mais adiante neste artigo.

Adicione créditos antes de chamar a API

As requisições falham sem saldo, então financie a conta primeiro. Na barra lateral, vá em API, depois em Credits, clique em Add Credits e escolha um valor. O Stripe processa o pagamento, e os créditos ficam disponíveis imediatamente. A documentação não informa nenhum valor mínimo para a compra manual.

A recarga automática é opcional. O limite que dispara a recarga deve ser de no mínimo $5, e o valor de recarga precisa ficar pelo menos $10 acima desse limite. Se uma cobrança automática falhar, a recarga automática se desliga sozinha até você reativá-la, então confira os dados do seu cartão antes de uma execução longa sem supervisão.

Quanto custa o Flux por imagem

A Black Forest Labs mantém três estilos de precificação ao mesmo tempo. Os modelos mais antigos, FLUX.1, cobram um número fixo de créditos por imagem. A família FLUX.2 cobra por megapixel. Os modelos mais novos, FLUX 3, cobram por faixa de resolução ou, no caso de vídeo, por segundo. O playground cobra o mesmo preço da API, então testar no navegador não é um atalho gratuito.

Preços fixos em créditos do FLUX.1

São os mais fáceis de orçar, porque uma requisição custa o mesmo em qualquer tamanho suportado.

O Kontext é a linha de edição: você envia uma imagem mais uma instrução, e ele altera o que você descreve. O Fill Pro faz inpainting e outpainting.

Preço do FLUX.2 por megapixel

Os preços do FLUX.2 começam baixos e sobem com a resolução: o primeiro megapixel custa um valor fixo, e cada megapixel adicional soma ao total. Os valores abaixo são os preços iniciais.

Klein 4B e 9B formam a dupla econômica, o Pro é a escolha habitual para produção, e o Max fica no topo da lista de preços. O Flux 2 Dev não tem preço na API porque a documentação o lista como somente local.

Taxas de imagem e vídeo do FLUX 3

O FLUX 3 separa o preço da imagem pelo tamanho de saída.

O vídeo é cobrado por segundo. Texto para vídeo e imagem para vídeo custam de $0.17 a $0.80 por segundo para uma renderização completa, enquanto uma renderização de rascunho custa $0.06 por segundo. Um rascunho de cinco segundos, portanto, custa $0.30, e uma renderização completa de cinco segundos custa pelo menos $0.85. Você pode testar o Flux 3 como modelo de texto para vídeo no PicassoIA antes de se comprometer com as tarifas da API.

Existe um plano gratuito de verdade?

Resposta curta: não existe nenhum que a documentação anuncie.

O que a documentação realmente diz

A página de preços começa com uma única regra: 1 crédito equivale a $0.01 USD, pagamento por imagem, mesmo preço para API e playground. Ela não lista créditos de cadastro, franquia mensal gratuita nem período de teste. As páginas de créditos e de cobrança também não mencionam créditos de teste. Rastreadores independentes de preços chegam à mesma conclusão: não existe um plano gratuito tradicional. Se houver alguma promoção em andamento, confira seu painel depois de se cadastrar, porque nenhuma está documentada.

Então, planeje um primeiro depósito pequeno. Uma recarga de $10 compra 1.000 créditos. Isso equivale a 250 imagens com o Flux 1.1 Pro, a 4 créditos cada, ou mais de 700 imagens com o Flux 2 Klein 4B, a $0.014 cada.

💡 Teste barato primeiro. Rode seus modelos de prompt no modelo mais barato antes de gastar créditos com Max ou Ultra. Um prompt ruim custa o mesmo em qualquer modelo.

Opções gratuitas que existem

Três caminhos evitam pagar à Black Forest Labs por imagem:

• Hospede os pesos abertos você mesmo. O Flux 2 Klein 4B e o Flux Schnell são modelos de pesos abertos, então você pode rodá-los no seu próprio hardware sem taxa por imagem, dentro dos termos da licença. Em troca, você paga pela sua própria GPU, e a licença varia de modelo para modelo, então confira a ficha de cada um. O Flux 2 Dev aparece como somente local, e seus pesos têm licença não comercial, então leia isso antes de usá-lo em um produto pago.
• Use uma ferramenta hospedada no navegador. O PicassoIA roda modelos Flux no navegador, sem configurar API. A página do Flux 2 Pro descreve o modelo como gratuito, online e sem necessidade de programar.
• Faça protótipos no modelo pago mais barato. A $0.014 por imagem, algumas centenas de experimentos custam menos que um café.

Limites de requisições e URLs de resultado

Duas regras moldam qualquer integração: quantos trabalhos podem rodar ao mesmo tempo e quanto tempo você tem para baixar o resultado.

24 tarefas ativas por padrão

O limite de concorrência é o número de requisições que uma conta pode ter em andamento ao mesmo tempo. Por padrão, são 24 tarefas ativas. Dois modelos têm limites mais apertados: flux-kontext-max é limitado a 6 tarefas ativas, e o vídeo do FLUX 3 começa com 5 tarefas de vídeo simultâneas. Limites maiores são possíveis se você entrar em contato com o suporte da Black Forest Labs.

Quando você ultrapassa o limite, a API responde com HTTP 429. Nada se perde: espere uma das tarefas anteriores terminar e envie a requisição de novo. No código, isso significa um semáforo com teto um pouco abaixo de 24 e uma nova tentativa com backoff ao receber 429. O limite conta tarefas que ainda estão rodando, e não requisições por segundo, então um modelo mais rápido permite passar mais imagens pelo mesmo teto.

Dez minutos para baixar

A resposta ao seu primeiro POST contém um id e um polling_url. Use essa URL, e não uma que você monte sozinho, especialmente no endpoint global api.bfl.ai ou nos regionais, api.eu.bfl.ai e api.us.bfl.ai. Faça polling até o status indicar Ready, Error ou Failed.

A URL assinada de um resultado pronto vale por apenas 10 minutos. Baixe o arquivo e copie-o para seu próprio armazenamento, como S3 ou R2, no momento em que o status mudar para Ready. Se o seu worker estiver fora do ar quando o trabalho terminar, a saída expira e você precisa gerar a imagem de novo.

Fazendo sua primeira requisição

Aqui está um script mínimo em Python usando o endpoint do Flux 1.1 Pro, que custa 4 créditos ($0.04) por imagem. Defina BFL_API_KEY no seu ambiente antes.

import os, time, requests

BASE = "https://api.bfl.ai/v1"
HEADERS = {"x-key": os.environ["BFL_API_KEY"], "accept": "application/json"}

job = requests.post(
    f"{BASE}/flux-pro-1.1",
    headers=HEADERS,
    json={
        "prompt": "A ceramic perfume bottle on a white table, soft window light",
        "width": 1024,
        "height": 768,
    },
).json()

while True:
    result = requests.get(job["polling_url"], headers=HEADERS).json()
    if result["status"] == "Ready":
        break
    if result["status"] in ("Error", "Failed"):
        raise RuntimeError(result)
    time.sleep(1)

image = requests.get(result["result"]["sample"]).content
open("bottle.jpg", "wb").write(image)

Copiar prompt

O script envia um trabalho, lê o polling_url da resposta, verifica uma vez por segundo e salva a imagem antes que a URL assinada expire. Para usar outro modelo, troque o caminho do endpoint pelo que estiver listado para ele na referência da API em docs.bfl.ai. A referência da API também documenta uma chamada que retorna seus créditos restantes, o que vale a pena executar antes de qualquer lote grande.

Controlando custos em escala

Pequenas diferenças por imagem viram dinheiro de verdade em volume. A tabela mostra quanto custam 1.000 imagens em cada preço inicial.

Escolha o modelo mais barato que funciona

Um padrão sensato é fazer rascunhos com um modelo Klein e gerar de novo só os vencedores no Pro ou no Max. Para edições, comece com o Kontext Pro e passe para o Kontext Max só quando o resultado exigir. O Kontext Max também tem o limite de concorrência mais apertado, então não é uma boa escolha para trabalhos em massa.

Orce antes de gerar em lote

Lotes multiplicam o custo base pelo número de imagens, então 200 imagens no Flux 1.1 Pro custam 200 vezes $0.04, o que dá $8. Os créditos ficam no nível da organização e são compartilhados entre seus projetos, então projetos separados não criam orçamentos separados. Ative a recarga automática só depois de definir um limite que você possa perder por causa de um loop descontrolado, e confira o saldo de créditos no início de cada trabalho grande.

Flux 2 Pro no PicassoIA

Se você quer imagens em vez de uma integração, pode pular a configuração da conta, os créditos e o código. O PicassoIA hospeda o Flux 2 Pro no navegador, e ele aceita até oito imagens de referência junto com o seu prompt.

Como usar o Flux 2 Pro

Veja como usar o Flux 2 Pro no PicassoIA, passo a passo:

1. Abra a página do Flux 2 Pro no PicassoIA.
2. Escreva seu prompt. É o único campo obrigatório. Descreva o assunto, a luz e a lente, como em "um frasco de perfume de cerâmica sobre uma mesa branca, luz suave de janela, lente de 85mm".
3. Opcionalmente, adicione até 8 imagens de referência (JPEG, PNG, GIF ou WebP) para orientar estilo, assunto ou composição. Mencione-as no prompt como imagem 1, imagem 2 e assim por diante.
4. Escolha uma proporção e uma resolução. O padrão é 1 MP, e a página do modelo recomenda 2 MP ou menos.
5. Escolha o formato de saída e a qualidade, e então inicie a geração.
6. Salve o resultado de que você gostar e reutilize o seed se quiser reproduzi-lo depois.

Dicas de parâmetros que fazem diferença

Largura e altura personalizadas devem ser múltiplos de 32, e a saída máxima é de 2048 x 2048 pixels, então proporções muito largas não chegam aos 4 MP completos.

Outros modelos Flux para testar

• Flux 2 Max e Flux 2 Flex para a faixa superior da família FLUX.2.
• Flux 2 Klein 4B e Flux 2 Klein 9B para rascunhos rápidos e de baixo custo.
• Flux 1.1 Pro Ultra para saídas em alta resolução.
• Flux Kontext Pro para editar uma foto existente com uma instrução escrita.
• Flux 3 para texto para vídeo.

Experimente o Flux no Picasso IA hoje

A API da Black Forest Labs é a ferramenta certa quando você está construindo um produto que chama o Flux milhares de vezes. Para todo o resto, a forma mais rápida de ver o que esses modelos fazem é digitar um prompt e olhar o resultado.

Abra o Picasso IA, escolha o Flux 2 Pro ou qualquer modelo da lista completa de modelos, e gere sua primeira imagem em poucos minutos. Teste o mesmo prompt em dois ou três modelos, compare os resultados lado a lado e observe qual deles vale o que custa. Quando souber qual modelo se encaixa no seu trabalho, você também saberá para qual endpoint da API vale a pena orçar.