Nano Banana 2 API: preço, nome do modelo e custo por imagem

Se você está precificando o Nano Banana 2 para um app, um catálogo de loja ou um pipeline de conteúdo, a resposta cabe em uma linha: o nome do modelo na API é gemini-3.1-flash-image, e o Google cobra US$ 0,045 a US$ 0,151 por imagem gerada, conforme a resolução. O restante deste artigo traz o detalhe que evita uma fatura surpresa: quanto custa cada resolução, como funciona a tarifa em lote com metade do preço, quais taxas extras podem aparecer e como o modelo se compara com o restante da família Nano Banana. Todos os preços vêm das próprias páginas de preços e de geração de imagens do Google, conferidos em outubro de 2026, e tudo o que vem de outra fonte está sinalizado.

💡 Regra prática: reserve cerca de US$ 0,07 por imagem em 1K, US$ 0,10 em 2K e US$ 0,15 em 4K. Divida cada valor pela metade em trabalhos em lote.

Como o modelo se chama

Nano Banana 2 é o apelido. No código você chama gemini-3.1-flash-image, e a página de preços do Google o lista como de disponibilidade geral. A documentação oficial mostra o ID sem sufixo de prévia, o que importa porque tutoriais antigos e alguns gateways ainda usam um nome -preview. Se um trecho de código que você encontrou online falhar, verifique primeiro a string do modelo.

IDs dos modelos da família

O Google lança quatro modelos de imagem relacionados, e os nomes são fáceis de confundir. Esta tabela associa cada apelido ao seu ID na API, com um link para a página correspondente na PicassoIA.

A data de desligamento importa se você mantém código antigo. A página de preços do Google marca gemini-2.5-flash-image como descontinuado, com data de desligamento em 2 de outubro de 2026, então qualquer projeto que ainda aponte para ele precisa de uma nova string de modelo.

Nomes que você verá em revendedores

Gateways de terceiros mantêm seus próprios rótulos. O OpenRouter, por exemplo, lista o modelo como google/gemini-3.1-flash-image-preview, resquício do período de prévia. A string de modelo de um revendedor não é a string do Google, então copie o ID exato da plataforma pela qual você paga. Se você chamar o Google diretamente, use gemini-3.1-flash-image.

Custo por imagem por resolução

O Google cobra a saída de imagem por token e depois publica um preço fixo por imagem em cada tamanho. Na prática, você pode tratar isso como quatro pontos de preço em vez de um medidor em execução.

Tarifas padrão

Cada degrau custa mais do que parece. Passar de 1K para 2K adiciona cerca de 51%, e passar de 1K para 4K multiplica a conta por aproximadamente 2,25. Uma renderização em 4K custa o mesmo que duas renderizações e um quarto em 1K.

Tarifas em lote

A Batch API do Google dá 50% de desconto em tokens de entrada e de saída, o que resulta nestes preços por imagem:

A contrapartida é a velocidade. O trabalho em lote é assíncrono, então serve para catálogos, preenchimentos retroativos e trabalhos noturnos, e não para um botão que um cliente está esperando.

Como funciona a cobrança por token

Por trás dos preços fixos está a cobrança por token: US$ 0,50 por milhão de tokens de entrada (texto e imagens) e US$ 60 por milhão de tokens de saída (a imagem gerada). O lote reduz os dois pela metade, para US$ 0,25 e US$ 30. Seu prompt quase não pesa, já que um prompt de 200 tokens custa cerca de US$ 0,0001. A saída da imagem é o que você paga, então a resolução solicitada define quase toda a conta.

Cobranças além da imagem

