Criar um token de API do Nano Banana não custa nada, mas o Google não oferece plano gratuito para nenhum de seus modelos de imagem. Este artigo mostra o preço real por imagem, o que acontece quando o faturamento está desativado e as formas gratuitas de testar o Nano Banana sem pagar pelas chamadas de API.
Você pode criar um token de API do Nano Banana de graça em cerca de um minuto. Não dá para usá-lo para gerar imagens de graça. Em outubro de 2026, a página de preços do Google não lista plano gratuito para nenhum modelo Nano Banana, então cada imagem solicitada pela API do Gemini é cobrada desde a primeira chamada. Esse fato explica por que tantos desenvolvedores veem um erro 429 em um token recém-criado que parece perfeitamente válido.
Este artigo separa o que é gratuito do que não é. Você vai encontrar os passos exatos para criar o token, o ID e o preço de cada versão do Nano Banana, três exemplos de orçamento, as regras de cota por trás dos erros e as formas legítimas de testar o modelo sem pagar pelas chamadas de API. Todos os valores foram conferidos com a documentação do Google em outubro de 2026. Os preços mudam, então confirme-os na página oficial de preços antes de definir um orçamento.
💡 Resposta rápida: Criar um token é grátis. Chamar o Nano Banana pela API exige uma conta de faturamento. Testar o Nano Banana sem faturamento significa usar um aplicativo ou uma ferramenta no navegador, não a API.
Nada. A documentação do Google diz que novos usuários recebem automaticamente um projeto padrão do Google Cloud e um token depois de aceitar os Termos de Serviço no Google AI Studio. Não é preciso método de pagamento para obter o próprio token. O token apenas identifica seu projeto e não tem cota de imagens própria, que é a parte que a maioria das pessoas deixa passar.
Pense nele como um cartão de biblioteca sem livros. O cartão é grátis, e a estante por trás dele, com os modelos de imagem, é paga.
Todo modelo Nano Banana é pago. O preço vai de US$ 0,0336 por uma imagem de 1K no modelo mais leve até US$ 0,24 por uma imagem de 4K no modelo Pro. Os modelos de texto do Google até têm cotas gratuitas e limites diários de requisições, e essa reputação é a razão pela qual tantos tutoriais prometem uma API de imagens gratuita. A promessa não se sustenta para os modelos de imagem.
O resultado prático é simples:
As seções abaixo mostram cada caminho, em ordem.
O Google pode mudar isso a qualquer momento, e os planos gratuitos de outras famílias de modelos já mudaram antes. Não confie na data de um tutorial. Abra a página de preços, encontre a linha do ID do modelo que você pretende chamar e leia você mesmo a célula de plano gratuito. Se essa célula algum dia mostrar uma cota em vez de "Não disponível", as recomendações deste artigo mudam junto.
Nano Banana é o apelido dos modelos de imagem Gemini do Google. O apelido agora abrange várias gerações, e cada uma tem seu próprio ID de modelo, limite de resolução e preço. Chamar o ID errado é a forma mais rápida de gastar demais, então a tabela os apresenta lado a lado.
| Apelido | ID do modelo | Plano gratuito | Preço por imagem |
|---|---|---|---|
| Nano Banana | gemini-2.5-flash-image | Nenhum | US$ 0,039 |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | Nenhum | US$ 0,0336 em 1K |
| Nano Banana 2 | gemini-3.1-flash-image | Nenhum | US$ 0,045 em 0,5K, US$ 0,067 em 1K |
| Nano Banana Pro | gemini-3-pro-image | Nenhum | US$ 0,134 em 1K ou 2K, US$ 0,24 em 4K |
Os limites de resolução variam de modelo para modelo. O Nano Banana 2 Lite renderiza apenas 1K. O Nano Banana 2 oferece 512px (0,5K), 1K, 2K e 4K. O Nano Banana Pro oferece 1K, 2K e 4K. Os três modelos mais novos aceitam até 14 imagens de referência, e toda imagem gerada leva uma marca d’água SynthID.
Um padrão viável usa duas etapas. Faça o rascunho da composição no Nano Banana 2 Lite ou em 0,5K até que o enquadramento, a pose e a iluminação fiquem certos. Depois, envie o único prompt vencedor, com suas imagens de referência, para o Nano Banana Pro para a renderização final. Você paga o preço premium uma vez por entrega, em vez de uma vez por experimento.
GEMINI_API_KEY ou GOOGLE_API_KEY, e, se os dois existirem, GOOGLE_API_KEY tem prioridade.export GEMINI_API_KEY="paste-your-token-here"
A maioria das pessoas pode continuar no projeto padrão. Um segundo projeto só é útil quando você quer faturamento e limites separados, por exemplo, um para o site de um cliente e outro para experimentos pessoais. Lembre-se de que as cotas pertencem ao projeto, então dividir o trabalho entre projetos também divide a conta.
A documentação do Google mostra esta chamada mínima em Python. O cliente lê a variável de ambiente por conta própria, então nenhuma string aparece no código.
from google import genai
import base64
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.1-flash-image",
input="A ripe banana on a wooden desk, morning window light",
)
with open("banana.png", "wb") as f:
f.write(base64.b64decode(interaction.output_image.data))
Em um projeto sem faturamento, esta é exatamente a chamada que falha. Em um projeto com faturamento, ela grava banana.png e cobra cerca de 6,7 centavos.
O Google recomenda que os desenvolvedores tratem o token como uma senha. Se ele vazar, outras pessoas podem consumir sua cota e gerar cobranças no seu projeto.
Um token sem faturamento por trás pode autenticar, mas não pode pagar por uma imagem. Desenvolvedores nos próprios fóruns do Google relatam respostas 429 ao chamar um modelo Nano Banana a partir de um projeto gratuito, e a mensagem parece um problema de limite de taxa, embora a causa real seja a falta de faturamento.
Verifique estes pontos em ordem:
Três hábitos desperdiçam um dia inteiro de depuração:
Corrija o faturamento primeiro. Depois, se as respostas 429 continuarem, trate-as como um problema de limite de taxa e desacelere o laço de requisições.
O Google mede o uso em requisições por minuto, tokens por minuto e requisições por dia. Os modelos que geram imagens também contam imagens por minuto (IPM), uma unidade que funciona como tokens por minuto. Os limites se aplicam ao projeto, não ao token, então um segundo token dentro do mesmo projeto não acrescenta capacidade.
A página de limites de taxa do Google não traz números fixos para os modelos de imagem. Ela direciona você ao AI Studio, onde os seus limites ativos são listados para cada projeto. Consulte-os ali em vez de confiar numa tabela de blog, inclusive esta.
💡 Dica: As novas tentativas são cobradas como qualquer outra chamada. Adicione backoff exponencial ao seu código para que uma rajada de respostas 429 não se transforme em uma rajada de cobranças.
| Modelo e tamanho | Por imagem | 100 imagens | 1.000 imagens |
|---|---|---|---|
| Nano Banana 2 Lite, 1K | US$ 0,0336 | US$ 3,36 | US$ 33,60 |
| Nano Banana | US$ 0,039 | US$ 3,90 | US$ 39,00 |
| Nano Banana 2, 0,5K | US$ 0,045 | US$ 4,50 | US$ 45,00 |
| Nano Banana 2, 1K | US$ 0,067 | US$ 6,70 | US$ 67,00 |
| Nano Banana Pro, 1K ou 2K | US$ 0,134 | US$ 13,40 | US$ 134,00 |
| Nano Banana Pro, 4K | US$ 0,24 | US$ 24,00 | US$ 240,00 |
Os preços vêm da página de preços do Google em outubro de 2026.
O terceiro caso é onde as contas surpreendem as pessoas. Cada regeneração é uma imagem cobrada, então um prompt vago custa mais do que um prompt cuidadoso. Faça o rascunho em 0,5K ou no modelo Lite e renderize o vencedor uma vez no Pro.
💡 Dica: Crie um alerta de orçamento no Google Cloud Billing antes da sua primeira chamada paga. Leva dois minutos e avisa antes que um laço descontrolado cause prejuízo.
O aplicativo Gemini do Google inclui a geração de imagens do Nano Banana entre seus recursos, em diferentes planos de assinatura. A página de suporte do Google não publica um número diário fixo para contas gratuitas, então o limite que você vê dentro do aplicativo é o que vale, e ele pode mudar sem aviso. O aplicativo é apenas manual. Não tem API, então não pode alimentar um script ou um pipeline de conteúdo.
O Picasso IA roda vários modelos de imagem do Google no navegador, sem token e sem conta na Cloud. A página do Nano Banana 2 informa que as gerações não têm limites de créditos nem cotas de uso. A mesma família inclui o Nano Banana 2 Lite, o Nano Banana Pro e o Gemini 2.5 Flash Image.
Se você quiser ajuda para escrever os prompts antes, modelos de conversa como o Gemini 3.5 Flash os criam e refinam no mesmo lugar.
Um teste justo de qualquer caminho usa três prompts. Primeiro, peça uma cena com uma palavra curta de texto, para ver como o modelo trata as letras. Segundo, envie uma única foto de referência e peça a mesma pessoa em um novo lugar, para verificar a consistência. Terceiro, edite o seu próprio resultado com uma frase simples, como "mova a luminária para a prateleira da esquerda". Um modelo que passa nos três está pronto para projetos reais.
| Caminho | Precisa de token | Precisa de faturamento do Google | Funciona em scripts |
|---|---|---|---|
| API do Gemini | Sim | Sim | Sim |
| Aplicativo Gemini | Não | Não | Não |
| Picasso IA no navegador | Não | Não | Não |
O caminho pelo navegador precisa de alguns cliques e nenhuma configuração. Estes passos usam o esquema publicado na página do modelo.
match_input_image, e as predefinições vão de 1:1 e 16:9 até 21:9, 9:16 e formatos altos como 1:4.| Configuração | Opções | Dica |
|---|---|---|
image_input | Até 14 imagens | Reutilize uma referência para manter um personagem consistente entre cenas |
resolution | 1K, 2K, 4K | Faça o rascunho em 1K, finalize em 4K |
output_format | jpg, png | Escolha png para gráficos com bordas definidas |
google_search | Ligado ou desligado | Ligue quando a imagem depender de acontecimentos atuais |
image_search | Ligado ou desligado | Adiciona imagens da web como contexto visual |
O Nano Banana Pro usa um formulário parecido, com resolução padrão de 2K e uma configuração de filtro de segurança que vai de restrito a permissivo. Escolha-o quando o trabalho for uma entrega final.
💡 Dica: Gere três variações em 1K antes de gastar tempo com uma renderização em 4K. A maioria dos prompts ruins aparece na primeira miniatura.
Agora você conhece o panorama real: o token é grátis, as chamadas de API não são, e o caminho pelo navegador evita os dois problemas. Se o seu objetivo é ver o que o Nano Banana consegue fazer, você não precisa de uma conta de faturamento para começar. Abra o Picasso IA, escolha o Nano Banana 2 ou o Nano Banana Pro e escreva o primeiro prompt que vier à cabeça.
Experimente uma foto de produto, um retrato com fotos de referência ou uma cena baseada nas notícias de hoje. Depois, compare os resultados entre modelos na lista completa de modelos. Teste as configurações da tabela acima, guarde os prompts de que gostar e monte uma pequena biblioteca do que funciona. Quando estiver pronto para automatizar, você já saberá qual modelo e resolução merecem o seu orçamento de API. Antes disso, volte à tabela de preços deste artigo e faça as contas com o volume que você espera. Uma estimativa mensal aproximada leva um minuto e evita uma surpresa desagradável na primeira fatura.
Escolha seu idioma
