Migrar uma chamada básica de imagem do GPT Image 2.5 para o 2.6 exige mudar o ID do modelo. Os endpoints são os mesmos, as tarifas de tokens são as mesmas e os três tamanhos recomendados também. Os pontos que exigem atenção são o Batch, disponível no 2.5, mas não no 2.6; a ferramenta de imagem da Responses, que a documentação da OpenAI descreve de formas diferentes para o 2.5 e o 2.6; e os controles — complexidade, SVG, GIF e marcação — documentados para a Image API da OpenAI, mas ainda ausentes do esquema de parâmetros publicado pelo AIHubMix.
Este tutorial acompanha uma tarefa representativa no AIHubMix: um pôster de 1536x1024 com um título e uma foto de produto. Primeiro, gera três rascunhos baratos com Flare, escolhe um, renderiza a versão final com Sunburst e informa o custo de cada etapa. No caminho, aborda os problemas de migração que falham silenciosamente, em vez de chamar a atenção.
O que continua igual
Os dois modelos 2.6 são gpt-image-2.6-sunburst e gpt-image-2.6-flare. Ambos são chamados por meio de v1/images/generations e v1/images/edits; nenhum deles tem um alias simples gpt-image-2.6. A entrada de texto custa $5 por milhão de tokens, a entrada de imagem custa $8 e a saída de imagem custa $30, exatamente como no 2.5 e no GPT Image 2.
Isso significa que um pipeline baseado na Image API mantém o formato da solicitação. O que muda é a string do modelo, e somente se você quiser usar o novo modelo. A principal razão para mudar logo no primeiro dia é a alegação de velocidade — 50% mais rápido para a família, segundo a página do modelo no AIHubMix.
Armadilhas na migração
O Batch não está disponível
Este é o recurso em que a vantagem do 2.5 é inquestionável. A página do modelo GPT Image 2.5 lista v1/batch como compatível, e o Batch cobra $15 por milhão de tokens de saída de imagem, em vez de $30. A página do modelo GPT Image 2.6 informa que o Batch não é compatível, e a tabela de preços do Batch não inclui nenhum dos dois modelos 2.6.
Se você executa tarefas de imagem durante a noite, não as migre para o 2.6. Continue no 2.5 ou divida a carga de trabalho: rascunhos interativos no 2.6 e renderizações em lote no 2.5. A documentação de imagens do AIHubMix não lista nenhum endpoint de Batch, então essa decisão só se aplica a chamadas diretas à OpenAI.
É preciso verificar os pipelines da Responses
A documentação da própria OpenAI diverge sobre o 2.5. O changelog de setembro lista a ferramenta de geração de imagens da Responses API junto com a Image API, mas a página do modelo 2.5 informa que a Responses não é compatível. No caso do 2.6, as informações são mais claras: a página do modelo informa que a Responses não é compatível, e o changelog de novembro lista apenas v1/images/generations e v1/images/edits.
Se o seu código acessa o 2.5 por meio da Responses, adicione um teste de fumaça antes de mudar o ID do modelo. Uma falha aqui é evidente, mas só se for testada; um pipeline que recorre silenciosamente a outro modelo é pior do que um erro 400.
Os novos controles são exclusivos da Image API
O guia de geração de imagens inclui complexity, edições guiadas por marcação, saída SVG e saída GIF animada na Image API. Nenhum desses recursos está disponível pela ferramenta de imagem da Responses, e SVG e GIF são exclusivos da geração: nenhum deles funciona em /v1/images/edits.
Cada recurso tem suas próprias restrições. SVG exige n=1 e não é compatível com streaming, imagens parciais, output_compression nem prompt_rewriter. GIF usa frame_count (padrão 9) e frame_duration_ms (padrão 200), é exclusivo da geração e também não é compatível com streaming, imagens parciais, output_compression personalizado nem prompt_rewriter. As edições com marcação precisam da imagem original como primeira imagem de entrada e de um PNG transparente separado com as mesmas dimensões; nenhuma das imagens pode exceder 16,777,216 pixels, e o arquivo de marcação tem limite de 50 MB. Não combine markup com mask nem com prompt_rewriter.
Há também uma regra de cobrança para SVG: você paga a tarifa do modelo de imagem pela imagem de referência e a tarifa do modelo de autoria pelos tokens usados para produzir o SVG. O total depende dos dois, então a estimativa habitual por imagem não cobre esse custo.
A documentação de qualidade e tamanho é divergente
Para o 2.5, a OpenAI documenta cinco níveis explícitos de qualidade além de auto: low, medium, high, xhigh e max. Para o 2.6, a calculadora de custos do guia lista os mesmos cinco para ambas as gerações, a referência da API associa xhigh e max apenas às versões específicas do 2.5, e a tabela do AIHubMix por imagem — fonte dos custos abaixo — apresenta preços somente para low, medium, high e auto.
Hoje, as opções seguras para o 2.6 são low, medium, high e auto. A mesma cautela vale para os tamanhos: valores personalizados de WIDTHxHEIGHT estão documentados para GPT Image 2 e 2.5, enquanto o guia do 2.6 recomenda 1024x1024, 1536x1024 e 1024x1536. Use os três tamanhos recomendados até que a documentação do 2.6 seja consistente.
Para quem migra do 1.5, 1024x1024 em alta qualidade custa mais
GPT Image 1.5 e 1-mini serão descontinuados em December 1, 2026, e o 2.5 é indicado como substituto. Se você renderiza principalmente em 1024x1024 com alta qualidade, a mudança não sai barata: a tabela da OpenAI para o 1.5 indica $0.133 para alta qualidade, e a estimativa do AIHubMix para o 2.6 é $0.211, cerca de 59% a mais. Em qualidade média, o custo passa de $0.034 para $0.053; em baixa, cai de $0.009 para $0.006. Em 1536x1024, a alta qualidade no 1.5 custa $0.200, então os $0.165 do 2.6 saem mais baratos nesse tamanho.
Execute a mesma combinação no 2.5 antes de presumir que o 2.6 é melhor: as tarifas de tokens são idênticas, então a diferença entre os dois modelos 2.x está no consumo de tokens, não no preço de tabela.
Como chamar o 2.6 pelo AIHubMix
O AIHubMix disponibiliza os dois modelos 2.6 e cobra as tarifas oficiais. A documentação de geração de imagens do AIHubMix descreve o endpoint mais recente, POST https://aihubmix.com/ai/v1/images/generations. Ele aceita model, prompt, n, size, output_format, image, images, mask, async, extra e os dois campos de webhook.
O detalhe importante é onde fica a qualidade. Em /ai/v1/images/generations, não há um campo quality de nível superior; ele fica dentro de extra:
curl -s https://aihubmix.com/ai/v1/images/generations \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-flare",
"prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline",
"size": "1024x1024",
"n": 3,
"extra": { "quality": "low" }
}'
A resposta inclui um ou mais URLs de saída. Eles ficam disponíveis por pouco tempo — aproximadamente 30 minutos — e devem ser baixados com o mesmo cabeçalho Authorization: Bearer $AIHUBMIX_API_KEY:
curl -s -H "Authorization: Bearer $AIHUBMIX_API_KEY" "<output-url>" -o draft-1.png
A documentação do AIHubMix recomenda /ai/v1 para novas integrações: os endpoints compatíveis com OpenAI em /v1 talvez ainda não sejam compatíveis com os modelos mais recentes, e a lista de modelos na referência legada de imagens inclui gpt-image-2, gpt-image-1.5, gpt-image-1-mini e os modelos DALL·E, mas não o 2.6. O esquema por modelo lista, sim, uma entrada /v1/images/generations para o 2.6, mas /ai/v1 é o caminho que o AIHubMix documenta para o 2.6 e o que adiciona tarefas assíncronas e webhooks.
O que o esquema não expõe
O esquema publicado pelo AIHubMix para o 2.6 aceita apenas os valores png, jpeg e webp em output_format. Ele não tem complexity, markup, frame_count nem frame_duration_ms, e não oferece saída svg ou gif. O esquema está disponível sem autenticação em https://aihubmix.com/call/schema/models/gpt-image-2.6-flare/endpoints e deve ser consultado antes de depender de qualquer um desses recursos pelo gateway.
Essa é uma lacuna no esquema, não uma falha constatada: os recursos estão documentados no lado da OpenAI, e o gateway pode adicioná-los mais tarde. Enquanto não aparecerem no esquema, planeje as tarefas com SVG, GIF e marcação como chamadas diretas à OpenAI.
Erros esperados
| Status | Significado | O que fazer |
|---|---|---|
| 400 | Erro de parâmetro, muitas vezes encaminhado pelo provedor | Verifique o prompt, o tamanho e n |
| 401 | Chave ausente ou inválida | Verifique o cabeçalho Authorization |
| 402 | Cota insuficiente | Adicione créditos |
| 403 | Permissão negada | Verifique a conta, as permissões da chave e as restrições de IP |
| 429 | Limite de requisições atingido | Aguarde e tente novamente |
| 503 | Nenhum canal pode atender à solicitação | Verifique o ID do modelo e tente novamente mais tarde |
Os corpos de erro do AIHubMix incluem um ID de rastreamento tid. Guarde-o para contatar o suporte e não repita sem alterações uma solicitação que retornou 400. Esse é o contrato de /ai/v1; os endpoints legados /v1 indicam cota insuficiente como 403 insufficient_user_quota.
O fluxo de trabalho: três rascunhos, uma versão final
A tarefa é criar um pôster com uma foto de produto e um título. O prompt permanece fixo; apenas o modelo, o tamanho e a qualidade mudam.
Etapa 1 — gere rascunhos com Flare. Uma solicitação com n=3, em 1024x1024 e baixa qualidade, retorna três opções. Com um custo estimado de $0.006 por imagem, a etapa custa $0.018.
Etapa 2 — escolha uma opção. Esta é a parte barata do fluxo de trabalho e a que mais se beneficia da velocidade do modelo. Três rascunhos em uma chamada representam um orçamento normal, não um luxo.
Etapa 3 — renderize a versão final com Sunburst. A composição escolhida recebe um novo prompt em 1536x1024 e alta qualidade. Com um custo estimado de $0.165 por imagem, esta é a etapa mais cara; uma versão final custa cerca de 28 vezes o valor de uma imagem de rascunho, ou aproximadamente nove vezes o custo da etapa com três rascunhos.
curl -s https://aihubmix.com/ai/v1/images/generations \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-sunburst",
"prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline. Refined studio product photography, subtle shadow, no text",
"size": "1536x1024",
"n": 1,
"extra": { "quality": "high" }
}'
Etapa 4 — total. Os rascunhos custam cerca de $0.018 e a versão final, $0.165, totalizando $0.183 para quatro imagens de saída. Se a versão final for renderizada em qualidade média, custa $0.041 e a execução fica em $0.059. Os tokens de texto de entrada acrescentam uma fração de centavo com prompts desse tamanho; uma edição adicionaria tokens de entrada de imagem a $8 por milhão.
Esse valor mostra que não há diferença de custo entre os dois modelos: as mesmas quatro imagens no 2.5 custam o mesmo, porque as estimativas por imagem do AIHubMix são iguais. A razão para usar o 2.6 é ter um ciclo de rascunhos mais rápido e poder transferir futuramente as tarefas de SVG ou GIF para a OpenAI, não reduzir a conta.
Lista de verificação da migração
- Substitua
gpt-image-2.5-sunburstegpt-image-2.5-flarepelos IDs do 2.6 onde quiser usar o novo modelo; mantenha as tarefas de Batch no 2.5. - Confirme se algum pipeline usa a ferramenta de imagem da Responses; a documentação do 2.6 menciona apenas a Image API.
- Use apenas
low,medium,highouautopara a qualidade e mantenha os tamanhos entre os três valores recomendados até que a documentação do 2.6 seja consolidada. - Em
/ai/v1da AIHubMix, defina a qualidade emextra; para a versão 2.6, use/ai/v1, o caminho que a AIHubMix recomenda para novas integrações. - Baixe os URLs de saída em até 30 minutos, usando o cabeçalho Bearer.
- Não presuma que
complexity, markup, SVG ou GIF funcionem pela AIHubMix antes de o esquema listá-los. - Se você usa a versão 1.5, planeje-se para a desativação em 1 de dezembro e verifique novamente o custo da qualidade alta.
Perguntas frequentes
Preciso alterar meu endpoint para usar o GPT Image 2.6?
Na API da OpenAI, não. Ele usa v1/images/generations e v1/images/edits, os mesmos endpoints da versão 2.5; só muda o ID do modelo. Na AIHubMix, use /ai/v1/images/generations, conforme descrito acima.
O GPT Image 2.6 é mais barato que o 2.5?
Não. As tarifas por token são idênticas: US$ 5 por milhão de tokens de entrada de texto, US$ 8 por milhão de tokens de entrada de imagem e US$ 30 por milhão de tokens de saída de imagem.
Por que não posso usar Batch com o GPT Image 2.6?
As páginas do modelo 2.6 da OpenAI indicam que o Batch não é compatível, e a tabela de preços do Batch lista a versão 2.5, mas não a 2.6. O Batch é o fluxo de trabalho mais evidente em que a versão 2.5 continua sendo a melhor opção.
Como defino a qualidade na AIHubMix?
Para a versão 2.6, no endpoint /ai/v1/images/generations, defina-a em extra.quality. O endpoint compatível com OpenAI /v1/images/generations tem um campo quality no nível superior, mas a AIHubMix recomenda /ai/v1 para novas integrações; use /ai/v1 para a versão 2.6.
Posso gerar SVG ou GIF pela AIHubMix?
Não segundo o esquema atual, que lista png, jpeg e webp, mas não inclui complexidade, markup, contagem de quadros nem saída em SVG/GIF. Esses formatos e opções estão documentados para a API de Imagens da OpenAI; consulte o esquema antes de contar com eles pelo gateway.
Por quanto tempo os URLs de saída da AIHubMix ficam disponíveis?
Cerca de 30 minutos. Baixe-os com o mesmo token Bearer e armazene o arquivo por conta própria.
O que acontecerá com o GPT Image 1.5?
Ele será descontinuado em 1 de dezembro de 2026. A OpenAI indica a versão 2.5 como substituta, mas, com qualidade alta e resolução de 1024x1024, a versão 2.6 custa mais por imagem do que a 1.5; em 1536x1024, custa menos.
Continue lendo: a série GPT Image 2.6
O artigo comparativo aborda as tabelas de preços, a alegação de velocidade e os casos em que a versão 2.5 ainda leva vantagem; é por ele que você deve começar se ainda não decidiu se vai migrar.
GPT Image 2.6 vs 2.5: vale a pena atualizar?
