

FLUX 3 para desenvolvedores: workflows de imagem
Crie pipelines de imagem FLUX 3 prontas para produção com chaves seguras, trabalhos assíncronos, edição, novas tentativas, armazenamento e custos.
Se eu lançasse o FLUX 3 hoje, priorizaria três pontos: chaves seguras, controle assíncrono e armazenamento rápido. Este guia mostra como enviar trabalhos de geração e edição, como consultar o status das tarefas, como trabalhar com edição de uma imagem, edição local com bbox e referências de várias imagens e o que verificar antes do lançamento. Você pode testar FLUX 3 Image API diretamente na APIMart.
Resumo:
- O FLUX 3 reúne geração e edição em um workflow de imagem.
- As tarefas são assíncronas: envio a tarefa, salvo o
task_ide consulto/v1/tasks/{task_id}até o status sercompletedoufailed. - A APIMart mantém os resultados gerados por 72 horas.
- Regras de repetição importam: repita
429e5xxcom backoff; corrija400,401e402antes de tentar novamente. - A resolução define a espera e o custo:
4kpode levar vários minutos, e a documentação recomenda um tempo limite total de espera de 10 minutos. - Envie as imagens de origem como URLs públicas em
image_urls. Base64 também funciona, mas aumenta a carga em cerca de 33%. - Pelos preços de tabela de outubro de 2026, o FLUX 3 Image custa US$ 0,048 por imagem em
1ke US$ 0,607 em4k, cerca de 12,6 vezes mais. FLUX 3 Image - Antes do lançamento, verifique filas, limites, logs, segurança e gastos em USD.
Conclusão principal: o FLUX 3 exige mais que uma chamada; precisa de uma pipeline limpa de trabalhos, arquivos, tentativas e custos.
Comparação rápida
| Fluxo | O que enviar | Uso principal |
|---|---|---|
| Texto para imagem | prompt, aspect_ratio e resolution opcionais; sem image_urls | Criar imagens novas |
| Edição de uma imagem | prompt e 1 imagem em image_urls | Alterar uma imagem mantendo o original |
| Edição local (bbox) | Tags e JSON de bbox dentro do prompt, mais image_urls | Alterar ou mover só as áreas marcadas |
| Referência de várias imagens | prompt e 2–10 imagens em image_urls | Transferência de estilo, combinar sujeitos e cenas |
O foco é o necessário para lançar: fluxo de solicitação, controle de edição, produção e custos, não apenas demonstrações.

