announcements

GPT Image 2.6 API: o essencial da integração — endpoints, IDs de modelo, formatos de saída e preços

PoYo Team
6 min read
Share:

GPT Image 2.6 API: o essencial da integração — endpoints, IDs de modelo, formatos de saída e preços

A 4 de novembro de 2026, o Changelog da OpenAI anunciou o GPT‑Image‑2.6 Sunburst (gpt-image-2.6-sunburst) e o GPT‑Image‑2.6 Flare (gpt-image-2.6-flare), com complexidade ajustável, geração de SVG, geração de GIFs animados e edição guiada por marcações para os modelos GPT Image 2.5/2.6 suportados. O nome de produto Images 2.6 aparece no ChatGPT e no Codex; as chamadas de programador têm de usar os IDs de modelo da API. Este artigo resume apenas factos de integração que podem ser verificados nas páginas oficiais — sem descontos inventados, sem comportamento de endpoints não documentado e sem comparações com a concorrência por verificar.

👉 Experimenta a API do GPT Image 2.6 no PoYo: preço por imagem e playground online.

Endpoints e escolha do modelo

Segundo as páginas dos modelos Flare e Sunburst, ambos os níveis suportam as rotas da Image API para geração e edição: POST /v1/images/generations para texto para imagem; POST /v1/images/edits para edições, composição a partir de referências e alterações guiadas por marcações. As mesmas páginas de modelo indicam que a Responses (v1/responses) não é suportada. Em contrapartida, o guia de geração de imagens continua a usar exemplos do GPT Image 2.5 para as ferramentas de imagem na Responses; o texto sobre o 2.6 sublinha também que a complexidade, as marcações, o SVG e o GIF são fornecidos “através da Image API”. As integrações de produção do 2.6 devem, por isso, usar por predefinição a Image API e não assumir que as configurações de ferramentas da Responses da era 2.5 se podem simplesmente trocar por um identificador 2.6. Se o teu negócio depende muito da edição conversacional em vários turnos, verifica de novo se a documentação já atualizou o suporte da Responses para o 2.6 e considera como referência a tabela de Endpoints da página do modelo — não extrapoles por hábito.

Quanto à escolha, o Flare privilegia a iteração rápida; o Sunburst privilegia o detalhe e a consistência das edições; os preços unitários por token aqui verificados são idênticos. Antes de usares o GPT Image, as organizações podem precisar da verificação da organização na consola de programador. Para apps virados ao utilizador final, a documentação recomenda enviar, em cada pedido de geração ou edição, um identificador de segurança estável e com hash, de, no máximo, 128 caracteres; o antigo campo user está descontinuado mas continua compatível, e um identificador de segurança não vazio tem precedência.

Formatos de saída, fundo e campos específicos do 2.6

Os formatos de saída da geração suportam portable network graphics (predefinição), JPEG, WebP e ainda as novidades do 2.6, SVG e GIF animado. O JPEG e o WebP permitem uma taxa de compressão; o SVG e o GIF não suportam esse campo de compressão, nem streaming, imagens parciais ou o reescritor de prompts. As edições não suportam saída em SVG nem em GIF; o SVG também não é uma entrada raster aceite na interface de edições. Para fundos transparentes, pede explicitamente a transparência e escolhe um formato que suporte canal alfa; o JPEG não suporta. Depois de descodificares, inspeciona o canal de transparência — um xadrez desenhado não é o mesmo que pixéis realmente transparentes.

O GIF suporta ainda o número de frames (2–64, predefinição 9) e a duração por frame em milissegundos (20–2000, predefinição 200). Os níveis de qualidade incluem auto, low, medium, high, xhigh e max; a complexidade inclui low, medium e high, com high por predefinição quando omitida. As edições com marcações carregam uma sobreposição transparente do mesmo tamanho através do campo de anotação das edições e não podem ser combinadas com uma máscara. Os tamanhos comuns incluem o quadrado e as resoluções recomendadas em paisagem/retrato; também são suportadas cadeias personalizadas largura×altura que cumpram as restrições de múltiplos do lado e de proporção. O tamanho, a qualidade e o fundo podem ser definidos como auto, para o modelo decidir a partir do prompt.

O guia de prompts de imagem refere ainda: omite o antigo parâmetro de fidelidade de entrada nos pedidos de edição de imagem; o GPT Image 2.6 não suporta campos do tipo resumo de raciocínio. Ao migrar workflows existentes, guarda primeiro os prompts e as amostras de referência e depois compara em condições equivalentes, por nível correspondente (Flare anterior → Flare 2.6; Sunburst anterior → Sunburst 2.6), alterando apenas a qualidade ou a complexidade, uma de cada vez.

Preços (valores verificados nas páginas dos modelos)

À data deste artigo, os preços de tabela das páginas dos modelos Flare e Sunburst coincidem: entrada de texto $5 por milhão de tokens, entrada de texto em cache $1.25; entrada de imagem $8, entrada de imagem em cache $2, saída de imagem $30 por milhão de tokens. As faturas reais variam com o comprimento do prompt, as imagens de referência, o nível de qualidade e a resolução de saída; os descontos de batch e outros seguem a página de preços na altura. As páginas de modelo no âmbito de consulta deste artigo não indicam um preço fixo por imagem — a faturação é por token. O parâmetro de complexidade não tem custo separado. Os limites de pedidos variam consoante o nível de utilização e a conta; consulta a consola da organização em vez de copiares números públicos de outros modelos.

Lista de verificação mínima da integração

Antes do lançamento, confirma ponto por ponto: a verificação da organização foi concluída conforme exigido; os IDs de modelo formais Flare ou Sunburst são passados explicitamente nos pedidos de geração e de edição; o formato de saída (imagem estática, vetorial ou animada) foi escolhido de acordo com o resultado pretendido; nas tarefas de edição, define de preferência a complexidade explicitamente como low, para evitar a profundidade de planeamento high por predefinição; as alterações pontuais usam uma sobreposição de marcações em vez de coordenadas descritas apenas em texto; mede a latência, a taxa de bloqueio de conteúdo e o custo por imagem aceite em corpora do teu negócio. Nos erros, as falhas de quota e de serviço podem usar repetições com backoff, mas os erros de utilizador na geração de imagens (incluindo bloqueios de moderação) devem levar primeiro a alterar o prompt ou a imagem de entrada — não repitas às cegas. A avaliação de segurança e as mitigações constam da system card oficial. A disponibilidade do produto no ChatGPT e no Codex não equivale automaticamente à quota ou ao estado de verificação de um dado projeto de API — verifica-os em separado.

Em resumo: a superfície de interface do 2.6 centra-se nos generations e edits da Image API, com dois IDs de modelo, formatos de saída alargados e campos de qualidade, complexidade e marcações como capacidade controlável. Separar rigorosamente os nomes de produto do chat dos identificadores da interface e considerar como referência as tabelas de endpoints e de preços das páginas dos modelos completa um percurso, ao nível da documentação, da avaliação ao lançamento — sem incorporar na produção configurações da Responses não suportadas nem preços unitários por verificar.

Share: