Guia de uso

Guia da API GPT Image: IDs de modelo, rotas e migração

Um mapa de validade duradoura: dos antigos nomes de imagem da OpenAI ao GPT Image 2, cobrindo os IDs de modelo atuais da HiAPI, as alternativas Pro descontinuadas e qual página consultar em cada próximo passo.

Jun 24, 2026

Resposta curta

Para novas integrações de imagem diretas da OpenAI, o ID de modelo atual é gpt-image-2. Para novas integrações HiAPI, se a tarefa começa a partir de um prompt, use gpt-image-2/text-to-image; se a tarefa começa a partir de uma ou mais imagens de referência, use gpt-image-2/image-to-image.

Esses nomes são fáceis de confundir porque as pessoas usam "GPT-4o image", "ChatGPT image generation", "GPT Image API" e "GPT Image 2" para se referir a interfaces de produto relacionadas, mas distintas. A abordagem segura é primeiro confirmar qual API você vai chamar e, em seguida, usar o ID de modelo e o contrato de requisição correspondentes a essa API.

Interface	Modelo ou seletor atual	Modo de requisição
OpenAI Image API	`gpt-image-2`	OpenAI `/v1/images/generations` ou `/v1/images/edits`
OpenAI Responses API	Modelos principais suportados mais a ferramenta de geração de imagens	Trabalho de imagem conversacional ou em várias etapas via `/v1/responses`
HiAPI texto para imagem	`gpt-image-2/text-to-image`	`POST https://api.hiapi.ai/v1/tasks`
HiAPI imagem para imagem	`gpt-image-2/image-to-image`	`POST https://api.hiapi.ai/v1/tasks`

A HiAPI não faz proxy do corpo de requisição da OpenAI Image API. Ela oferece as rotas GPT Image por meio de um contrato de tarefa assíncrona unificado, portanto apenas trocar o hostname não conclui a migração.

A linhagem GPT Image que os desenvolvedores precisam conhecer

A linhagem útil é um mapa de migração acionável. Nem todos os nomes abaixo apontam para modelos de API intercambiáveis.

Nome que você pode ver em código antigo ou resultados de busca	Status atual	O que fazer agora
"GPT-4o image generation" ou "ChatGPT image generation"	Expressão de interface de produto ou UI, não um ID de modelo de imagem atual que possa ser colado em uma nova requisição de imagem	Primeiro escolha uma interface de API e depois use o modelo e o contrato de requisição atuais dela
`chatgpt-4o-latest`	Alias de modelo ChatGPT descontinuado; a página atual de modelos da OpenAI lista entrada de imagem, não saída de imagem	Não use como destino de migração para geração de imagens
`gpt-image-1`	A OpenAI o classifica como modelo de geração de imagens de geração anterior e descontinuado	Migre o novo trabalho de imagem para `gpt-image-2`
`gpt-image-1.5`	A OpenAI o classifica como modelo de geração de imagens de geração anterior e descontinuado	Migre o novo trabalho de imagem para `gpt-image-2`
`dall-e-2` ou `dall-e-3`	Descontinuados e removidos da OpenAI API	A OpenAI recomenda `gpt-image-2` para geração e edição atuais
`gpt-image-2`	ID atual de modelo de imagem direto da OpenAI	Use com a OpenAI Image API ou mapeie a tarefa para o ID com barra da HiAPI abaixo

A documentação atual da OpenAI descreve gpt-image-2 como seu modelo de geração de imagens mais avançado e documenta geração texto para imagem e edição de imagens. O Guia de geração de imagens da OpenAI também distingue a Image API de uso único da geração de imagens conversacional via Responses API. As observações sobre status de modelo acima vêm das seguintes páginas oficiais: GPT Image 2, GPT Image 1.5, GPT Image 1, DALL-E 2, DALL-E 3 e ChatGPT-4o, verificadas em 31 de agosto de 2026.

Passar do fluxo de trabalho da UI para o fluxo de trabalho da API

As sessões de imagem do ChatGPT escondem seleção de modelo, estado, repetições e tratamento de arquivos atrás da conversa. As integrações de API precisam tomar essas decisões explicitamente.

O guia oficial da OpenAI recomenda usar sua Image API para geração ou edição única, e a Responses API para trabalho de imagem conversacional e de vários turnos. A HiAPI usa um terceiro contrato: cada tarefa de imagem é uma tarefa assíncrona. Seu backend envia a tarefa, armazena o taskId retornado e recebe o resultado final por callback ou por uma requisição de detalhes da tarefa mais tarde.

O briefing criativo de uma sessão de UI ainda é um prompt inicial útil, mas mova-o para o schema de requisição real da API e teste a saída. Não copie o nome do produto da UI para o campo model e presuma que ele seja um ID de API estável.

Para a HiAPI, mantenha a API key no servidor e envie a tarefa assim:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "A clean launch poster with the exact headline SUMMER DROP",
      "aspect_ratio": "4:5",
      "resolution": "1K"
    },
    "callback": {
      "url": "https://your-domain.com/hiapi/callback",
      "when": "final"
    }
  }'

O objeto callback deve ficar no nível superior, ao lado de model e input. Para depuração local ou conciliação, consulte GET https://api.hiapi.ai/v1/tasks/{taskId} periodicamente. Após o sucesso da tarefa, baixe a imagem de data.output[].url em vez de tratar a URL de saída temporária como armazenamento permanente.