Principais pontos
- O FLUX 3 Image processa texto para imagem, edição de uma imagem, referências de várias imagens (até 10) e edição local com bbox escrita no prompt por um único endpoint assíncrono. Ele não tem parâmetro
masknem parâmetro de intensidade (strength). - As tarefas seguem o fluxo "POST retorna task_id": consulte /v1/tasks/{task_id} e pare quando o status for completed ou failed.
4kpode levar vários minutos, e a documentação recomenda um tempo limite total de espera de 10 minutos. - Repita respostas 429 e 5xx com backoff exponencial, corrija erros 400, 401 e 402 antes de tentar de novo e persista o task_id para que as novas tentativas não criem jobs faturáveis duplicados.
- A APIMart mantém os resultados gerados por 72 horas.
- Pelos preços de tabela de outubro de 2026, o FLUX 3 Image custa US$ 0,048 por imagem em
1ke US$ 0,607 em4k, cerca de 12,6 vezes mais. Uma única chave de API da APIMart permite chamar modelos de vários fornecedores.
FLUX 3 em resumo
| Especificação | Detalhes |
|---|---|
| Tipo de modelo | Geração e edição de imagens: texto para imagem, edição de uma imagem, referência de várias imagens (até 10), edição local com bbox |
| Entradas | prompt, model, aspect_ratio/resolution; para editar, adicione image_urls (URL pública ou Base64) |
| Saída | resolution: 768sq / 1k / 1.5k / 2k / 4k |
| Controles de edição | Descreva as mudanças no prompt; para edição local, coloque o JSON de bbox no prompt; mask_url retorna 400 e não há parâmetro strength |
| Recursos principais | POST assíncrono retorna task_id; consultar /v1/tasks/{task_id} até completed/failed; espera total recomendada de 10 minutos em 4k |
| Preços | 1k $0.048 → 4k $0.607 (≈12.6×; 2026-10) |
| Disponibilidade | Uma única chave de API da APIMart permite chamar modelos de vários fornecedores. |
| Limites | A APIMart mantém os resultados gerados por 72 horas. |
Visão geral em vídeo dos workflows FLUX 3
Workflows de FLUX 3: autenticação, solicitações e trabalhos
Integrações estáveis do FLUX 3 dependem de chaves seguras, URLs temporárias e trabalhos assíncronos.
Configure chaves e segurança
Nunca codifique chaves no código-fonte. Guarde-as no servidor em um gerenciador de segredos e não as exponha no cliente ou em repositórios públicos. Em caso de vazamento, altere imediatamente no painel da APIMart.
Trate a rotação como manutenção regular, não como emergência. Isso mantém a configuração limpa e reduz riscos.
Credenciais seguras, solicitações previsíveis e gerenciamento confiável sustentam recursos de imagem em produção.
Crie solicitações de prompt para imagem e processe respostas
Uma solicitação básica do FLUX 3 requer:
- ID do modelo
- prompt de texto
- tamanho ou proporção
A APIMart mantém os resultados gerados por 72 horas. Baixe as imagens assim que a tarefa terminar e, para uso duradouro, salve-as no seu próprio armazenamento, como o S3.
Gerencie consultas, tentativas e erros de trabalhos longos
A geração de imagens é assíncrona. Uma solicitação POST envia a tarefa e retorna um task_id. Depois, consulte GET /v1/tasks/{task_id} e pare quando o status for completed ou failed. A documentação não define um intervalo de consulta; comece com alguns segundos e aumente o intervalo aos poucos.
Defina o limite de espera por resolução. 4k pode levar vários minutos, e a documentação recomenda um tempo limite total de 10 minutos; resoluções menores podem usar um limite mais curto. Atingir esse limite só significa que o seu cliente parou de esperar. Não quer dizer que a tarefa falhou, o que só acontece quando o status retorna failed. Guarde o task_id para consultar de novo depois, em vez de enviar uma tarefa duplicada.
Nem todo erro deve receber o mesmo tratamento.
- Respostas
429e5xxdevem acionar backoff exponencial e nova tentativa. - Erros
400,401e402indicam parâmetros, chave ou saldo inválidos.
Repetir sem corrigir desperdiça créditos. Persista task_id antes da repetição para evitar trabalhos duplicados cobrados.
Essas regras de nova tentativa valem igualmente para texto para imagem, edição de uma imagem e edição local.
Os fluxos diferem principalmente no conteúdo da solicitação. Todos usam o mesmo endpoint e modelo e são cobrados por resolution.
| Tipo de fluxo | Entradas obrigatórias | Complexidade de implementação |
|---|---|---|
| Texto para imagem | model, prompt | Baixa |
| Edição de uma imagem | model, prompt, 1 imagem em image_urls | Baixa |
| Edição local (bbox) | model, prompt com tags e JSON de bbox, image_urls | Média |
| Referência de várias imagens | model, prompt, 2–10 imagens em image_urls | Média |
A documentação do modelo não oferece webhook nem callback_url, então em produção você precisa gerenciar a consulta por conta própria: controle a concorrência com uma fila e registre o status de cada task_id.
Com o tratamento de solicitações estável, o próximo passo é decidir como entregar ao modelo as imagens de origem e as instruções de edição.
Fluxos de edição de imagens no FLUX 3: edição de uma imagem, edição local e referências de várias imagens
Com o envio de tarefas e as novas tentativas configurados, a próxima decisão é simples: quanto da imagem de origem deve ficar e quanto deve mudar? Todas as edições do FLUX 3 Image passam por image_urls mais o prompt, em três padrões principais: edição de uma imagem, edição local com bbox e referências de várias imagens.
Use a edição de uma imagem para mudanças visuais controladas
Envie uma imagem de origem em image_urls e diga no prompt o que deve mudar e o que deve permanecer. O modelo não tem um parâmetro de intensidade como strength, então o prompt é a única forma de controlar o quanto a imagem muda. Com aspect_ratio em auto, a saída segue a proporção da primeira imagem de referência.
Funciona para variantes de produtos, atualização de anúncios e estilo de marca. Seja claro sobre o que não deve mudar. Um caso prático é reutilizar a mesma foto em versões sazonais.
As imagens de origem podem ser URLs HTTP(S) públicas ou Base64. Base64 aumenta a carga em cerca de 33%, então uma URL pública, por exemplo de uma CDN, costuma ser a melhor escolha.
Use bbox para delimitar a edição local
O modelo não tem parâmetro mask, e enviar mask_url retorna HTTP 400. Para alterar só uma área, indique os elementos no prompt com tags como <car_1> e acrescente um array JSON de bbox ao final da mesma string. As caixas usam [top, left, bottom, right] em uma grade normalizada de 0 a 1000, não pixels. Se tgt_bbox for igual a src_bbox, o elemento fica no lugar; uma caixa diferente o move. O exemplo abaixo deixa vermelho o carro marcado e preserva o fundo:
{
"model": "flux-3-image",
"prompt": "In <ref_image_0>, make the car <car_1> red and preserve the background <background_1>. [{\"id\":\"car_1\",\"from\":null,\"src_bbox\":null,\"tgt_bbox\":[250,300,750,800],\"desc\":\"A red car, preserving its original shape and orientation.\"},{\"id\":\"background_1\",\"from\":\"ref_image_0\",\"src_bbox\":[0,0,1000,1000],\"tgt_bbox\":[0,0,1000,1000],\"desc\":\"Preserve the original road, background, and lighting.\"}]",
"image_urls": [
"https://example.com/car.jpg"
],
"aspect_ratio": "auto",
"resolution": "2k"
}
Não há parâmetro específico para outpainting. Nas referências de várias imagens, as imagens são numeradas em ordem como ref_image_0, ref_image_1 e assim por diante, e você também pode escrever Image 1 / Image 2 no prompt, por exemplo "Turn Image 1 into the style of Image 2."
Use resolution: "768sq" nas prévias e escolha 1k, 1.5k, 2k ou 4k para a entrega. São faixas de resolução, não valores de width/height em pixels: 4k equivale a cerca de 16 MP e 2k a cerca de 4 MP. FLUX 3 Image
Encadeie etapas em pipelines repetíveis
Uma estrutura simples:
- Use a edição de uma imagem para ajustar estilo ou detalhes
- Use a edição local com bbox para alterar ou mover elementos específicos
- Use a referência de várias imagens para combinar sujeitos e estilos
- Salvar cada etapa como ativo intermediário
Antes do upload, evite exportações pelo canvas do navegador e recompressões extras para não perder detalhes. Envie o arquivo original diretamente.
Com edições estáveis, transforme-as em um workflow com acesso e custos.
FLUX 3 pela APIMart para integração e custos

