API Gemini 3 Pro Image (antiga Preview): Preços, Resoluções e Guia de Uso

A API Gemini 3 Pro Image (antiga Preview) —conhecida como Nano Banana Pro— é o modelo de imagem mais avançado da família Gemini do Google, amplamente adotado por equipes de produto ao migrarem da fase de protótipo para a operação em escala.

Este guia cobre a evolução para a nomenclatura oficial GA do Google, o roteamento de compatibilidade na Pixapi, os identificadores por resolução e as diretrizes de integração.

O que é o Gemini 3 Pro Image?

O Gemini 3 Pro Image (gemini-3-pro-image) é o modelo profissional do Google para geração e edição de imagens. Ele aceita requisições de texto para imagem e imagem para imagem, gera saídas de até 4096×4096 (4K) e mantém alta fidelidade na composição original durante edições.

Aspectos fundamentais sobre nomenclatura e compatibilidade:

1. Evolução para o Google GA: Inicialmente lançado como gemini-3-pro-image-preview, o Google padronizou o modelo comercial sob o nome oficial gemini-3-pro-image.
2. Compatibilidade na Pixapi: A Pixapi prioriza o ID oficial gemini-3-pro-image e mantém o alias gemini-3-pro-image-preview, garantindo compatibilidade total com integrações existentes.
3. Nano Banana Pro: É a designação informal da comunidade técnica comumente associada ao Gemini 3 Pro Image.

Preços da API Gemini 3 Pro Image

A Pixapi cobra por meio de créditos, onde 1 crédito = $0.01 USD:

Preços verificados em agosto de 2026. A resolução 2K tem o mesmo valor que 1K ($0.08), representando o ponto de equilíbrio ideal para produção web. Em 4K, a taxa oficial do Google situa-se em torno de ~$0.24, enquanto na Pixapi o custo é de $0.16 (~33.3% de economia). Veja os pacotes na página de preços.

Linha completa de modelos Gemini na Pixapi:

Como realizar chamadas à API

Gere sua chave Bearer no painel da Pixapi e efetue requisições HTTP padrão. Atenção: informe a proporção (1:1, 16:9, etc.) no campo size e selecione a resolução (1K/2K/4K) através do model ID correspondente.

1. Exemplo de texto para imagem: render 2K quadrado

curl -X POST https://api.pixapi.ai/v1/images/generations \
  -H "Authorization: Bearer $PIXAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-2k",
    "prompt": "Studio product photo of a ceramic coffee mug on linen, soft daylight",
    "size": "1:1"
  }'

2. Exemplo de edição de imagens (Image Edits)

Para modificar fundos ou elementos preservando o objeto principal, envie a imagem de entrada para o endpoint de edits:

curl -X POST https://api.pixapi.ai/v1/images/edits \
  -H "Authorization: Bearer $PIXAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "image": "https://example.com/input.jpg",
    "prompt": "Replace the background with a marble countertop, keep the mug unchanged"
  }'

Formatos e proporções suportadas estão na referência da API de geração de imagens. Mantenha suas chaves seguras no backend.

Quando escolher a versão Pro ou Flash

• Pro ($0.08): Ativos finais, banners de destaque, embalagens e peças publicitárias com detalhes finos.
• Flash ($0.04): Geração de rascunhos, testes de variantes e fluxos interativos de alta velocidade.
• Flash Lite / 2.5 Flash ($0.02): Miniaturas, filtros simples e transformações de alto volume.

Uma abordagem comum é utilizar o Flash para gerar opções rápidas com o usuário e renderizar a opção escolhida com o Pro em 2K ou 4K.

Recomendações de boas práticas em produção

1. Defina 2K como padrão: 2K e 1K têm o mesmo valor ($0.08) na Pixapi; proporciona nitidez sem custos adicionais.
2. Utilize 4K com moderação: 4K dobra o custo ($0.16) e deve ser reservado para impressões ou exibições de grande porte.
3. Aproveite o endpoint de edição: Enviar a imagem de referência mantém a geometria de cena de forma muito superior a descrições puramente textuais.

Leituras recomendadas

• GPT Image 2 vs Nano Banana: qual modelo usar?
• Preços da API do Seedance
• Catálogo de modelos e Espaço Nano Banana