Esta página central mostra intencionalmente apenas uma requisição. Para campos específicos de rota, callbacks, polling e exemplos prontos para copiar e colar, consulte a documentação da API texto para imagem ou a documentação da API imagem para imagem.

Migrar chamadas antigas de imagem da OpenAI para a HiAPI

A migração de modelo da OpenAI e a migração de contrato do provedor são duas mudanças independentes. Primeiro escolha a tarefa de imagem atual e depois reescreva a requisição para a API de tarefas da HiAPI.

Entrada antiga	Destino direto atual da OpenAI	Destino atual da HiAPI
Texto para imagem com `gpt-image-1`, `gpt-image-1.5` ou ID DALL-E	Geração com `gpt-image-2`	`gpt-image-2/text-to-image`
Edição de imagem com `gpt-image-1` ou `gpt-image-1.5`	Edição com `gpt-image-2`	`gpt-image-2/image-to-image`
Fluxo de imagem ChatGPT ou GPT-4o somente de UI	Escolha OpenAI Image API ou Responses API conforme o design de interação	Escolha a rota de tarefa texto para imagem ou imagem para imagem da HiAPI

Ao migrar para a HiAPI, substitua o tratamento de resposta síncrono ou específico da OpenAI por persistência de taskId, tratamento de estado terminal e download de saída. Revalide prompts e saídas; não prometa resultados idênticos pixel a pixel entre interfaces.

Migrar nomes antigos de modelo da HiAPI

A HiAPI agora usa IDs com barra específicos da tarefa e seletores de rota no nível superior. O novo código deve usar a forma canônica de requisição abaixo.

Nome antigo da HiAPI	Requisição atual
`gpt-image-2`	`model: "gpt-image-2/text-to-image"`
`gpt-image-2-image-to-image`	`model: "gpt-image-2/image-to-image"`
`gpt-image-2-beta`	`model: "gpt-image-2/text-to-image"` mais `route: "beta"`
`gpt-image-2-ext`	`model: "gpt-image-2/text-to-image"` mais `route: "ext"`
`gpt-image-2-i2i-ext`	`model: "gpt-image-2/image-to-image"` mais `route: "ext"`

Dados públicos de preço podem escrever as entradas com rota como gpt-image-2/text-to-image@ext ou gpt-image-2/image-to-image@ext. A HiAPI também aceita a forma qualificada por rota, mas a documentação do modelo usa o ID base com barra mais o campo route no nível superior, porque assim fica mais fácil ver o schema de entrada específico da rota.

Substituir os IDs Pro descontinuados da HiAPI

A HiAPI descontinuou dois IDs Pro antigos em 2 de julho de 2026. Eles não aparecem mais nos dados públicos de preço atuais e não devem permanecer em novos exemplos.

ID descontinuado	Substituto
`gpt-image-2-pro`	`gpt-image-2/text-to-image`
`gpt-image-2-image-to-image-pro`	`gpt-image-2/image-to-image`

Esta migração de modelo não garante que cada parâmetro do antigo Pro produza exatamente o mesmo efeito. Consulte o schema de rota atual na documentação do modelo correspondente e depois execute um teste com um prompt e uma imagem de referência representativos antes de trocar em produção.

Onde consultar em seguida

Esta página serve para nomes, linhagem e migração. Escolha o destino de acordo com a pergunta que você quer responder:

Primeiros passos e integração

Página do modelo GPT Image 2 para conhecer o modelo atual e o Playground.
Página do modelo GPT Image 2 imagem para imagem para edição com imagens de referência no Playground.
Documentação GPT Image 2 texto para imagem para os campos de requisição standard, beta e ext.
Documentação GPT Image 2 imagem para imagem para os campos de edição standard e ext, incluindo as diferenças de nomenclatura das imagens de referência.
Preços da API GPT Image 2 para a tabela de rotas atual, os adicionais de imagem de referência e o cálculo de orçamento.
Preços em tempo real da HiAPI para o catálogo completo de modelos atuais.

Casos de uso e evidências de testes reais

Comparações e escolha de modelo

Perguntas frequentes

Qual é o ID de modelo atual da API GPT Image?

Para a Image API direta da OpenAI, é gpt-image-2. Para a HiAPI, use gpt-image-2/text-to-image ou gpt-image-2/image-to-image, dependendo de a tarefa começar a partir de texto ou de uma imagem de referência.

Posso enviar o nome de modelo nu `gpt-image-2` para a HiAPI?

Não use o nome nu em novo código da HiAPI. Os IDs canônicos atuais são os nomes com barra específicos da tarefa mostrados acima, que também tornam o preço, o schema e o roteamento das páginas de modelo mais explícitos.

A HiAPI usa o endpoint `/v1/images/generations` da OpenAI?

Não. Os modelos de imagem da HiAPI usam POST /v1/tasks e depois obtêm o resultado por callback final ou GET /v1/tasks/{taskId}. Os contratos de requisição e resposta da OpenAI Image API e da API de tarefas da HiAPI são diferentes.

Onde o callback deve ficar?

Coloque callback no nível superior do corpo da tarefa, ao lado de model e input. Use callback.when: "final" e torne o serviço receptor idempotente por taskId, porque sucesso e falha são resultados de estado terminal.

O que substitui `gpt-image-2-pro`?

Use gpt-image-2/text-to-image. Para o ID Pro imagem para imagem descontinuado, use gpt-image-2/image-to-image. Consulte o schema de entrada atual e teste uma tarefa representativa antes da troca.

EtiquetasAPI de Imagem Migração