GPT Image 2 API via Flatkey: preços, modelos e verificações de requisição

GPT Image 2 API acesso por meio da Flatkey deve começar com uma verificação da linha do modelo, e não com um bloco de código copiado. A OpenAI documenta gpt-image-2 como um modelo atual de geração de imagens, e o snapshot de preços da Flatkey de 17 de junho de 2026 lista linhas da família GPT image. A pergunta útil para uma equipe de produção é mais restrita: qual linha sua aplicação chamará, que formato de endpoint essa linha expõe, qual unidade de preço a área financeira deve revisar e quais verificações da solicitação devem passar antes que o tráfego siga pelo roteador?

Este guia percorre essas verificações para equipes que querem uma única chave Flatkey, a URL base compatível com OpenAI https://router.flatkey.ai/v1, logs de uso e revisão de preços em um só lugar. Trate cada exemplo de código abaixo como um modelo. O artigo usa documentação oficial da OpenAI, um snapshot catalogado e datado da Flatkey, e verificações de CMS/rota pública, mas não afirma que um teste de inferência ao vivo da Flatkey GPT Image 2 API foi executado.

Resposta Rápida: O Que Verificar Antes de Usar a GPT Image 2 API Através da Flatkey

Se você estiver avaliando a GPT Image 2 API através da Flatkey, verifique estes itens nesta ordem:

1. Abra os preços da Flatkey e procure a linha exata do modelo, como gpt-image-2 ou openai/gpt-image-2.
2. Confirme o tipo de endpoint suportado para essa linha. No snapshot de 17 de junho de 2026, as principais linhas de gpt-image-2 expunham openai, enquanto linhas mais antigas de GPT image também expunham image-generation.
3. Verifique o status de disponibilidade. As linhas GPT Image 2 no snapshot mostraram unknown_failure, então o uso em produção precisa de uma checagem atual do painel e de um pequeno teste de smoke.
4. Compare as unidades de preço antes do lançamento. A Flatkey mostrou campos no estilo de razão de tokens para uma linha e um campo model_price com aparência de preço por requisição para outra linha, então não assuma uma única unidade em todas as rotas da GPT Image 2 API.
5. Corresponda o corpo da sua requisição à rota confirmada: estilo da Images API, estilo da Responses API ou um wrapper compatível com OpenAI suportado pela Flatkey.
6. Registre ID do modelo, caminho do endpoint, qualidade, tamanho de saída, formato de saída, contagem de imagens de entrada, contagem de tentativas, uso e custo final por ativo aceito.

Essa sequência importa porque a GPT Image 2 API não é apenas um nome de modelo. Ela é uma combinação de ID do modelo, endpoint, parâmetros de requisição, entitlement da conta, status de roteamento e unidade de cobrança.

O que a OpenAI documenta para a GPT Image 2 API

O guia de imagens da OpenAI diz que os modelos GPT Image podem usar entradas de texto e imagem para criar novas imagens ou editar as existentes, e descreve gpt-image-2 como um modelo de geração de imagens de última geração, com forte aderência a instruções e consciência contextual. O guia também diz que as equipes podem gerar ou editar imagens usando a Images API ou a Responses API.

Para o caminho da Images API, a referência de criação de imagem documenta POST /images/generations. Ela inclui parâmetros importantes para verificações de requisição em produção: prompt, background, moderation, output_format, quality, size, stream e n. Também afirma que os modelos de imagem GPT retornam imagens codificadas em base64, em vez de URLs temporárias de imagem.

Verificação da OpenAI	Por que isso importa para a Flatkey	Ação em produção
model	O ID do modelo direto da OpenAI pode não ser a mesma string de uma linha roteada do catálogo.	Anote a linha exata da Flatkey e a string do modelo na sua requisição.
POST /images/generations	Este é o caminho oficial de geração da Images API, mas o suporte ao endpoint da Flatkey é específico por linha.	Use esta rota pela Flatkey apenas depois que o painel mostrar suporte à Images API para a linha selecionada.
background e output_format	Saída transparente requer um formato compatível, como PNG ou WebP.	Valide o formato de saída antes de criar fluxos de trabalho de design que dependem de alpha.
quality e size	São alavancas importantes de custo e latência para workloads da GPT Image 2 API.	Separe configurações de rascunho, pré-visualização e renderização final na lógica do produto.
Tratamento de resposta base64	Os modelos de imagem GPT retornam bytes de imagem, não URLs hospedadas de longa duração.	Armazene a imagem você mesmo, anexe metadados e evite depender de uma URL do provedor.

Instantâneo do catálogo Flatkey para imagem GPT 2

Em 17 de junho de 2026, a API pública de preços da Flatkey retornou a versão de preços a42d372ccf0b5dd13ecf71203521f9d2 e 638 linhas de modelos. O resumo da família de imagens GPT incluiu gpt-image-2, openai/gpt-image-2, gpt-image-2-all, gpt-image-1.5, gpt-image-1-mini e gpt-image-1.

