Família Nano Banana

Os modelos de imagem Gemini do Google, cinco no total. Recomendamos chamá-los pelo endpoint nativo do Gemini, que permite controlar com precisão a proporção e a resolução; o endpoint compatível com OpenAI também funciona, mas suporta apenas parte dos parâmetros.

Tarefas comuns

Definir proporção e resolução Imagens horizontais, verticais e em 4K, com os valores aceitos por cada modelo.Edição e combinação de imagens Enviar imagens e editá-las com uma instrução em texto.Solução de erros 400 invalid argument, proporção incorreta, nenhuma imagem retornada, 410.

Escolha de modelo

ResumoPara casos comuns, recomendamos o Nano Banana 2; para saída em 4K ou composições complexas, use o Pro; para gerar imagens pequenas em lote, use o 2 Lite.

Nano Banana 2.1Mais recente

Três níveis: 1K, 2K e 4K
Suporta proporções de 1:8 a 8:1; 2K e 4K levaram cerca de 2 minutos em nossas medições

gemini-nano-banana-2.1

Nano Banana 2Melhor para o dia a dia

Quatro resoluções, de 512 a 4K
O maior número de proporções, incluindo 1:8 e 8:1

gemini-3.1-flash-image

Nano Banana ProPrioriza a qualidade

Três níveis: 1K, 2K e 4K
Faz reasoning antes de gerar; leva mais tempo

gemini-3-pro-image

Nano Banana 2 LitePrioriza a velocidade

Somente 1K
Cerca de 5 segundos por imagem em nossas medições; saída em JPEG

gemini-3.1-flash-lite-image

Nano BananaGeração anterior

Fixo em cerca de 1K; não permite definir a resolução
Projetos existentes podem continuar usando

gemini-2.5-flash-image

IDs de modelo (copie exatamente como estão)

Nano Banana 2.1google/gemini-nano-banana-2.1Mais recente

Nano Banana 2google/gemini-3.1-flash-imageMelhor para o dia a dia

Nano Banana Progoogle/gemini-3-pro-image4K, composições complexas

Nano Banana 2 Litegoogle/gemini-3.1-flash-lite-imageSomente 1K

Nano Bananagoogle/gemini-2.5-flash-imageGeração anterior

Preços atuais nas páginas dos modelos: Nano Banana 2 e Nano Banana Pro . A cobrança efetiva segue o usageMetadata da resposta.

Escolha de endpoint

ResumoPara controlar proporção e resolução, use o endpoint nativo do Gemini.

	Endpoint nativo do Gemini (recomendado)	Endpoint compatível com OpenAI
Endereço	`POST /gemini/v1beta/models/<ID do modelo>:generateContent`	`POST /v1/images/generations`, `/v1/images/edits`
Proporção	`imageConfig.aspectRatio`	`aspect_ratio` no nível superior
Resolução	`imageConfig.imageSize`: 512, 1K, 2K, 4K	Não suportada; enviar `image_size` retorna 400
`size: "LARGURAxALTURA"`	Não se aplica	Não suportado; use `aspect_ratio` para definir a proporção
`n` (várias imagens)	Não se aplica	Não suportado; cada requisição gera uma imagem
Edição	`inlineData` dentro de `parts`	Upload de arquivo em `/v1/images/edits`
Imagens de referência `input_images`	Não se aplica	Não suportado; para editar, use `/v1/images/edits`
Retorno	`candidates[0].content.parts[].inlineData.data`	`data[0].b64_json`

Latência e timeout

ResumoDefina o timeout do cliente em 300 segundos ou mais.

A API é síncrona. Em nossas medições, 1K levou cerca de 5 a 20 segundos e 4K, cerca de 30 segundos; no Nano Banana 2.1, 2K e 4K levaram cerca de 2 minutos. Nos horários de pico, a latência é maior. O Pro faz reasoning antes de gerar a imagem (a resposta inclui thoughtsTokenCount) e demora mais que o Nano Banana 2 na mesma resolução. O timeout padrão comum de 60 segundos não cobre requisições em 4K nem as feitas em horários de pico; se o cliente desconectar, a requisição é cobrada mesmo assim.

Estrutura da resposta

200 OK (endpoint nativo, data truncado)


{
  "candidates": [{
    "content": {
      "parts": [{ "inlineData": { "mimeType": "image/png", "data": "iVBORw0KGgo…" } }],
      "role": "model"
    },
    "finishReason": "STOP"
  }],
  "modelVersion": "google/gemini-3-pro-image",
  "usageMetadata": {
    "promptTokenCount": 7,
    "candidatesTokenCount": 2000,
    "candidatesTokensDetails": [{ "modality": "IMAGE", "tokenCount": 2000 }],
    "thoughtsTokenCount": 211,
    "totalTokenCount": 2218
  }
}

A imagem está no item de parts que contém inlineData, que não é necessariamente o primeiro: pode haver texto antes dela. Percorra parts para encontrá-la.
A quantidade no item IMAGE de candidatesTokensDetails é o número de tokens da imagem de saída. Em nossas medições, 1K corresponde a 1.120 e o 4K do Pro, a 2.000.
thoughtsTokenCount só aparece nas respostas do Pro e representa os tokens de reasoning anteriores à geração da imagem.

Documentação oficial

A documentação oficial descreve o comportamento das chamadas diretas ao Google; ao chamar pela OfoxAI, prevalecem as conclusões medidas nesta página.

Perguntas frequentes

Como gerar imagens em 4K com o Nano Banana Pro?

Use o endpoint nativo do Gemini e envie imageSize: "4K" em generationConfig.imageConfig, definindo a proporção com aspectRatio. Em nossas medições, um 4K em 16:9 gerou 5504x3072, cerca de 16 MB, em cerca de 33 segundos. O endpoint compatível com OpenAI não suporta imageSize; enviar image_size retorna 400.

Quais proporções o Nano Banana 2 suporta?

Dez proporções comuns: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 e 21:9; além disso, quatro proporções ultralargas ou ultra-altas: 1:4, 4:1, 1:8 e 8:1. Proporções fora da lista retornam 400 Request contains an invalid argument.

O Nano Banana Pro suporta 1:8 ou 4:1?

Não. As proporções 1:4, 4:1, 1:8 e 8:1 só são suportadas pelo Nano Banana 2.1, pelo Nano Banana 2 e pelo Nano Banana 2 Lite; para imagens ultra-altas ou ultralargas, use um desses três.

imageSize deve ser 4K ou 4k?

Recomendamos as maiúsculas 1K, 2K e 4K, como na documentação oficial do Google. Em nossas medições, a OfoxAI também aceita minúsculas. O nível 512 não leva K e só é suportado pelo Nano Banana 2.

Como definir a proporção do Nano Banana pelo endpoint compatível com OpenAI?

Use aspect_ratio no nível superior, por exemplo "16:9". Esse endpoint não suporta parâmetros de resolução; para 2K ou 4K, use imageConfig.imageSize no endpoint nativo do Gemini.

O Nano Banana gera várias imagens de uma vez?

Não; cada requisição gera uma imagem. Para várias imagens, faça várias requisições em paralelo, observando o rate limit.

Qual timeout devo configurar para o Nano Banana?

Recomendamos 300 segundos ou mais. Em nossas medições, 1K levou cerca de 5 a 20 segundos, 4K cerca de 30 segundos e, no Nano Banana 2.1, 2K e 4K cerca de 2 minutos; nos horários de pico, demora mais. O Pro faz reasoning antes de gerar e leva mais tempo que o Nano Banana 2.