• Sem camada gratuita na API. O Google não lista camada gratuita para este modelo, então testar custa dinheiro desde a primeira chamada.
• Grounding na Pesquisa Google. Se você deixar o modelo basear uma imagem na Pesquisa Google, ganha 5.000 requisições de pesquisa gratuitas por mês, compartilhadas por todos os modelos Gemini 3.x, e depois paga US$ 14 por 1.000 requisições. Se cada chamada usasse uma requisição de pesquisa, isso acrescentaria US$ 0,014, cerca de 21% sobre uma imagem em 1K.
• Imagens de referência. São cobradas como tokens de entrada na taxa de US$ 0,50 por milhão.
• Tarifas de revendedores. Plataformas de revenda anunciam seus próprios preços fixos por imagem. Nas listagens verificadas para este artigo, eles variavam de cerca de US$ 0,03 a US$ 0,065, mas esses são valores anunciados, não verificados, então leia os termos antes de montar um orçamento com base neles.

Como ele se compara com os outros modelos da família

Aqui está a família inteira lado a lado, usando os preços por imagem publicados pelo Google.

Quando o Lite basta

Nano Banana 2 Lite custa US$ 0,0336 em 1K, cerca de metade do modelo padrão, mas para em 1K e não oferece grounding. Serve para miniaturas, rascunhos, quadros de inspiração e variações em massa em que você nunca precisará de 2K, 4K ou dados de pesquisa ao vivo.

Quando o Pro ainda vale o preço

Nano Banana Pro custa US$ 0,134 em 1K e 2K e US$ 0,24 em 4K. Em 1K ele custa exatamente o dobro do Nano Banana 2. Em 2K o modelo mais barato economiza US$ 0,033 por imagem (25%), e em 4K economiza US$ 0,089 por imagem (37%). Pague o adicional do Pro apenas quando um teste lado a lado com seus próprios prompts mostrar uma diferença que você realmente consegue ver.

O preço não é o único filtro. Se seus prompts não precisam do grounding do Google nem da fusão de imagens de referência, rode o mesmo briefing em GPT Image 2, Seedream 5 Pro e Flux 2 Pro. Cada um tem sua própria página na PicassoIA, e dez minutos de comparação valem mais do que adivinhar.

Chamando pelo código

A documentação atual do Google mostra o modelo pela Interactions API em Python. Instale google-genai, coloque sua chave de API no ambiente e depois execute:

from google import genai
import base64

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.1-flash-image",
    input="Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme",
)

with open("generated_image.png", "wb") as f:
    f.write(base64.b64decode(interaction.output_image.data))

Copiar prompt

A imagem volta codificada em base64, então decodifique antes de gravar no disco, como fazem as duas últimas linhas. A documentação do Google também descreve uma configuração thinking_level dentro de generation_config, com dois níveis, minimal e high. Verifique como ela afeta latência e custo antes de ativá-la em escala.

Resoluções e proporções

O modelo aceita quatro tamanhos: 0,5K (512px), 1K, 2K e 4K. As proporções aceitas são 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 e 21:9. O Lite se limita a 1K.

Imagens de referência e marca d’água

Você pode enviar até 10 imagens de objetos para inclusão de alta fidelidade e até 4 imagens de personagens para consistência entre cenas. Toda imagem gerada leva uma marca d’água SynthID, o marcador de proveniência do Google, então planeje isso em qualquer fluxo de trabalho de impressão ou de banco de imagens.

Exemplos de custo mensal

Três cargas de trabalho, com tarifas de lista. Todos os valores ignoram impostos e tokens de entrada, que acrescentam cerca de um centavo a cada cem imagens com prompts curtos.

Uma pequena loja com 300 fotos de produtos

Um vendedor de cerâmica que renova um catálogo de 300 itens em 1K paga 300 × US$ 0,067 = US$ 20,10 no endpoint padrão, ou US$ 10,20 pelo lote. Refazer o catálogo inteiro todo mês ainda fica perto de vinte dólares.

Uma equipe de conteúdo em 2K

Uma equipe que produz 2.000 imagens por mês para blog e redes sociais em 2K paga 2.000 × US$ 0,101 = US$ 202 no padrão, ou US$ 100 pelo lote. Se um quarto das imagens precisar de uma nova tentativa, acrescente 25% e a conta padrão passa a ser US$ 252,50.

