Fundamentos de integração de API GPT Image 2.6: endpoints, IDs de modelo, formatos de saída e preços
Em 4 de novembro de 2026, o Changelog de OpenAI anunciou GPT‑Image‑2.6 Sunburst (gpt-image-2.6-sunburst) e GPT‑Image‑2.6 Flare (gpt-image-2.6-flare), com complexidade ajustável, geração SVG, geração de GIF animado e edição guiada por marcação para modelos GPT Image 2.5/2.6 suportados. O nome da camada de produto Images 2.6 aparece em ChatGPT e Codex; as chamadas do desenvolvedor devem usar IDs de modelo de API. Este artigo resume apenas os fatos de integração verificáveis nas páginas oficiais – sem descontos inventados, comportamento de endpoint não documentado ou comparações de concorrentes não verificadas.
👉 Experimente a API do GPT Image 2.6 na PoYo: preços por imagem e playground online.
Endpoints e escolha do modelo
De acordo com as páginas de modelo Flare e Sunburst, ambas as camadas suportam rotas 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 de referência e alterações guiadas por marcação. As mesmas páginas de modelo marcam Respostas (v1/responses) como não suportadas. Por outro lado, o guia de geração de imagens ainda usa exemplos GPT Image 2.5 para ferramentas de imagem em Respostas; o corpo 2.6 também enfatiza que complexidade, marcação, SVG e GIF são fornecidos “por meio do Image API”. As integrações de produção 2.6 devem, portanto, usar como padrão Image API e não assumir que as configurações da ferramenta Responses da era 2.5 podem simplesmente trocar por um identificador 2.6. Se o negócio depende fortemente da edição conversacional multiturno, verifique novamente se os documentos atualizaram o suporte de Respostas para 2.6 e trate a tabela Endpoints da página modelo como oficial - não extrapole por hábito.
Na seleção, Flare enfatiza a iteração rápida; Sunburst enfatiza detalhes e consistência de edição; os preços unitários do token verificados aqui são idênticos. Antes de usar a imagem GPT, as organizações podem precisar de verificação organizacional no console do desenvolvedor. Para aplicativos voltados para o usuário final, os documentos recomendam passar um identificador de segurança estável e com hash de no máximo 128 caracteres em cada geração ou solicitação de edição; o campo de usuário mais antigo está obsoleto, mas ainda é compatível, com um identificador de segurança não vazio tendo precedência.
Formatos de saída, plano de fundo e campos específicos do 2.6
Os formatos de saída de geração suportam gráficos de rede portáteis (padrão), JPEG, WebP, além das expansões 2.6 SVG e GIF animado. JPEG e WebP permitem uma taxa de compressão; SVG e GIF não suportam esse campo de compactação, nem streaming, imagens parciais ou reescritor de prompt. As edições não suportam saída SVG ou GIF; SVG também não é uma entrada raster aceitável para a interface de edição. Para planos de fundo transparentes, solicite explicitamente a transparência e escolha um formato que suporte um canal alfa; JPEG não. Após a decodificação, inspecione o canal de transparência – um tabuleiro de xadrez desenhado não é o mesmo que pixels transparentes verdadeiros.
O GIF também oferece suporte à contagem de quadros (2 a 64, padrão 9) e duração por quadro em milissegundos (20 a 2.000, padrão 200). Os níveis de qualidade incluem automático, baixo, médio, alto, xalto e máximo; a complexidade inclui baixa, média e alta, padronizando como alta quando omitida. As edições de marcação carregam uma sobreposição transparente do mesmo tamanho por meio do campo de anotação de edição e não podem ser combinadas com uma máscara. Os tamanhos comuns incluem resoluções quadradas e recomendadas de paisagem/retrato; strings personalizadas de largura x altura que atendem a restrições de múltiplos lados e proporção de aspecto também são suportadas. Tamanho, qualidade e plano de fundo podem ser definidos como automáticos para escolha do modelo no prompt.
O guia de solicitação de imagem também observa: omita o parâmetro input-fidelity mais antigo em solicitações de edição de imagem; GPT Image 2.6 não suporta campos no estilo de resumo de raciocínio. Ao migrar fluxos de trabalho existentes, salve primeiro os prompts e amostras de linha de base e, em seguida, compare sob condições correspondentes por nível correspondente (Flare anterior → 2,6 Flare; Sunburst anterior → 2,6 Sunburst anterior), alterando apenas a qualidade ou a complexidade, uma de cada vez.
Preços (valores verificados na página do modelo)
A partir deste artigo, os preços de lista da página modelo Flare e Sunburst correspondem: entrada de texto US$ 5 por milhão de tokens, entrada de texto em cache US$ 1,25; entrada de imagem $ 8, entrada de imagem em cache $ 2, saída de imagem $ 30 por milhão de tokens. As contas reais variam de acordo com o comprimento do prompt, imagens de referência, nível de qualidade e resolução de saída; lote e outros descontos seguem a página de preços do momento. As páginas de modelo no escopo de captura deste artigo não listam um preço fixo por imagem — a cobrança é baseada em token. O parâmetro complexidade não possui taxa separada. Os limites de taxas variam de acordo com o nível de uso e a conta; verifique o console da organização em vez de copiar figuras públicas de outros modelos.
Lista de verificação de integração mínima
Antes do lançamento, confirme item por item: verificação da organização concluída conforme necessário; IDs de modelo formal Flare ou Sunburst passados explicitamente em solicitações de geração e edição; formato de saída estático, vetorial ou de movimento escolhido para a entrega; editar tarefas preferencialmente definir explicitamente a complexidade como baixa para evitar alta profundidade de planejamento padrão; as alterações direcionadas usam uma sobreposição de marcação em vez de coordenadas descritas apenas no texto; medir a latência, a taxa de bloqueio de conteúdo e o custo aceito por imagem em corporações de negócios. Em caso de erros, falhas de cota e de serviço podem usar novas tentativas de espera, mas os erros do usuário na geração de imagens (incluindo blocos de moderação) devem alterar primeiro o prompt ou a imagem de entrada – não tente novamente às cegas. A avaliação e mitigações de segurança estão no cartão oficial do sistema. A disponibilidade do produto em ChatGPT e Codex não equivale automaticamente à cota ou ao status de verificação de um determinado projeto de API. Verifique-os separadamente.
Resumindo: a superfície da interface 2.6 centra-se nas gerações e edições do Image API, com IDs de modelo duplo, formatos de saída expandidos e campos de qualidade, complexidade e marcação como capacidade controlável. Separar estritamente os nomes dos produtos de bate-papo dos identificadores de interface e tratar o endpoint da página de modelo e as tabelas de preços como oficiais completa um caminho em nível de documento, da avaliação ao lançamento, sem incluir configurações de respostas não suportadas ou preços unitários não verificados nas dependências de produção.