A APIMart pode ser a camada de controle. Em vez de integrar cada parte, roteie a pipeline por uma API para gerenciar acesso, gasto e automação.
Conecte o FLUX 3 a um workflow unificado
Com clientes no padrão OpenAI, basta trocar URL base, adicionar chave e apontar ao ID FLUX 3.
Estrutura, parsing, tentativas e lógica assíncrona permanecem. Trabalhos FLUX 3 seguem POST para task_id e consultas GET na APIMart. O mesmo código atende uma geração ou várias edições. Uma chave cobre vários modelos e projetos.
Acompanhe uso, orçamento e carga em USD
O painel consolida uso e mostra custos em USD, ajudando a decidir quais workflows estão prontos.
Defina um teto mensal e alertas para pausar lotes antes de exceder o limite.
Pelos preços de tabela de outubro de 2026, o FLUX 3 Image custa US$ 0,048 por imagem em 1k e US$ 0,607 em 4k, cerca de 12,6 vezes mais. A tabela mostra os preços de outubro de 2026, em USD por imagem, sem descontos. As referências não têm cobrança adicional. Consulte a tabela de preços do FLUX 3 Image para os valores atuais.
| Resolução | Preço de tabela (USD / imagem) |
|---|---|
768sq | $0.041 |
1k | $0.048 |
1.5k | $0.070 |
2k | $0.100 |
4k | $0.607 |
Combine FLUX 3 a workflows multimodais
Use o FLUX 3 como etapa de geração de imagens em uma pipeline com escrita, análise visual ou classificação. Uma única chave de API da APIMart permite acessar modelos de vários fornecedores. APIMart
Permissões por função mantêm análise acessível e chaves limitadas a engenheiros aprovados.
Escala, limites e logs viram a próxima camada operacional.
Implantação: escala, observabilidade e lançamento
Planeje filas, concorrência e limites
Na produção com FLUX 3, o desafio é lidar com tráfego, não uma única solicitação.
A demanda pode aumentar rápido. Filas separam entrada e execução para proteger workers de picos.
Combine filas com limites de concorrência por modelo para absorver picos sem ultrapassar provedores.
Registre dados para depuração e reprodução
Sem os campos certos, variações tornam a depuração difícil.
Registre ID da solicitação, ID do trabalho, prompt e metadados. Ajuste a profundidade por ambiente sem expor payload desnecessário.
Registre também resolução e custo estimado para detectar exceções caras.
Conclusão: avalie o FLUX 3 antes do lançamento
Valide ambientes com regras diferentes de acesso, logs e revisão.
Use esta matriz:
| Ambiente | Chaves | Logs | Limites | Revisão |
|---|---|---|---|---|
| Desenvolvimento | Individual/Sandbox | Debug (payload completo) | Baixo/estrito | Nenhuma (automática) |
| Staging | Chave compartilhada | Info (metadados + latência) | Igual à produção | Revisão por pares |
| Produção | Segredos no servidor | Auditoria (IDs sanitizados) | Alto (níveis) | Humano/filtros de segurança |
Planeje a confiabilidade com testes de carga, monitoramento e procedimentos de recuperação próprios. Antes do lançamento, confira picos de tráfego, IDs de solicitação e tarefa nos logs, limites de uso, controles de segurança e custos por resolução.
Se os controles passarem nos testes de carga, o FLUX 3 está pronto.
Para uma visão completa do modelo, veja FLUX 3: modelos, disponibilidade e preços.
Perguntas frequentes
Por quanto tempo devo consultar uma tarefa do FLUX 3?
Consulte GET /v1/tasks/{task_id} até o status ser completed ou failed. A documentação do modelo não oferece webhook nem callback_url, então a consulta é a forma de obter os resultados.
Defina o limite de espera por resolução: 4k pode levar vários minutos, e a documentação recomenda um tempo limite total de 10 minutos. Ao atingir o limite, o seu cliente para de esperar, mas a tarefa não falhou necessariamente. Guarde o task_id para consultar de novo depois.
Como armazenar imagens FLUX 3 em produção?
A APIMart mantém os resultados gerados por 72 horas. Baixe as imagens assim que a tarefa terminar e, para uso duradouro, salve-as no seu próprio armazenamento, como o S3.
Use workflow assíncrono: consulte task_id, salve o arquivo e mantenha log com task_id, timestamps e caminho interno.
Qual é o melhor workflow de edição no FLUX 3?
Comece com imagem existente e prompt focado apenas no que deve mudar. É possível incluir texto em outros idiomas sem alterar o layout restante.
Em produção, envie POST, receba task_id e consulte a tarefa até ela ficar completed ou failed. Salve a URL final antes de expirar.
Regras básicas:
- Chaves somente no backend
- Validar entradas antes do envio
- A APIMart mantém os resultados gerados por 72 horas.
Isso mantém o workflow limpo e evita erros quando o tráfego crescer.
Sobre a equipe APIMart
A equipe APIMart escreve guias de modelos, comparativos e análises de preço para desenvolvedores que constroem com IA. A APIMart oferece uma única API para modelos de chat, imagem e vídeo de vários provedores, para que você compare os modelos citados aqui antes de lançar.
Escolha o modelo que você quer no marketplace
Teste modelos de chat, imagem e vídeo no marketplace da APIMart e experimente rapidamente as capacidades dos modelos com uma API unificada.
