Resumo
Crie fotografias de produto, cartazes e edições guiadas por referência com o FLUX 3 Image, disponível via CometAPI como flux-3-image, com preços a partir de $0.0384 por requisição. Este guia explica como escolher as configurações de imagem, preparar uma requisição, lidar com uma tarefa assíncrona e revisar a imagem finalizada. Você precisará de uma conta na CometAPI, uma chave de API e a configuração de requisição do FLUX 3 Image fornecida para sua conta.
Principais pontos
- Escolha texto-para-imagem para novas composições e edição guiada por referência quando um produto ou sujeito precisar permanecer reconhecível.
- Use um rascunho pequeno para revisar a composição antes de gastar em uma imagem final maior.
- Use credenciais da CometAPI e o esquema de requisição específico do modelo; chaves e exemplos nativos da BFL pertencem a uma integração separada.
- Estime custos pela tarifa aplicável da CometAPI e depois meça o gasto por entregável aceito.
- Conclua um ciclo de envio, recuperação de resultado, download e revisão visual antes de executar um lote.
O que é a API FLUX 3 Image?
FLUX 3 Image é o modelo da Black Forest Labs para criar e revisar imagens estáticas. Um prompt de texto descreve uma nova cena; imagens de referência fornecem material visual a ser preservado, combinado ou alterado. Para uma equipe de e-commerce, isso pode significar desenvolver uma cena de produto a partir de um briefing e, depois, reutilizar uma foto de produto aprovada enquanto altera o ambiente.
Escolha um fluxo de trabalho antes de escrever o prompt. Para um novo visual, especifique o assunto, o cenário, a iluminação e o enquadramento. Para uma edição, identifique a imagem-fonte, nomeie a alteração e indique quais detalhes devem permanecer intactos. Para uma composição usando várias referências, atribua um papel a cada uma para que a identidade do produto e o estilo visual não concorram.
Especificações do FLUX 3 Image e parâmetros de API
Planeje sua imagem com as configurações abaixo. Os controles do modelo seguem a referência da API do BFL FLUX 3 Image; autenticação e roteamento de requisições seguem sua integração com a CometAPI. Use os nomes de campos aceitos pela rota FLUX 3 Image da CometAPI.
Escolha dimensões de três formas: um nível de resolution mais aspect_ratio, width mais height para uma tela exata, ou match_input para uma edição. Mantenha a referência original disponível para comparar enquadramento e detalhes após a geração. O endpoint nativo rejeita campos não suportados; use o esquema da rota que você está chamando.
FLUX.2 vs FLUX 3 Image
Mantenha sua integração atual do FLUX.2 como linha de base de comparação ao avaliar o FLUX 3 Image. Execute os mesmos briefings e ativos de referência em ambos os fluxos de trabalho e compare saídas aceitas, tempo de resposta e custo total.
Como gerar uma imagem com a API FLUX 3 Image na CometAPI?
1. Pré-requisitos
- Cadastre-se na CometAPI e crie uma chave de API.
- Defina a variável de ambiente:
export COMETAPI_KEY="your_cometapi_key"
2. Endpoint
POST https://api.cometapi.com/flux/v1/flux-3-image
A autenticação usa um token Bearer (estilo CometAPI). As requisições são assíncronas por padrão.
3. Exemplo básico de texto-para-imagem (cURL)
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
Resposta assíncrona bem-sucedida (formato de exemplo):
{
"id": "<task_id>",
"status": "Pending",
"result": {},
"polling_url": "https://api.cometapi.com/flux/v1/get_result?id=<task_id>"
}
4. Consultar o resultado
curl "https://api.cometapi.com/flux/v1/get_result?id=<task_id>" \
-H "Authorization": "Bearer $COMETAPI_KEY"
Faça polling até que status seja "Ready". A URL da imagem aparece em result.sample (faça o download rapidamente; URLs assinadas são temporárias).
Para aguardar de forma síncrona na mesma requisição, adicione "async": false ao corpo (mantenha a conexão aberta; use um timeout generoso no cliente).
5. Exemplo em Python (submit + poll)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image suporta texto-para-imagem puro E edição/multirreferência no mesmo endpoint — basta incluir images e descrever como usá-las no prompt (sem campo “mode” separado).
Alternativa: rota compatível com OpenAI
Você também pode testar o endpoint unificado de imagens com o ID do modelo:
POST https://api.cometapi.com/v1/images/generations
{
"model": "flux-3-image",
"prompt": "your prompt here",
"size": "1024x1024"
}
(O endpoint nativo `/flux/v1/...` é preferido para todos os parâmetros do FLUX 3.)
### Dicas
* Verifique a disponibilidade atual e o preço exato na [página do modelo Flux 3 Image na CometAPI](https://www.cometapi.com/models/flux/flux-3-image/).
* Sempre faça download rapidamente da URL em `result.sample`.
* Para a lista mais recente de parâmetros ou exemplos no playground, consulte a documentação do Flux na CometAPI e a referência oficial do FLUX 3 Image da Black Forest Labs.
Isto espelha o fluxo oficial da BFL enquanto usa a autenticação e a infraestrutura unificada da CometAPI.
## Como criar prompts para o FLUX 3 Image? Exemplos
### Exemplo: prompt de fotografia de produto
Use este prompt para um primeiro teste de fotografia de produto.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
Substitua o valor do prompt em request.json por este briefing, mantendo o corpo da requisição esperado pela sua rota na CometAPI. Uma tela 4:5 combina com um posicionamento de produto em retrato. Se sua rota aceitar os controles nativos de dimensão, 1024 × 1280 é uma opção exata 4:5; forneça ambos os valores juntos.
Comece com um rascunho pequeno e verifique a silhueta do frasco, o rótulo, os reflexos e objetos extras. Se a identidade exata do produto for importante, use uma referência do produto em vez de esperar que um prompt apenas de texto a reconstrua. Registre o prompt e as configurações de saída antes de fazer alterações.
### Exemplo: tipografia e layout de cartaz
Prompt de cartaz com título especificado explicitamente.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
Use este briefing como prompt na sua requisição à CometAPI e escolha uma tela em formato retrato. Comece com um rascunho para verificar a posição do título e a disposição dos personagens; depois aumente o tamanho de saída para a arte final.
Trate a precisão das letras como uma condição mensurável de aceitação. Revise cada letra e sinal de pontuação na saída em resolução final; imagens impressionantes não garantem zero erros no seu texto de marca específico.
## Como editar imagens com referências
Para uma edição, descreva tanto a mudança desejada quanto os detalhes a preservar. A API nativa FLUX 3 Image recebe referências em images; mapeie-as para o campo de entrada correspondente no seu exemplo da CometAPI. Coloque a referência do produto primeiro e mantenha essa ordem consistente no prompt.
### Edição de imagem única: troque o fundo, preserve o produto
Mantenha edit.py ao lado de submit.py, poll.py e download.py. Defina PRODUCT_IMAGE_URL para uma foto de produto acessível publicamente via HTTPS e execute python edit.py. O exemplo abaixo requer uma rota que aceite o array nativo images. Use um corpo de requisição de edição sem campos conflitantes de imagem-fonte e ajuste o mapeamento se o seu exemplo da CometAPI usar um campo de entrada diferente. Para retomar uma tarefa de edição salva, execute python poll_download.py editing-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
Escolha uma foto de produto nítida, com rótulo legível e silhueta clara. Envie-a no formato de entrada de imagem aceito pela sua rota na CometAPI. Se essa rota suportar a configuração nativa de resolution, use match_input para manter o enquadramento e o tamanho da referência, sujeitos aos limites de edição do modelo.
A [galeria da BFL](https://bfl.ai/models/flux-3-image) demonstra uma edição localizada adicionando dois mergulhadores. Esses materiais oficiais de antes e depois ilustram o que inspecionar; não são saídas de uma execução de requisição da CometAPI para este artigo.
Exemplo oficial de edição da BFL, antes: a cena submarina original com um mergulhador.
Exemplo oficial de edição da BFL, depois: dois mergulhadores foram adicionados à cena. Inspecione o fundo inalterado, bem como os novos sujeitos.
### Edição com múltiplas referências: combine estilo e identidade do produto
Mantenha o produto primeiro e a referência de iluminação/estilo em segundo. Defina PRODUCT_IMAGE_URL e STYLE_IMAGE_URL, salve o código abaixo como multi_edit.py ao lado dos três arquivos do cliente, e execute python multi_edit.py. Este exemplo requer uma rota que aceite pelo menos duas referências em images. Comece com um corpo de requisição de edição sem campos conflitantes de imagem-fonte. Retome um job salvo com python poll_download.py multi-edit-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
Anexe ambas as referências usando o formato específico do modelo na CometAPI. Primeiro, verifique se o produto manteve sua identidade; depois, avalie se a segunda referência contribuiu com a luz e a cor pretendidas. Se ela também introduzir objetos ou textos indesejados, simplifique essa referência ou torne o prompt mais explícito.
## Como usar bounding boxes para controle de layout
Use caixas quando o frasco e a manchete precisarem ocupar regiões previsíveis. Escreva uma legenda de cena com um ID para cada elemento e, em seguida, anexe um array JSON ao prompt. O formato da BFL usa bbox em ordem [top, left, bottom, right] em uma grade de 0–1000; as caixas pertencem ao prompt, não a um campo separado da API.
O exemplo abaixo reserva espaço para uma manchete acima do frasco. Mantenha uma configuração de saída em retrato em request.json e salve este arquivo como layout.py ao lado de submit.py. Execute python layout.py e depois python poll_download.py layout-task.json. Use uma rota que suporte essa sintaxe de layout; inspecione o resultado para verificar se o frasco e a manchete ocupam as regiões pretendidas.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
Mantenha a proporção consistente com o layout. Caixas orientam o posicionamento em vez de recortar um objeto a um limite rígido. Inspecione a ortografia e o espaçamento da manchete na imagem salva; adicione a tipografia final da marca em uma ferramenta de design quando a precisão tipográfica for essencial.
## Quanto custa a FLUX 3 Image API?
A CometAPI oferece o FLUX 3 Image a partir de [$0.0384 por requisição](https://www.cometapi.com/models/flux/flux-3-image/) (9 de novembro de 2026). Use essa tarifa inicial para um orçamento preliminar e depois aplique a tarifa exibida para sua configuração selecionada. Os exemplos abaixo assumem que toda requisição faturada usa a tarifa inicial.
| Solicitações faturadas | Tarifa assumida / solicitação | Custo ilustrativo |
| ---------------------- | ----------------------------- | ----------------- |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
Verifique a tarifa para sua configuração e conta antes de se comprometer com um lote. O preço público inicial não estabelece o preço de toda resolução ou opção de edição. Acompanhe tentativas criativas rejeitadas, bem como saídas aprovadas: se você gastar $3.84 em 100 requisições faturadas e aprovar 80 entregáveis, o custo da API por entregável aceito é $0.048, antes de revisão humana e armazenamento. Este é um cálculo ilustrativo, não uma taxa de aceitação medida.
### Escolhas de resolução por fluxo de trabalho
| Fluxo de trabalho | Primeiro teste | Verificação para aprovação |
| --------------------------------| ----------------------------------------------- | -------------------------------------------------- |
| Exploração de prompt | Menor nível suportado útil | Composição e posicionamento do assunto |
| Imagens de produto para e-commerce | Um rascunho com o corte pretendido | Geometria do produto, rótulos e detalhes de borda |
| Arte de campanha/editorial | Rascunho primeiro; saída maior após aprovação do layout | Tipografia e detalhe no tamanho de entrega |
| Edições baseadas em referência | Uma configuração suportada adequada à fonte | Regiões inalteradas, identidade do produto e iluminação |
## Quando usar o FLUX 3 Video?
Use FLUX 3 Image para ativos estáticos, como imagem hero de produto, cartaz ou frame de campanha. Se o entregável precisar de movimento, veja o [FLUX 3 Video na CometAPI](https://www.cometapi.com/models/flux/flux-3/), listado sob o ID de modelo separado flux-3. Seu [fluxo de vídeo](https://apidoc.cometapi.com/api/video/flux-3/create) usa configurações e cobrança específicas de vídeo. Mantenha requisições de imagem e vídeo separadas; duração, áudio e controles de frames de vídeo não pertencem a uma requisição de imagem estática.
Para uma campanha com ambos os formatos, aprove primeiro a composição da imagem estática e depois prepare o briefing de motion separadamente. Verifique os requisitos de entrada de referência do modelo de vídeo antes de reutilizar uma imagem aprovada como material-fonte.
## Conclusão
Comece com um briefing de produto e um job de imagem pequeno. Envie pela sua rota FLUX 3 Image na CometAPI, salve o ID da tarefa, recupere a imagem concluída e revise o resultado antes de escalar. Use width e height quando precisar de uma tela exata ou match_input para uma edição com referência quando suportado. Compare o gasto total com o número de imagens aprovadas para que seu orçamento reflita resultados utilizáveis.
## Metadados de SEO
Título meta: FLUX 3 Image API Guide: Generation, Editing & CometAPI
Meta descrição: Use FLUX 3 Image na CometAPI para geração e edição. Saiba sobre parâmetros de imagem, tratamento de tarefas assíncronas, exemplos de prompt e preços a partir de $0.0384 por requisição.
Palavras-chave: FLUX 3 Image API, CometAPI FLUX 3 Image, FLUX 3 image editing, FLUX 3 pricing, reference image generation, FLUX.2 migration
Slug de URL: flux-3-image-api-guide