FLUX.1 Kontext Pro API
O FLUX.1 Kontext Pro é um modelo contextual para edição e geração de texto para imagem, com preço previsível por imagem e processamento assíncrono de tarefas.
Destaques do Serviço
- Descontos Oficiais
- Pagamento conforme uso
- Rápido e baixa latência
Image link valid for 72 hours
Preços da FLUX.1 Kontext Pro API
Preços transparentes sem taxas ocultas. Pague apenas pelo que usar.
| Variante | Preço OuroPreço atual | Preço Platina | Preço Diamante | Preço oficial | Sua economia |
|---|---|---|---|---|---|
flux-kontext-pro | 0.32Credits(~$0.032)/img | 0.304Credits(~$0.0304)/img | 0.288Credits(~$0.0288)/img | 0.4Credits(~$0.04)/img | 20% |
* Os custos reais dependem da saída final.
Exemplo da FLUX.1 Kontext Pro API: texto para imagem e edição
Chame o flux-kontext-pro com uma única requisição POST. A geração é assíncrona: envie uma tarefa e consulte o endpoint de tarefas para obter a URL da imagem.
- 1
Autentique as requisições à FLUX.1 Kontext Pro API
Guarde sua chave da APIMart na variável de ambiente APIMART_API_KEY e envie Authorization: Bearer <key> em cada requisição.
- 2
Envie uma tarefa do FLUX.1 Kontext Pro
Faça POST /v1/images/generations com model flux-kontext-pro, seu prompt e size. Adicione image_urls para editar com até quatro referências. As URLs example.com são apenas exemplos: substitua-as por imagens suas acessíveis publicamente ou dados Base64. O ID da tarefa fica em data[0].task_id.
- 3
Obtenha o resultado do FLUX.1 Kontext Pro
Consulte GET /v1/tasks/{task_id} até que status seja completed e leia a URL da imagem em data.result.images[0].url[0]. A APIMart guarda os resultados por 72 horas, então baixe as imagens que deseja manter.
Veja todos os parâmetros, tamanhos de saída e campos de resposta na referência da FLUX.1 Kontext API.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-pro",
"prompt": "Um canto de leitura aconchegante com poltrona verde, luz quente de luminária e chuva na janela",
"size": "4:3",
"output_format": "png"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "flux-kontext-pro",
"prompt": "Um canto de leitura aconchegante com poltrona verde, luz quente de luminária e chuva na janela",
"size": "4:3",
"output_format": "png"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-pro",
"prompt": "Troque a jaqueta por couro vermelho-escuro e mantenha o rosto, a pose e o fundo inalterados",
"size": "auto",
"output_format": "png",
"image_urls": [
"https://example.com/portrait.jpg"
]
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Parâmetros da FLUX.1 Kontext Pro API
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
model | string | Sim | Padrão: flux-kontext-pro | Use flux-kontext-pro. |
prompt | string | Sim | Padrão: — | Descreva a imagem a criar ou a edição a aplicar às referências. |
image_urls | string[] | Opcional | Padrão: — | Até 4 imagens de referência como URLs públicas ou Base64. Omita para texto para imagem. |
size | string | Opcional | Padrão: 1:1 | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 9:21 ou auto. A saída fica em cerca de 1 MP: width e height fazem a tarefa falhar e resolution não tem efeito. |
output_format | string | Opcional | Padrão: png | png, jpeg ou webp. |
seed | integer | Opcional | Padrão: — | O mesmo seed e as mesmas entradas ajudam a reproduzir o resultado; omita para um seed aleatório. |
prompt_upsampling | boolean | Opcional | Padrão: false | Deixa o modelo expandir e reescrever o prompt antes da geração. |
safety_tolerance | integer | Opcional | Padrão: 2 | De 0 (mais rigoroso) a 6. |
nsfw_check | boolean | Opcional | Padrão: false | Revisa o prompt e as imagens de entrada com omni-moderation-latest antes do envio. |
Compare os modelos da API FLUX na APIMart
Uma única chave de API da APIMart chama todos os modelos FLUX abaixo. Modelos de imagem são cobrados por imagem e o FLUX 3 Video por segundo de vídeo.
| Modelo | Indicado para | Saída |
|---|---|---|
| FLUX 3 Image API | A FLUX 3 API para imagens: geração e edição com até 10 referências, busca de contexto e saída até 4K | 768sq a 4K (cerca de 16 MP) |
| FLUX 3 Image Klein API | Imagens FLUX 3 mais baratas com seed, 1–16 passos e saída PNG ou JPEG | 768sq a 4K (cerca de 16 MP) |
| FLUX 3 Video API | Texto para vídeo, 1–10 quadros-chave, continuação de vídeo e rascunhos, com áudio sincronizado | HD ou FHD, 5–20 s |
| FLUX.2 API | Escolher entre FLUX.2 Pro, Max e Flex numa única página | 1–4 MP |
| FLUX.2 Pro API | Equilíbrio entre qualidade e custo para produção, até 8 referências | 1–4 MP |
| FLUX.2 Max API | A maior qualidade da linha FLUX.2, até 8 referências | 1–4 MP |
| FLUX.2 Flex API | Steps e guidance ajustáveis para tipografia e layouts | 1–4 MP |
| FLUX.1 Kontext API | Escolher entre FLUX.1 Kontext Pro e Max numa única página | Cerca de 1 MP |
| FLUX.1 Kontext Pro APIEsta página | Edição contextual com preço fixo por imagem, até 4 referências | Cerca de 1 MP |
| FLUX.1 Kontext Max API | Edições Kontext de maior qualidade e mais fiéis ao prompt | Cerca de 1 MP |