Flatkey Row	Groups	Endpoint Types In Snapshot	Pricing Fields Seen	Status In Snapshot	How To Use This Evidence
gpt-image-2	Economy, Standard	openai	model_ratio: 3.325, completion_ratio: 6, cache_ratio: 0.251127819549	unknown_failure	Use como prova de catálogo datada apenas; verifique o status atual da linha antes do tráfego de produção da API GPT Image 2.
openai/gpt-image-2	Standard	openai	quota_type: 1, model_price: 0.063	unknown_failure	Não copie o número sem confirmar a unidade atual e o rótulo do painel.
gpt-image-2-all	Standard	openai	model_ratio: 37.5, completion_ratio: 2	unknown_failure	Verifique se isso é um pacote, alias ou linha de roteamento interna antes de usá-lo no código.
gpt-image-1.5 and gpt-image-1-mini	Standard	image-generation, openai	Ratio-style pricing fields	unknown_failure	Linhas de comparação úteis, mas não substituem a linha selecionada da API GPT Image 2.

A página pública de preços também expõe famílias de endpoint como image-generation com o caminho /v1/images/generations, openai com o caminho /v1/chat/completions e openai-response com o caminho /v1/responses. O detalhe importante é que as famílias de endpoint existem no nível da plataforma, enquanto o suporte ainda é específico por linha. Para a API GPT Image 2, confirme a linha antes de escrever a solicitação.

Solicitações de Verificação para a GPT Image 2 API

Use esta checklist antes de qualquer rollout roteado da GPT Image 2 API. Ela é deliberadamente operacional porque erros de precificação geralmente vêm da forma da solicitação, e não de um mal-entendido sobre uma única taxa de destaque.

Check	Pass Condition	Failure Mode	Where To Verify
Linha do modelo	A linha do dashboard da Flatkey corresponde à string do modelo no código.	O app chama por engano uma linha legada, de alias ou de bundle.	Preços da Flatkey e catálogo de modelos.
Caminho do endpoint	O caminho da rota corresponde ao tipo de endpoint suportado pela linha.	O corpo da Images API é enviado para uma linha compatível com chat, ou o inverso.	Suporte da linha na Flatkey e referência da API da OpenAI.
Disponibilidade	O status do dashboard está limpo, e uma solicitação pequena tem sucesso.	A linha do catálogo existe, mas o upstream ou o acesso à conta falha.	Dashboard da Flatkey, status da resposta e logs.
Unidade de precificação	O time financeiro sabe se a linha é por razão de tokens, por solicitação ou por outra unidade.	O orçamento usa premissas por token para uma linha cobrada por solicitação.	Preços da Flatkey e dashboard de uso.
Prompt e entradas de imagem	O comprimento do prompt, as referências de imagem, as máscaras e as tentativas estão registrados.	Imagens de entrada e novas tentativas geram custo oculto.	Telemetria da aplicação e campos de uso do provedor.
Configurações de saída	Qualidade, tamanho, fundo, formato e compressão estão controlados.	Cada prévia é gerada como um ativo final.	Corpo da solicitação e padrões do produto.

Template: Solicitação Direta à API de Imagens da OpenAI

O template direto do provedor é útil como base ao comparar o comportamento da rota Flatkey. Confirme o acesso atual à conta OpenAI e a disponibilidade do modelo antes de executá-lo.

# Template only: direct OpenAI Images API baseline
curl https://api.openai.com/v1/images/generations \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Create a clean product concept image for a usage dashboard.",
    "size": "1536x1024",
    "quality": "medium",
    "output_format": "png"
  }'

Para um teste de base da API GPT Image 2, mantenha o primeiro prompt simples, evite imagens de referência, use uma única saída e registre o status da resposta, a latência, o tamanho da saída e quaisquer campos de uso retornados pelo endpoint.

Modelo: Verificação de Rota Flatkey

O posicionamento público da Flatkey se concentra em uma chave e uma URL base compatível com OpenAI. Para rotas de texto, a página pública inicial mostra https://router.flatkey.ai/v1/chat/completions. Para roteamento da API GPT Image 2, não presuma que o caminho de imagem esteja habilitado para a linha selecionada. Primeiro verifique se a linha expõe image-generation, openai, openai-response ou outra rota no seu dashboard.

# Apenas modelo: use esta estrutura somente se sua linha Flatkey confirmar suporte a image-generation
curl https://router.flatkey.ai/v1/images/generations \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Create a clean product concept image for a usage dashboard.",
    "size": "1536x1024",
    "quality": "medium",
    "output_format": "png"
  }'

// Apenas modelo: centralize a URL base e então injete o caminho confirmado.
const FLATKEY_BASE_URL = "https://router.flatkey.ai/v1";

async function createImageThroughConfirmedRoute({ path, apiKey, body }) {
  const response = await fetch(`${FLATKEY_BASE_URL}${path}`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(body)
  });

  if (!response.ok) {
    throw new Error(`Falha na verificação da rota Flatkey: ${response.status}`);
  }

  return response.json();
}

