GPT Image 2.5 API
OpenAI GPT Image 2.5 — endpoints de texto para imagem e edição em dois níveis, Flare (rápido, equilibrado) e Sunburst (foco em precisão), com cinco níveis de qualidade de low a max, saída em 1K / 2K / 4K, quinze proporções de tela e edições baseadas em até 16 imagens de referência. Mesmo formato de requisição do GPT Image 2, com preços menores por imagem.
Quatro endpoints em uma só família: openai/gpt-image-2.5-flare e openai/gpt-image-2.5-sunburst, cada um com texto para imagem e edição. O Flare é o nível rápido e equilibrado para a geração do dia a dia, com baixa latência; o Sunburst dedica mais tempo a cada imagem para ganhar fidelidade em detalhes intrincados. Ambos recebem os mesmos parâmetros — quality (low / medium / high / xhigh / max), resolution (1k / 2k / 4k), quinze proporções de tela de 1:3 a 3:1 e saída em png / jpeg / webp — e custam o mesmo, a partir de US$ 0,01 por imagem.
/filters:quality(82)/examples/65eb1f4358f095655be595f6383ac7b1/778f811f-f612-4f0e-88c6-a2db94a2f825-15cd7658cdfc.webp)
Visão geral
Sobre o GPT Image 2.5 API
O que o GPT Image 2.5 faz, como ele se encaixa na linha de modelos da OpenAI e por que as equipes o escolhem.
GPT Image 2.5 é um modelo de geração e edição de imagens da OpenAI, disponível pela API REST da WaveSpeedAI. OpenAI GPT Image 2.5 — endpoints de texto para imagem e edição em dois níveis, Flare (rápido, equilibrado) e Sunburst (foco em precisão), com cinco níveis de qualidade de low a max, saída em 1K / 2K / 4K, quinze proporções de tela e edições baseadas em até 16 imagens de referência. Mesmo formato de requisição do GPT Image 2, com preços menores por imagem.
Quatro endpoints em uma só família: openai/gpt-image-2.5-flare e openai/gpt-image-2.5-sunburst, cada um com texto para imagem e edição. O Flare é o nível rápido e equilibrado para a geração do dia a dia, com baixa latência; o Sunburst dedica mais tempo a cada imagem para ganhar fidelidade em detalhes intrincados. Ambos recebem os mesmos parâmetros — quality (low / medium / high / xhigh / max), resolution (1k / 2k / 4k), quinze proporções de tela de 1:3 a 3:1 e saída em png / jpeg / webp — e custam o mesmo, a partir de US$ 0,01 por imagem.
A família GPT Image 2.5 na WaveSpeedAI traz 4 endpoints REST cobrindo os fluxos de Image-To-Image, Text-To-Image. Cada variante tem seu próprio preço, parâmetros e exemplos de resultado — escolha a que combina com sua modalidade de entrada e suas restrições de produção, ou chame várias com a mesma chave de API para montar pipelines de várias etapas.
Execute o GPT Image 2.5 com a mesma chave de API, a mesma conta de cobrança e os mesmos limites de taxa que você usa nos outros mais de 1.000 modelos de IA da WaveSpeedAI. Sem configuração separada por fornecedor, sem SDKs por provedor, sem limites de taxa por fornecedor — uma única integração cobre tudo, de texto para imagem e texto para vídeo até síntese de áudio, geração 3D, ampliação e edição.
Especificações
Recursos e status de lançamento do GPT Image 2.5 API
Os detalhes específicos do modelo que desenvolvedores procuram antes de escolher uma API: disponibilidade, duração esperada do resultado, suporte a referências e a alternativa ativa atual.
Níveis
Flare / Sunburst
Flare para geração rápida e equilibrada do dia a dia; Sunburst para mais fidelidade em detalhes intrincados. Mesmo preço.
Níveis de qualidade
5
low / medium (padrão) / high / xhigh / max em todos os endpoints.
Resolução
1K / 2K / 4K
Os mesmos três níveis em texto para imagem e edição.
Endpoints
4 variantes
texto para imagem e edição para cada um, Flare e Sunburst; a edição aceita até 16 imagens de referência.
Endpoints
Todos os endpoints da API de GPT Image 2.5
4 endpoints de GPT Image 2.5 disponíveis agora na WaveSpeedAI — escolha a variante que combina com seu fluxo de trabalho.
/filters:quality(82)/media/images/1788941905586203566_DzViKczP.webp)
Gpt Image 2.5 Sunburst Edit
OpenAI's GPT Image 2.5 Sunburst Edit edits one or more reference images from natural-language instructions, with five quality tiers up to 4K. Sunburst is the precision-focused GPT Image 2.5 tier that spends more time per image for extra fidelity on intricate detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1788932339711919494_vrbhE9lL.webp)
Gpt Image 2.5 Sunburst Text To Image
OpenAI's GPT Image 2.5 Sunburst Text-to-Image generates high-quality images from natural-language prompts, with five quality tiers up to 4K. Sunburst is the precision-focused GPT Image 2.5 tier that spends more time per image for extra fidelity on intricate detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1788941885532951956_ciRgxR5Q.webp)
Gpt Image 2.5 Flare Edit
OpenAI's GPT Image 2.5 Flare Edit edits one or more reference images from natural-language instructions, with five quality tiers up to 4K. Flare is the fast, balanced GPT Image 2.5 tier for everyday generation at low latency. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1788932462559654416_SrQZ8hrB.webp)
Gpt Image 2.5 Flare Text To Image
OpenAI's GPT Image 2.5 Flare Text-to-Image generates high-quality images from natural-language prompts, with five quality tiers up to 4K. Flare is the fast, balanced GPT Image 2.5 tier for everyday generation at low latency. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Exemplos
Veja o GPT Image 2.5 em ação
Resultados reais gerados pela API do GPT Image 2.5. Passe o mouse sobre qualquer vídeo para pré-visualizar e clique para abrir o visualizador em tamanho real.
Como usar
Como usar a API do GPT Image 2.5
Quatro passos do cadastro até uma geração concluída. Exemplos completos em Python, Node.js e cURL estão na seção de API abaixo.
- 01
Obtenha uma chave de API
Crie uma conta na WaveSpeedAI e copie sua chave de API no painel. Contas novas recebem créditos iniciais grátis — o suficiente para usar o playground algumas dezenas de vezes antes de a cobrança começar.
- 02
Envie uma predição
Faça POST da sua entrada em JSON para https://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image. O endpoint devolve um id de predição imediatamente — as gerações são assíncronas, então você não mantém uma conexão aberta durante a inferência.
- 03
Consulte até concluir
Faça GET em https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Retorne os resultados quando o status for completed; pare com erro em failed, cancelled, timeout ou deleted; continue consultando em qualquer outro status.
- 04
Leia a URL do resultado
Quando o status for "completed", leia a URL em data.outputs[0]. A URL aponta para a mídia gerada na CDN da WaveSpeedAI — imagem, vídeo, áudio ou arquivo 3D, conforme a variante do GPT Image 2.5 que você chamou.
Casos de uso
O que você pode criar com o GPT Image 2.5
Fluxos de trabalho comuns para os quais desenvolvedores e criadores usam a API do GPT Image 2.5.
Flare para velocidade, Sunburst para fidelidade
openai/gpt-image-2.5-flare/text-to-image é o nível do dia a dia: resposta rápida para rascunhos, assets sociais e pipelines em alto volume. openai/gpt-image-2.5-sunburst/text-to-image dedica mais tempo a cada imagem e se sai melhor em detalhes intrincados — peças mecânicas, tecidos, tipografia pequena, cenas densas. Mesmo prompt, mesmo preço; trocar de um para o outro é só mudar o ID do modelo.
Cinco níveis de qualidade em um só controle
O parâmetro quality vai de low / medium / high / xhigh / max. Medium é o padrão e o ponto ideal para trabalho de produção, a US$ 0,024 por imagem 1K; low é um nível de rascunho, a US$ 0,01; high, xhigh e max acrescentam detalhe para assets de destaque e de impressão. Cada nível custa menos que o nível de mesmo nome do GPT Image 2.
Edição com até 16 imagens de referência
openai/gpt-image-2.5-flare/edit e openai/gpt-image-2.5-sunburst/edit recebem uma instrução em linguagem simples mais até 16 imagens de referência. Coloque um produto em uma nova cena, mude a iluminação ou o estilo ou retrabalhe um asset de marca existente mantendo o sujeito intacto. A saída segue a proporção de tela da primeira imagem de referência, a menos que aspect_ratio seja definido.
Até 4K e quinze proporções de tela
Todos os endpoints renderizam em 1k, 2k ou 4k e aceitam quinze proporções de tela — 1:1, 3:2, 2:3, 4:3, 3:4, 4:5, 5:4, 16:9, 9:16, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3 — para que o mesmo prompt atenda a um post quadrado no feed, um hero 16:9 e um banner panorâmico 3:1 sem recortes na pós-produção.
Itere barato, entregue uma vez
Explore a direção do prompt em qualidade low e 1k por um centavo a imagem, defina a composição em medium e depois rode o prompt final na qualidade e na resolução que a entrega exige. O formato da requisição não muda entre os níveis, então o ciclo de iteração é uma edição de dois campos.
Migração direta a partir do GPT Image 2
O GPT Image 2.5 mantém o formato de requisição do GPT Image 2: prompt, images, aspect_ratio, resolution, quality, output_format. Aponte seu código atual para openai/gpt-image-2.5-flare/text-to-image ou /edit, reconfira o nível de qualidade enviado com suas próprias saídas e pronto. O GPT Image 2 continua disponível em paralelo.
Dicas
Dicas de prompt para o GPT Image 2.5
Conselhos práticos para obter melhores resultados com o GPT Image 2.5 — extraídos dos padrões que funcionam em modelos de imagem em pipelines de produção.
- 01
Comece no Flare, promova para o Sunburst
O Flare é o nível rápido e o padrão certo para iteração e volume. Rode de novo no Sunburst apenas os planos que precisam — detalhes mecânicos intrincados, textura de tecido, tipografia pequena — já que os dois níveis recebem parâmetros idênticos e custam o mesmo.
- 02
Reajuste o nível de qualidade após a migração
O GPT Image 2.5 usa uma escala de qualidade de cinco degraus, e não uma simples renomeação dos três do GPT Image 2. Comece em medium, compare com suas saídas atuais nos mesmos prompts e suba um nível se o resultado parecer mais suave que antes ou desça um se o custo for maior que o esperado.
- 03
Rascunho em low / 1k, entrega no nível necessário
Qualidade low em 1k custa um centavo por imagem, o que torna a exploração de prompts praticamente gratuita. Defina a composição ali e depois rode o prompt final em medium ou high e na resolução de entrega.
- 04
Use o endpoint Edit com imagens de referência
openai/gpt-image-2.5-flare/edit e o equivalente Sunburst aceitam até 16 imagens de referência mais uma instrução. Descreva o que deve permanecer inalterado com a mesma clareza do que deve mudar; a saída segue a proporção de tela da primeira imagem, a menos que você defina uma.
- 05
Mantenha marcas e logotipos fora das fotos de produto
Peça um item sem marca, com um rótulo simples, quando quiser um mockup de produto limpo; caso contrário, o modelo inventa com prazer uma marca de aparência real que você não poderá usar.
Preços
Preços da API de GPT Image 2.5
O preço é por resultado. O valor final varia conforme os parâmetros definidos no playground de cada variante (resolução, duração, quantidade de resultados, referências).
| Endpoint | Tipo | Preço inicial |
|---|---|---|
| openai/ | image-to-image | $0.039 |
| openai/ | text-to-image | $0.024 |
| openai/ | image-to-image | $0.039 |
| openai/ | text-to-image | $0.024 |
API
Chame a API de GPT Image 2.5
Crie uma chave de API em wavespeed.ai/accesskey e envie uma predição via REST. O playground gera exemplos prontos para colar para qualquer combinação de entradas.
POSThttps://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"quality": "medium",
"output_format": "png"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"quality": "medium",
"output_format": "png"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"quality": "medium",
"output_format": "png"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Comparar
GPT Image 2.5 vs alternativas
Quando escolher o GPT Image 2.5 em vez de modelos semelhantes na WaveSpeedAI.
GPT Image 2.5 vs GPT Image 2
O GPT Image 2.5 adiciona a divisão Flare / Sunburst, mais dois níveis de qualidade (xhigh e max) e preços menores em todos os níveis — o medium começa em US$ 0,024 por imagem contra US$ 0,06 do medium do GPT Image 2, embora o high do 2.5 seja o equivalente mais próximo em fidelidade ao medium do 2. O GPT Image 2 continua no ar; ambos compartilham os mesmos parâmetros.
GPT Image 2.5 vs Nano Banana 2
O Nano Banana 2 traz consistência de até 5 personagens e busca na web opcional como base. O GPT Image 2.5 responde com cinco níveis de qualidade explícitos, um nível Sunburst para detalhes intrincados, saída em 4K e um endpoint de edição que aceita até 16 imagens de referência.
GPT Image 2.5 vs Seedream 5
O Seedream 5 Pro lidera em layouts densos em informação, edição interativa de precisão e separação de camadas. O GPT Image 2.5 é a escolha para fotografia fiel ao prompt e renderização de texto com um controle simples de qualidade, e seus níveis low e medium custam menos que o Seedream 5 Pro em trabalho de volume.
FAQ
GPT Image 2.5 API — Perguntas frequentes
Preços, licença, integração — perguntas comuns sobre executar o GPT Image 2.5 na WaveSpeedAI.
Qual é a diferença entre o GPT Image 2.5 Flare e o Sunburst?
O Flare é o nível rápido e equilibrado para a geração do dia a dia, com baixa latência. O Sunburst é o nível focado em precisão, que dedica mais tempo a cada imagem para ter mais fidelidade em detalhes intrincados. Ambos recebem parâmetros idênticos e custam o mesmo, então você troca apenas alterando o ID do modelo.
Quanto custa o GPT Image 2.5?
O texto para imagem é cobrado por imagem, conforme a qualidade e a resolução: low US$ 0,01 / US$ 0,02 / US$ 0,03, medium US$ 0,024 / US$ 0,04 / US$ 0,07, high US$ 0,09 / US$ 0,15 / US$ 0,27, xhigh US$ 0,16 / US$ 0,27 / US$ 0,48 e max US$ 0,36 / US$ 0,60 / US$ 1,00 em 1K / 2K / 4K. A edição acrescenta US$ 0,015 por imagem, mais US$ 0,015 para cada imagem de referência além da primeira. Flare e Sunburst têm os mesmos preços.
Como os níveis de qualidade do GPT Image 2.5 se comparam aos do GPT Image 2?
O GPT Image 2.5 tem cinco níveis (low, medium, high, xhigh, max), enquanto o GPT Image 2 tem três, e cada nível custa menos que o nível de mesmo nome do GPT Image 2: o medium custa US$ 0,024 por imagem 1K contra US$ 0,06. Os níveis não são definidos como equivalentes aos do GPT Image 2; por isso, compare as saídas com seus próprios prompts e suba ou desça um degrau a partir do medium conforme necessário.
Quantas imagens de referência a edição do GPT Image 2.5 aceita?
Até 16 por requisição. A saída mantém a proporção de tela da primeira imagem de referência, a menos que você defina aspect_ratio explicitamente.
O GPT Image 2 continua disponível?
Sim. openai/gpt-image-2/text-to-image e openai/gpt-image-2/edit continuam no ar junto com o GPT Image 2.5, para que os pipelines existentes migrem no seu próprio ritmo.
O que é a API do GPT Image 2.5?
GPT Image 2.5 é um modelo de geração de imagens da OpenAI disponibilizado como API REST na WaveSpeedAI. OpenAI GPT Image 2.5 — endpoints de texto para imagem e edição em dois níveis, Flare (rápido, equilibrado) e Sunburst (foco em precisão), com cinco níveis de qualidade de low a max, saída em 1K / 2K / 4K, quinze proporções de tela e edições baseadas em até 16 imagens de referência. Mesmo formato de requisição do GPT Image 2, com preços menores por imagem. Você pode chamá-lo por código ou testá-lo no playground indicado acima.
Como chamo a API do GPT Image 2.5?
Crie uma conta na WaveSpeedAI, copie sua chave de API em /accesskey e faça POST para https://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image com sua entrada em JSON. O endpoint devolve um id de predição. Consulte o endpoint de resultado a cada 2 segundos, aproximadamente, aumente o intervalo em tarefas longas e pare em qualquer status final. Exemplos prontos para produção em Python / Node.js / cURL estão acima.
Quanto custa a API do GPT Image 2.5?
O GPT Image 2.5 começa em $0.024 por execução. O custo exato varia conforme os parâmetros definidos (resolução, duração, quantidade de resultados, referências). A prévia de custo ao vivo ao lado do botão Gerar no playground mostra o preço exato da sua entrada atual.
Quais variantes do GPT Image 2.5 estão disponíveis?
A WaveSpeedAI hospeda 4 endpoints de GPT Image 2.5 ativos: openai/gpt-image-2.5-sunburst/edit, openai/gpt-image-2.5-sunburst/text-to-image, openai/gpt-image-2.5-flare/edit, openai/gpt-image-2.5-flare/text-to-image. Cada variante tem sua própria página de playground e seu preço.
Posso usar os resultados do GPT Image 2.5 comercialmente?
Os direitos de uso comercial seguem a licença do modelo da OpenAI. A maioria dos modelos da OpenAI permite o uso comercial dos resultados; veja o resumo da licença na página do playground de cada modelo e os Termos de Serviço da WaveSpeedAI para as condições da plataforma.
Por que usar o GPT Image 2.5 na WaveSpeedAI em vez de ir direto à fonte?
Uma chave de API e uma conta de cobrança para o GPT Image 2.5 E mais de 1.000 outros modelos de IA de outros provedores. Sem configuração de SDK por fornecedor, sem limites de taxa separados, sem reescrever o código de integração a cada fornecedor. Os preços costumam ser iguais ou menores que os da API direta da OpenAI.
Provedor
Sobre a OpenAI
A equipe por trás do GPT Image 2.5 e de toda a linha de modelos da OpenAI na WaveSpeedAI.
A OpenAI é o laboratório por trás do ChatGPT, do GPT-4 e do GPT-5, do DALL·E, do Sora e do Whisper. Seus modelos de imagem e vídeo são amplamente usados em aplicações de consumo e corporativas, com foco em seguimento de instruções, fotorrealismo e proteções de segurança conservadoras. A API de imagem é uma escolha frequente em marketing e editorial, onde é preciso clareza rigorosa sobre o uso comercial.
Comece a criar com o GPT Image 2.5 na WaveSpeedAI
Créditos iniciais grátis no cadastro. Uma chave de API para mais de 1.000 modelos de IA da OpenAI e de todos os outros provedores.
/filters:quality(82)/examples/c3e3363c7d33a806ce6fe98cf21cf661/9d6b61ad-b809-4f9c-bfe3-0585cc2c1e01-1742669bc9d1.webp)
/filters:quality(82)/examples/1037c9f9d473a54f9d370b4a8fde8373/81e219ea-92d5-4c86-b847-09f80ba124a6-8b0b701ed2fa.webp)
/filters:quality(82)/examples/d057ae3ddd6f23f3c65c80bad61a0252/a5ccbd20-810d-4ed5-99b1-db4019fac97e-8ffa68583377.webp)
/filters:quality(82)/examples/a0d10c2f93ded2a4e86dcb992ca07531/d4a0066f-e831-421e-aac4-33706114407d-a2c6640ae77a.webp)