Uma tiragem de impressão em 4K

Para 500 impressões grandes em 4K, a conta é 500 × US$ 0,151 = US$ 75,50 no padrão, ou US$ 38 pelo lote. As mesmas 500 imagens em 1K custariam US$ 33,50, então o salto para 4K acrescenta US$ 42. Esse upgrade faz sentido para impressão e telas grandes, e raramente para algo visto em um celular.

Quatro erros que inflam a conta

1. Deixar 4K como padrão. Custa cerca de 2,25 vezes uma imagem em 1K. Faça rascunhos em 1K ou 2K e renderize em 4K apenas as escolhas finais.
2. Deixar o grounding com pesquisa ligado o tempo todo. Depois de 5.000 requisições gratuitas por mês, cada 1.000 extras custam US$ 14. Ative apenas para prompts que precisem de fatos atuais.
3. Rodar trabalhos em massa no endpoint padrão. Se ninguém está esperando o resultado, o lote corta o preço pela metade.
4. Apontar o código para um ID descontinuado. gemini-2.5-flash-image tem data de desligamento listada em 2 de outubro de 2026. Use gemini-3.1-flash-image em novos trabalhos.

💡 Dica: registre a resolução e o ID do modelo junto de cada imagem gerada. Quando a fatura chegar, você consegue rastrear qualquer pico até um trabalho específico em segundos.

Rode o Nano Banana 2 na PicassoIA

Código não é o único caminho. Nano Banana 2 na PicassoIA roda no navegador, sem chave de API e sem configuração de cobrança. A página do modelo informa que não há créditos por geração nem cotas de uso, o que a torna um lugar barato para acertar um prompt antes de pagar por chamadas de API. É uma ferramenta de navegador, então, para acesso programático, você ainda chama a API do Google como mostrado acima.

1. Abra a página do modelo. Comece pela página do Nano Banana 2 indicada acima.
2. Escreva o prompt. Nomeie o assunto, o cenário e a luz. Para briefings mais longos, rascunhe o texto com o Gemini 3.5 Flash para mais velocidade, ou o Gemini 3.1 Pro quando o briefing for longo e detalhado.
3. Escolha uma proporção. Há 15 predefinições, incluindo 16:9, 9:16, 4:5 e 1:1. O padrão, match_input_image, segue sua foto de referência quando você envia uma.
4. Escolha a resolução. As opções são 1K (o padrão), 2K e 4K. Teste primeiro em 1K, já que resoluções maiores levam mais tempo para gerar.
5. Adicione imagens de referência. Envie até 14 para misturar estilos ou manter um personagem consistente.
6. Decida sobre o grounding. A opção Pesquisa Google vincula a imagem a informações atuais, e a opção Pesquisa de Imagens puxa imagens da web como contexto visual.
7. Defina o formato de saída. JPG é o padrão, PNG está disponível.
8. Gere e refine. Digite uma instrução de acompanhamento como "deixe o fundo mais escuro" em vez de reescrever o prompt inteiro.

💡 Truque de orçamento: defina composição, texto e proporção na PicassoIA e só então envie o prompt final para a API paga. O Nano Banana 2 Lite também está lá para rascunhos rápidos. Ele não tem configuração de resolução, o que deixa as passagens rápidas simples, e você pode navegar por super resolução e outras ferramentas na página de todos os modelos.

Teste você mesmo na Picasso IA

Os números são fáceis de ler e mais difíceis de assimilar na prática, então faça seu próprio teste. Pegue um prompt do seu projeto real, abra o Nano Banana 2 na Picasso IA e gere-o em 1K, 2K e 4K. Compare as três lado a lado e depois multiplique a diferença pelo número de imagens que você planeja fazer por mês. Esse único experimento mostra se 1K é suficiente, se o Lite cabe no seu volume e se o Pro vale o gasto extra. Experimente à vontade, refine o texto com o Gemini e reserve as chamadas de API pagas para a versão que você já aprovou.