GPT Image 2

Visão Geral

GPT Image 2 é o mais recente modelo de geração de imagens da OpenAI, otimizado para saída em alta resolução, proporções flexíveis e renderização com controle de qualidade. Suporta tanto geração texto-para-imagem quanto edição image-to-image com uma ou múltiplas imagens de referência.

Melhor para: criativos de marketing, composições ultra largas / verticais, renderizações com resolução personalizada e imagens de produto que exigem detalhamento nítido.

Aviso: mantenha um modelo de fallback em produção. O gpt-image-2 está recebendo muito tráfego no momento e o upstream da OpenAI é ocasionalmente instável, podendo causar respostas mais lentas ou erros transitórios. Para tráfego de produção, recomendamos manter um modelo Gemini configurado como fallback: preferencialmente gemini-3-pro-image-preview pela qualidade, ou gemini-3.1-flash-image-preview quando latência e custo são prioritários.

Capacidades

Preços

Créditos por imagem, conforme tamanho de saída × qualidade. A qualidade auto é cobrada com o mesmo valor de high.

Aviso de preços. Os níveis medium / high são cobrados a aproximadamente 80% do preço oficial por imagem da OpenAI (fonte). O nível low é cobrado com mínimo fixo de 1 crédito / imagem devido ao arredondamento de granularidade de créditos, podendo ser superior a 80% do preço oficial em gerações muito pequenas. Uma requisição com size=auto é cobrada como nível 1K por padrão; quality=auto é tratado como high. A cobrança final = valor da matriz × n.

Exemplos

Tamanhos Suportados

Você pode passar um dos presets populares ou especificar um WIDTHxHEIGHT totalmente personalizado.

Presets Populares

1024x1024 · 1536x1024 · 1024x1536 · 2048x2048 · 2048x1152 · 3840x2160 · 2160x3840 · auto

Dimensões Personalizadas

Valores WIDTHxHEIGHT personalizados devem satisfazer todos os critérios abaixo:

• Borda longa não maior que 3840px
• Largura e altura devem ser múltiplos de 16
• Proporção não deve exceder 3:1 (borda longa ≤ 3 × borda curta)
• Contagem total de pixels entre 655,360 e 8,294,400

Se size for omitido ou definido como auto, o modelo escolhe as dimensões mais apropriadas para o seu prompt.

Opções de Qualidade

Início Rápido

Substitua YOUR_API_KEY pela sua chave de API real. Ainda não tem uma? Crie aqui.

curl -X POST "https://api.nanobananaapi.dev/v1/images/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Um gato laranja usando um cachecol laranja abraçando uma lontra, estilo de ilustração calorosa",
    "n": 1,
    "size": "3840x2160",
    "quality": "high"
  }'

const res = await fetch('https://api.nanobananaapi.dev/v1/images/generate', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt:
      'Um gato laranja usando um cachecol laranja abraçando uma lontra, estilo de ilustração calorosa',
    n: 1,
    size: '3840x2160',
    quality: 'high',
  }),
});

const result = await res.json();
console.log(result.data.url);

import requests

res = requests.post(
  'https://api.nanobananaapi.dev/v1/images/generate',
  headers={
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  json={
    'model': 'gpt-image-2',
    'prompt': 'Um gato laranja usando um cachecol laranja abraçando uma lontra, estilo de ilustração calorosa',
    'n': 1,
    'size': '3840x2160',
    'quality': 'high',
  },
  timeout=60,
)

result = res.json()
print(result['data']['url'])

Referência de Parâmetros

Edição de Imagem (image-to-image)

Para editar ou compor a partir de imagens de referência, envie a requisição para /v1/images/edit (ou para o endpoint compatível com OpenAI /api/v1/images/edits) com o campo image definido como uma ou mais URLs públicas. gpt-image-2 não aceita base64 / data: URLs.

curl -X POST "https://api.nanobananaapi.dev/v1/images/edit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Substitua o fundo por uma montanha nevada ao pôr do sol, mantendo o sujeito",
    "image": "https://cdn.example.com/source.png",
    "n": 1,
    "size": "auto",
    "quality": "high"
  }'

const res = await fetch('https://api.nanobananaapi.dev/v1/images/edit', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt: 'Componha esses dois produtos em um fundo de estúdio limpo',
    image: [
      'https://cdn.example.com/product-a.png',
      'https://cdn.example.com/product-b.png',
    ],
    n: 1,
    size: '2048x1152',
    quality: 'high',
  }),
});
const result = await res.json();
console.log(result.data.url);

Melhores Práticas

• Comece com auto: Deixe o modelo escolher tamanho e qualidade para o melhor equilíbrio, depois ajuste.
• Dimensões personalizadas: Escolha múltiplos de 16 próximos a um preset popular para evitar rejeições.
• Limite de proporção: Para banners ultra largos, mantenha a proporção ≤ 3:1 (ex. 3072x1024, não 3840x1024).
• Comprimento do prompt: Mantenha abaixo de 2000 caracteres; prompts concisos geralmente produzem resultados mais nítidos.

Perguntas Frequentes

O gpt-image-2 suporta edição de imagens? Sim. Envie a requisição para /v1/images/edit com image apontando para uma URL pública (ou array de URLs). gpt-image-2 não aceita base64 / data: URLs — hospede o arquivo em um CDN primeiro.

Por que meu tamanho personalizado é rejeitado? As causas mais comuns são: uma dimensão que não é múltiplo de 16, uma borda longa maior que 3840, uma proporção acima de 3:1, ou contagem total de pixels fora do intervalo 655,360–8,294,400.

Como os créditos são calculados? São cobrados por nível de tamanho (1K / 2K / 4K, inferido pelo lado mais longo) × qualidade (low / medium / high; auto cobra como high). Veja a seção Preços. A cobrança final = valor da matriz × n. Todos os créditos estão a 80% do preço oficial da API da OpenAI.

Relacionados

• API Texto para Imagem — Referência completa da API de geração
• Gemini 3 Pro Image Preview — Qualidade profissional de estúdio
• Gemini 3.1 Flash Image Preview — Alta eficiência com resoluções estendidas
• Gemini 2.5 Flash Image — Velocidade máxima, menor custo