GPT Image 2.5 Sunburst API
A API GPT Image 2.5 Sunburst (gpt-image-2.5-sunburst) na APIMart executa o modelo de precisão da família GPT Image 2.5 da OpenAI. Ele oferece controle mais fino em edições sucessivas, para anúncios prontos para veicular e imagens de produto finais. Suporta edição com máscara e saída 4K pelo mesmo preço por token do GPT Image 2.5 Flare, mas leva mais tempo para gerar.
Destaques do Serviço
- Descontos Oficiais
- Pagamento conforme uso
- Rápido e baixa latência
Adicione pelo menos uma imagem de referência ao usar uma máscara.
Image link valid for 72 hours
Preços da GPT Image 2.5 Sunburst API
Preços transparentes, sem taxas ocultas. Pague apenas pelo que usar.
gpt-image-2.5-sunburstPreço (por imagem)
Economize 20%Exibindo: preço de membro Ouro
O preço é calculado com base no uso de tokens — esta configuração consome cerca de 196 tokens.
* Custo estimado de saída de uma imagem, sem incluir a entrada do prompt e das imagens de referência. A cobrança final depende dos tokens utilizados.
API GPT Image 2.5 Sunburst - edição de imagens OpenAI precisa
A API GPT Image 2.5 Sunburst na APIMart foi feita para trabalhos em que cada detalhe conta: altere um elemento mantendo assunto, composição e identidade da marca, e refine em várias rodadas até entregar em 4K. Mesmo preço por token do Flare.
50K+
Usuários Ativos
99.9%
Tempo Ativo
2x
Mais Rápido
70%
Economia de Custos
Exemplo da API GPT Image 2.5 Sunburst: texto para imagem 4K e edição com máscara
Chame gpt-image-2.5-sunburst com uma única solicitação POST. A geração é assíncrona e leva mais tempo que no Flare: envie a tarefa e consulte o endpoint de tarefas até obter a URL da imagem.
- 1
Autenticar a API GPT Image 2.5 Sunburst
Guarde sua chave da APIMart na variável de ambiente APIMART_API_KEY e envie-a em toda solicitação como Authorization: Bearer <key>.
- 2
Enviar uma tarefa do GPT Image 2.5 Sunburst
POST /v1/images/generations com model gpt-image-2.5-sunburst, o prompt, size, resolution e quality. Para editar, adicione image_urls e mask_url. O ID da tarefa fica em data[0].task_id.
- 3
Obter o resultado do GPT Image 2.5 Sunburst
Consulte GET /v1/tasks/{task_id} a cada 2–5 segundos até status ser completed e leia data.result.images[0].url[0]. A APIMart guarda os resultados por 72 horas: baixe a tempo os arquivos que quiser manter.
Veja todos os parâmetros, regras de tamanho e campos de resposta na referência da API GPT Image 2.5.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-sunburst",
"prompt": "Frasco de skincare de luxo sobre uma pedra preta molhada, contraluz suave, gotas de água, foto de produto editorial",
"n": 1,
"size": "4:5",
"resolution": "2k",
"quality": "xhigh"
}'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": "gpt-image-2.5-sunburst",
"prompt": "Frasco de skincare de luxo sobre uma pedra preta molhada, contraluz suave, gotas de água, foto de produto editorial",
"n": 1,
"size": "4:5",
"resolution": "2k",
"quality": "xhigh"
}
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": "gpt-image-2.5-sunburst",
"prompt": "Alterar apenas a área do rótulo mascarada para SUMMER EDITION em uma fonte sem serifa limpa, sem mudar mais nada",
"image_urls": [
"https://example.com/product.png"
],
"mask_url": "https://example.com/product-mask.png",
"resolution": "2k",
"quality": "xhigh"
}'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 API GPT Image 2.5 Sunburst
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
model | string | Sim | Padrão: gpt-image-2.5-sunburst | Use gpt-image-2.5-sunburst. gpt-image-2.5-flare aceita os mesmos parâmetros. |
prompt | string | Sim | Padrão: — | O que gerar ou alterar. Descreva o assunto, a cena, a composição, o estilo, a luz e o que não deve mudar. |
size | string | Opcional | Padrão: auto | auto, uma de 15 proporções (de 1:1 a 21:9 e 3:1) ou dimensões em pixels como 1600x1200. Na edição, se omitido, segue a imagem de entrada. |
resolution | string | Opcional | Padrão: 1k | 1k, 2k ou 4k. Usado com uma proporção em size. |
quality | string | Opcional | Padrão: auto | low, medium, high, xhigh, max ou auto. auto reserva pela tarifa de max e liquida pelo uso real. |
n | integer | Opcional | Padrão: 1 | Número de imagens, 1–4. |
output_format | string | Opcional | Padrão: png | png, jpeg ou webp. output_compression (0–100) vale apenas para jpeg e webp. |
background | string | Opcional | Padrão: — | transparent, opaque ou auto. transparent exige png ou webp. |
image_urls | array | Opcional | Padrão: — | Até 16 URLs HTTP(S) públicas de imagens de referência. A presença delas ativa o modo de edição. |
mask_url | string | Opcional | Padrão: — | Máscara PNG com canal alfa do tamanho da primeira imagem de entrada; as áreas transparentes são editadas. |
Família de modelos GPT Image API
Compare todos os modelos GPT Image na APIMart. Uma única chave de API chama todos eles; GPT Image 2.5 Flare e Sunburst têm os mesmos parâmetros e preços.
| Modelo | Ideal para | Resolução / formato |
|---|---|---|
| GPT Image 2.5 API | Flare e Sunburst em uma só página, com até 16 imagens de referência, máscaras e fundo transparente | 1K / 2K / 4K |
| GPT Image 2.5 Flare API | Imagens rápidas do dia a dia, geração em lote e prototipagem rápida | 1K / 2K / 4K |
| GPT Image 2.5 Sunburst APIEsta página | Edição precisa para assets de produção, criativos de anúncios e edição em várias etapas | 1K / 2K / 4K |
| GPT Image 2 API | Texto para imagem e edição com até 16 imagens de referência e 15 proporções | 1K / 2K / 4K |
| GPT Image 1.5 API | Texto para imagem e edição com até 5 imagens de referência e máscaras | 1:1 / 3:2 / 2:3 |
| GPT Image 1 API | Geração anterior: texto para imagem e edição com até 5 imagens de referência e máscaras | 1:1 / 3:2 / 2:3 |
