API GPT-Image-2.5: ID do modelo, preços, acesso e exemplos
Compare GPT-Image-2.5 Flare e Sunburst, preços oficiais da API, preços de imagem da APIMaster e exemplos em Python para geração e edição de imagens.
Published 2026-09-09
O GPT-Image-2.5 está disponível na API como dois modelos: gpt-image-2.5-flare e gpt-image-2.5-sunburst. A OpenAI anunciou o lançamento na API em 8 de setembro de 2026. Ambos geram imagens e editam imagens de referência; o Flare é voltado para produção diária rápida, enquanto o Sunburst enfatiza precisão na edição. Este guia explica os IDs dos modelos, os preços oficiais por token, os preços separados por imagem da APIMaster e solicitações práticas de geração e edição.
Status atual da API GPT-Image-2.5
Verificado em 9 de setembro de 2026: ambos os modelos estão documentados pela OpenAI e disponíveis através da APIMaster. Use o ID completo do modelo, incluindo -flare ou -sunburst.
| Pergunta | Resposta atual |
|---|---|
| IDs oficiais dos modelos na API | gpt-image-2.5-flare, gpt-image-2.5-sunburst |
| Disponibilidade oficial na API | Lançado em 8 de setembro de 2026, através da Image API e da ferramenta de geração de imagens da Responses API |
| Gerar ou editar? | Ambos suportam geração e edição de imagens |
| Preço oficial | Baseado em tokens; ambos os modelos têm as mesmas taxas de token publicadas |
| Acesso direto à OpenAI | Uma chave de API da OpenAI e uma organização de API elegível; a verificação da organização pode ser necessária |
| Disponibilidade na APIMaster | Ambos os modelos estão ativos, com geração e edição de imagens de referência testadas |
| Preços de rota exibidos pela APIMaster | 1K: $0,25; 2K: $0,30; 4K: $0,60 por imagem, para qualquer um dos modelos |
Fontes: Registro de lançamento da OpenAI, guia de geração de imagens, preços oficiais e o marketplace ao vivo da APIMaster.
O que é o GPT-Image-2.5?
O Introducing ChatGPT Images 2.5 da OpenAI descreve melhorias em detalhes, iluminação, texturas, fidelidade a imagens de referência e seguimento de instruções de edição em múltiplas etapas. Para desenvolvedores, isso torna a família relevante para fotografia de produtos, variações de campanhas, conteúdo para criadores e fluxos de trabalho que atualizam repetidamente um ativo existente.
A distinção entre ChatGPT e API é importante. ChatGPT Images 2.5 é a experiência de produto; Flare e Sunburst são as opções de modelo da API. Sketch, templates, comentários em imagens e compartilhamento de prompts são recursos do ChatGPT. A presença deles no anúncio não os torna parâmetros de solicitação da API. Da mesma forma, uma assinatura do ChatGPT é separada da cobrança da API da OpenAI.
Amostra de geração da APIMaster, 9 de setembro de 2026. Isso ilustra uma saída de um prompt de teste, não um benchmark comparativo de qualidade.
ID do modelo e variantes da API GPT-Image-2.5
| Opção | ID exato do modelo | Por onde começar |
|---|---|---|
| Flare | gpt-image-2.5-flare |
Geração diária de imagens, iteração rápida, conteúdo para criadores e aplicações de maior volume |
| Sunburst | gpt-image-2.5-sunburst |
Edição detalhada, imagens de produto refinadas e ativos de campanha que exigem controle visual mais rigoroso |
A OpenAI posiciona o Flare como o padrão para a maioria das aplicações e relata 50% menos latência que o GPT-Image-2, com qualidade de imagem melhorada. Essa é a afirmação de lançamento da OpenAI, não uma medição de latência da APIMaster ou uma garantia para cada prompt. A OpenAI descreve o Sunburst como oferecendo precisão adicional com tempos de geração mais longos.
O guia oficial lista as configurações de qualidade low, medium, high, xhigh e max para ambos os modelos, com auto disponível para seleção automática. Essas são configurações dentro de cada modelo; Flare e Sunburst não são valores de qualidade. Não encurte o modelo para um alias não documentado gpt-image-2.5.
Para a Image API direta, coloque o ID do modelo de imagem no campo model da solicitação. Para a Responses API da OpenAI, o modelo de nível superior é um modelo principal suportado; o modelo de imagem pertence ao campo model da ferramenta de geração de imagens. Os exemplos da APIMaster abaixo cobrem as rotas da Image API testadas.
Preços da API GPT-Image-2.5
Preços oficiais por token da OpenAI
A página oficial de preços lista estes preços padrão em USD por um milhão de tokens, idênticos para Flare e Sunburst:
| Categoria de token | Entrada | Entrada em cache | Saída |
|---|---|---|---|
| Texto | $5,00 | $1,25 | Não listado |
| Imagem | $8,00 | $2,00 | $30,00 |
Não existe um preço fixo oficial universal de $0,25 por imagem. O custo total depende da entrada de texto, da entrada de imagem de referência ao editar e dos tokens de saída de imagem. Qualidade, dimensões e o modelo escolhido podem afetar o consumo de tokens. A OpenAI observa explicitamente que taxas de token iguais não implicam custo igual por imagem.
Para um cálculo ilustrativo, uma solicitação usando 100 tokens de entrada de texto sem cache e 10.000 tokens de saída de imagem, sem imagem de referência, custa:
(100 / 1,000,000 x $5) + (10,000 / 1,000,000 x $30) = $0.3005
Essas contagens de tokens são suposições para o cálculo, não um preço medido de 1K, 2K ou 4K. Para uma edição, adicione os custos de entrada de imagem. Use o usage retornado e a orientação oficial de custo de imagem para sua carga de trabalho. Solicitações da Responses API também incorrem em cobranças de tokens do modelo principal.
Preços por imagem das rotas da APIMaster
A APIMaster atualmente exibe os seguintes preços de canal separados, verificados em 9 de setembro de 2026:
| Modelo | 1K / imagem | 2K / imagem | 4K / imagem |
|---|---|---|---|
| GPT-Image-2.5 Flare | $0,25 | $0,30 | $0,60 |
| GPT-Image-2.5 Sunburst | $0,25 | $0,30 | $0,60 |
Estes são preços de rota da APIMaster, não taxas de token da OpenAI ou estimativas oficiais por imagem. Verifique o marketplace ao vivo e o grupo de conta selecionado antes de fazer orçamento: oferta de canal, preços e multiplicadores de conta podem mudar. No preço base exibido, 100 imagens no nível 1K custariam $25 antes de qualquer ajuste específico da conta.
Os nomes de resolução são níveis de canal, não uma promessa de dimensão quadrada fixa. Em nossos testes quadrados de 9 de setembro, 2K retornou 2048x2048 e 4K retornou 2880x2880. Verifique as dimensões da imagem retornada quando sua aplicação exigir um tamanho exato de pixel.
Como chamar a API GPT-Image-2.5
OpenAI direto: gerar uma imagem
Instale o SDK Python atual com pip install -U openai e defina OPENAI_API_KEY no seu ambiente. Este exemplo segue o guia oficial da Image API; ele usa o endpoint padrão da API e a cobrança da OpenAI.
import base64
from pathlib import Path
from openai import OpenAI
client = OpenAI()
result = client.images.generate(
model="gpt-image-2.5-flare",
prompt="A studio product photograph of a red ceramic teapot on a teal table.",
)
Path("generated.png").write_bytes(base64.b64decode(result.data[0].b64_json))
Use gpt-image-2.5-sunburst para experimentar o outro modelo. A OpenAI documenta /v1/images/generations para geração e /v1/images/edits para edição. Sua organização pode precisar de verificação; consulte seu projeto na OpenAI para acesso e limites de taxa.
APIMaster: gerar uma imagem
Crie uma chave no console da APIMaster, garanta que a conta tenha crédito disponível, instale requests e defina APIMASTER_API_KEY. Isso usa o esquema de canal testado da APIMaster: size é uma proporção de aspecto, e resolution seleciona o nível de preço. Essas convenções de canal não devem ser copiadas para uma solicitação direta à OpenAI.
import os
import requests
response = requests.post(
"https://apimaster.ai/v1/images/generations",
headers={"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"},
json={
"model": "gpt-image-2.5-flare",
"prompt": "A studio product photograph of a red ceramic teapot on a teal table.",
"size": "1:1",
"resolution": "1K",
"n": 1,
},
timeout=720,
)
response.raise_for_status()
print(response.json()["data"][0]["url"])
A rota síncrona retorna a URL da imagem gerada após a conclusão. Baixe o resultado imediatamente para armazenamento durável. Este exemplo omite intencionalmente opções avançadas de qualidade e máscara cuja disponibilidade depende do canal.
APIMaster: editar uma imagem de referência enviada
Coloque sua imagem de referência em reference.png e envie uma solicitação multipart para /v1/images/edits. Mantenha o arquivo de imagem aberto até a solicitação terminar; requests define o tipo de conteúdo multipart e o boundary automaticamente.
import os
import requests
with open("reference.png", "rb") as image:
response = requests.post(
"https://apimaster.ai/v1/images/edits",
headers={"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"},
data={
"model": "gpt-image-2.5-sunburst",
"prompt": "Change only the background to pale lavender. Keep all foreground shapes, colors, positions, and printed text unchanged.",
"size": "1:1",
"resolution": "1K",
"n": 1,
},
files={"image": ("reference.png", image, "image/png")},
timeout=720,
)
response.raise_for_status()
print(response.json()["data"][0]["url"])
O mesmo padrão de upload funciona com gpt-image-2.5-flare. A APIMaster aceita a solicitação do cliente em /v1/images/edits e adapta a entrada de imagem de referência ao canal upstream selecionado. Isso não implica que todo upstream use o mesmo endpoint nativo ou suporte todas as opções de edição da OpenAI. Máscaras enviadas não são suportadas na rota atual.
Entrada de referência para o teste de edição.
Edição de imagem de referência do Sunburst, 9 de setembro de 2026. A instrução solicitou uma mudança de fundo mantendo formas, cores, posições e texto. Inspecione as saídas contra seus próprios critérios de aceitação antes de usá-las em produção.
O GPT-Image-2.5 está disponível na APIMaster?
Sim. Abra a página de detalhes do modelo Flare ou a página de detalhes do modelo Sunburst. Cada uma seleciona o modelo correspondente, exibe seus preços por resolução e suporta gerar uma imagem ou enviar uma referência para edição imagem-a-imagem após fazer login.
Nossa execução de aceitação de produção de 9 de setembro passou em 24 casos de API em ambos os modelos e retornou 30 imagens. A cobertura incluiu geração, edição de imagem de referência multipart e JSON, níveis 2K e 4K, solicitações assíncronas e resultados de múltiplas imagens. Os testes de integração confirmam os caminhos de solicitação e saídas testados; eles não são uma certificação de impressão digital de identidade de modelo, um benchmark de qualidade ou uma garantia de disponibilidade futura.
Para integrações contínuas, verifique a página do modelo GPT Image, a documentação da API de imagens e a comparação de modelos de imagem. Comece com uma imagem, verifique se o ativo retornado atende aos seus requisitos e então aumente o volume de solicitações dentro dos limites da sua conta.
FAQ
Qual é o nome do modelo da API GPT-Image-2.5?
Use gpt-image-2.5-flare ou gpt-image-2.5-sunburst. A OpenAI documenta esses como dois modelos de API separados. Flare e Sunburst não são valores para o parâmetro quality.
Quanto custa o GPT-Image-2.5?
As taxas padrão da OpenAI para ambos os modelos são $5,00 por milhão de tokens de entrada de texto, $1,25 para entrada de texto em cache, $8,00 para entrada de imagem, $2,00 para entrada de imagem em cache e $30,00 para saída de imagem. A APIMaster exibe separadamente $0,25, $0,30 e $0,60 por imagem para seus níveis de canal 1K, 2K e 4K em 9 de setembro de 2026; ajustes de conta podem ser aplicados.
O GPT-Image-2.5 está disponível através da API?
Sim. O registro de lançamento de 8 de setembro de 2026 da OpenAI confirma ambos os modelos para geração e edição através da Image API e da ferramenta de geração de imagens da Responses API. O acesso direto depende da sua organização na API; a verificação pode ser necessária.
Qual é a diferença entre Flare e Sunburst?
A OpenAI recomenda o Flare para a maioria das aplicações e geração diária rápida de imagens. O Sunburst é voltado para edição mais precisa e trabalho criativo premium, com tempos de geração mais longos. Eles compartilham taxas de token, mas o custo de uma imagem específica pode diferir porque o uso de tokens difere.
A APIMaster suporta edição imagem-a-imagem do GPT-Image-2.5?
Sim. Ambos os modelos suportam o fluxo de upload multipart testado em /v1/images/edits, e ambos são selecionáveis no playground de imagens online. O canal atual não suporta máscaras enviadas; consulte a rota ao vivo antes de depender de opções adicionais.
Posso usar o Sketch ou templates do ChatGPT como parâmetros de API?
Nenhum parâmetro de API desse tipo é estabelecido pelo anúncio de lançamento do ChatGPT. Sketch, templates, comentários em imagens e compartilhamento de prompts descrevem recursos do produto ChatGPT. Use as entradas de imagem e campos de solicitação documentados para integrações de API.
Fontes
- OpenAI: Introducing ChatGPT Images 2.5
- Changelog da API OpenAI: 8 de setembro de 2026
- Guia de geração e edição de imagens da OpenAI
- Preços da API OpenAI
- Marketplace ao vivo de modelos da APIMaster
Documentação oficial e disponibilidade na APIMaster foram verificadas em 9 de setembro de 2026. Preços e acesso podem mudar; use as fontes ao vivo vinculadas ao tomar uma decisão de compra ou integração.