// Exemplo apenas após a confirmação no dashboard:
await createImageThroughConfirmedRoute({
  path: "/images/generations",
  apiKey: process.env.FLATKEY_API_KEY,
  body: {
    model: "gpt-image-2",
    prompt: "Create a clean product concept image for a usage dashboard.",
    size: "1536x1024",
    quality: "medium",
    output_format: "png"
  }
});

Se a linha atual da Flatkey ainda expuser apenas openai, pergunte ao produto ou ao suporte qual formato de requisição é suportado para essa linha da API GPT Image 2 antes de colocar em produção. Uma linha de catálogo e um caminho de endpoint são ambos necessários; um sem o outro não é uma integração de produção.

Verificações de Preços Para Executar No Flatkey

Para este artigo, a orientação de preços mais segura é procedural: verifique a linha atual em preços do Flatkey, compare-a com a página atual de preços de imagem da OpenAI e, em seguida, confirme o uso realmente roteado nos logs. O snapshot do Flatkey de 17 de junho prova que o catálogo tinha linhas de imagens GPT, mas os campos das linhas usavam representações de preços diferentes. Isso é suficiente para construir um fluxo de revisão de preços, mas não suficiente para publicar uma afirmação permanente de preço.

Pergunta de Preço	O Que Registrar	Por Que Isso Importa
Qual linha está selecionada?	Nome exato do modelo, grupo, tipo de quota e tipo de endpoint.	Múltiplas linhas da família de imagens GPT podem aparecer no mesmo catálogo.
Qual unidade é exibida?	Relação de tokens, preço por requisição, unidade por saída ou rótulo específico do painel.	Mesclar unidades causa erros de orçamento mesmo quando o nome do modelo está correto.
Quais configurações alteram o custo?	Qualidade, tamanho, comprimento do prompt, entradas de imagem, formato de saída, novas tentativas e comportamento em lote.	A mesma funcionalidade da API GPT Image 2 pode ter níveis de custo de prévia e de renderização final.
O que o Flatkey registra?	Contagem de requisições, status, uso, custo, linha do modelo e motivo da falha.	Os logs comprovam se o uso roteado corresponde à estimativa.

As equipes que comparam orçamentos de imagem também devem ler Preços da OpenAI Image API e Comparação de Preços de Modelos de IA. Esses textos cobrem mecânicas mais amplas de custo de tokens, imagens e vídeo; esta página foca nas verificações de rota específicas do Flatkey para a API GPT Image 2.

Plano de Smoke Test Antes do Tráfego em Produção

Execute uma pequena sequência de validação depois que a linha do dashboard, o endpoint e a unidade de precificação forem confirmados:

1. Envie uma solicitação base direta à OpenAI se sua equipe tiver acesso direto à OpenAI.
2. Envie uma solicitação Flatkey pelo endpoint e pela linha de modelo confirmados.
3. Compare a forma da resposta, o formato da saída, os bytes de saída, as mensagens de falha e a latência.
4. Verifique os logs de uso do Flatkey para linha do modelo, contagem de solicitações, uso e custo.
5. Repita com as configurações exatas de produção: qualidade, tamanho, fundo, formato de saída e quaisquer imagens de entrada.
6. Defina limites de retry e condições de parada antes de expor o recurso aos usuários.
7. Mantenha um caminho de rollback para o fluxo de trabalho de imagem anterior ou para a rota direta do provedor.

Esta é a mesma disciplina operacional descrita no guia de migração para API compatível com OpenAI: altere a rota deliberadamente, mapeie o ID do modelo, execute um pequeno smoke test e use logs antes de escalar.

Quando o Flatkey é o caminho certo para a API GPT Image 2

O Flatkey é uma boa opção quando o seu recurso de imagem faz parte de uma pilha multimodal mais ampla. Um produto pode usar modelos de texto para reescrita de prompts, modelos de imagem GPT para criação de ativos, modelos com visão para revisão e outros provedores para fallback ou controle de custos. Uma chave, uma superfície de preços e um painel de uso tornam esse fluxo de trabalho mais fácil de auditar do que contas separadas de provedores.

O Flatkey não é motivo para pular as verificações no nível do provedor. Para a GPT Image 2 API, o status da linha, o suporte ao endpoint e o corpo da requisição precisam estar alinhados antes do tráfego de produção. O snapshot de 17 de junho mostrou presença no catálogo, não um resultado limpo de disponibilidade.

Checklist Final da API GPT Image 2

• Linha do modelo principal selecionada no preço do Flatkey.
• Suporte de endpoint confirmado para a linha selecionada.
• Unidade de preço e rótulo atual do painel revisados.
• Pequeno teste de rota do Flatkey concluído com a estrutura de solicitação de produção.
• Logs de uso verificados quanto à linha, status, tokens ou unidades de solicitação e custo.
• Limites de repetição, limites de cota e guardrails de rollout configurados.
• Rota de rollback documentada.

A forma mais segura de adotar a GPT Image 2 API por meio do Flatkey é tratar acesso ao modelo, suporte de endpoint e preços como um único ciclo de validação. Ver preços para verificar as linhas atuais de imagens GPT do Flatkey antes de mover o tráfego real de imagens.