Nano Banana 2.1: acesso à API, preços e migração

O Nano Banana 2.1 merece ser o primeiro candidato para um novo fluxo de imagens de uso geral com Gemini. O Google o apresenta como sucessor do Nano Banana 2, com melhor tipografia, consistência entre edições e correções em panoramas. O custo de saída de imagem também caiu. Aplicações existentes precisam comparar antes de migrar: a entrada ficou mais cara, o Thinking padrão mudou e 0.5K não está documentado para o 2.1.

O Google lançou gemini-nano-banana-2.1 em 6 de outubro de 2026. No mesmo dia, marcou gemini-3.1-flash-image como obsoleto, sem anunciar uma data de desligamento. Isso justifica planejar a migração, mas não significa que o endpoint anterior já parou de funcionar.

Se você quer um único gateway para começar hoje, a OmniaKey já permite criar e usar tarefas de imagem do Nano Banana 2.1 e do Nano Banana 2. gemini-nano-banana-2.1 está listado a $0.0168 por chamada, e gemini-3.1-flash-image (Nano Banana 2) continua disponível a $0.068 por chamada.

Para escolher entre os modelos atuais, veja o comparativo entre Nano Banana 2.1 e Pro, com custos por resolução e critérios de aprovação.

Onde o 2.1 se encaixa

O 2.1 tem ID próprio; não é um parâmetro de qualidade nem um alias automaticamente aceito por gateways. A ficha lista texto, imagem, vídeo e PDF como entradas, mas imagem e texto como saídas. Usar vídeo como referência não significa gerar vídeo.

O Google documenta 1K, 2K e 4K, com 1K como padrão. O guia reserva 512px/0.5K ao Nano Banana 2. Verifique esse ajuste ao migrar. Uma imagem panorâmica 4K não equivale a um quadrado de 4096×4096.

Mudanças que fazem diferença

Correção específica para panoramas

O Google afirma ter corrigido artefatos de repetição nas proporções 1:4, 4:1, 1:8 e 8:1, em 2K e 4K. Isso importa para banners, fundos panorâmicos e anúncios verticais: uma emenda ou textura repetida pode inviabilizar a entrega.

Inspecione toda a imagem no tamanho final, procurando prédios duplicados, horizontes quebrados e mudanças bruscas de luz. A correção é motivo para testar novamente, não uma garantia de ausência de defeitos.

Tipografia e infográficos

A página anuncia melhor renderização de texto e precisão de layout. Na prática, títulos, preços e rótulos precisam sair exatamente como pedidos e sobreviver às revisões. Um único número ou acento errado pode reprovar uma peça bonita.

Teste os idiomas em que você publica. A melhora não demonstra a mesma precisão em chinês, japonês, árabe e alfabetos latinos. Confira o texto caractere por caractere e valide os dados de gráficos separadamente.

Consistência em várias edições

O Google destaca a manutenção de personagens entre turnos. São documentadas até 14 imagens de referência, semelhança de até 4 personagens e fidelidade de até 10 objetos. Esses limites são diferentes; não prometem preservar perfeitamente 14 pessoas.

Altere a cor do produto, depois o fundo e por último o título. Compare logotipo, rosto, embalagem e ângulo de câmera a cada etapa. Aceitar referências não comprova, por si só, que o resultado preserva os detalhes.

Thinking agora usa medium por padrão

O 2.1 aceita minimal, medium e high, com medium como padrão. O Nano Banana 2 aceita minimal e high, com minimal por padrão. Se o aplicativo omitia esse parâmetro, trocar o ID muda também o comportamento padrão.

A promessa de velocidade de nível Flash não é uma medição do tempo total. Compare com Thinking explícito e depois teste os padrões de cada modelo separadamente. Registre espera e saída de raciocínio faturada.

Preços da API: imagem mais barata, entrada mais cara

Estes são os preços da API Standard direta do Google, verificados em 7 de outubro de 2026, em USD por milhão de tokens. Não são preços da OmniaKey.

O token de imagem caiu pela metade, mas nem toda imagem custa metade do preço. A alocação documentada de 4K subiu de 2.520 para 3.780 tokens. Calculando com essas quantidades, em vez dos preços arredondados da página:

Os valores incluem somente a saída de imagem. Entrada, texto/Thinking, buscas aplicáveis e gerações adicionais faturadas aumentam a conta. O Google arredonda o 4K do 2.1 para $0.113; a tabela usa 3.780 × $30 / 1.000.000 = $0.1134. Mantivemos o ponto decimal nos valores em USD.

O modo separado Batch cobra $0.75 por entrada, $3.75 por texto/Thinking e $15 por imagem, por milhão de tokens. Só a imagem custa $0.0168 em 1K, $0.0252 em 2K e $0.0567 em 4K. Muitas chamadas comuns não ativam automaticamente o preço Batch. Não há uma faixa gratuita da API na tabela publicada.

O grounding com busca tem 5.000 pesquisas gratuitas mensais compartilhadas entre Gemini 3.x, depois $14 por 1.000. Uma chamada ao modelo pode executar várias consultas faturáveis. Portanto, gerar uma imagem com busca não é necessariamente uma operação de preço fixo.

O 2.1 é mais barato que o Lite?

A saída de imagem 1K custa $0.0336 nos dois em Standard. O Lite continua mais barato em entrada e texto/Thinking: $0.25 e $1.50 por milhão, contra $1.50 e $7.50 no 2.1. Mesmo preço de imagem não significa a mesma conta total. O Lite segue relevante para tarefas simples em 1K.

Divida o gasto total faturado pelas imagens finais aprovadas. Uma saída barata que exige três revisões pode sair mais cara que um resultado aprovado na primeira tentativa.

Quando vale atualizar

• Aplicações novas: comece pelo 2.1, recomendado pelo Google enquanto o anterior está obsoleto.
• Banners, pôsteres e revisões de produto: priorize a comparação porque as melhorias miram esses problemas.
• Fluxos estáveis em 0.5K: confirme tamanhos e custo total antes de reutilizar parâmetros antigos.
• Grande volume de 1K simples: inclua Lite e avalie entrada e latência.
• Layouts de marca exigentes: compare com Pro usando o mesmo briefing. Esta análise não traz testes equivalentes que provem superioridade universal do 2.1.

A comparação entre Lite e Nano Banana 2 explica a escolha anterior. Os exemplos da análise de Nano Banana 2 e Pro são dessas versões, não testes do 2.1.

Uma avaliação útil antes da migração

Fixe prompts, referências, proporção e resolução. Execute cada cenário pelo menos três vezes, guarde os descartes e registre Thinking. Este é um plano sugerido, não um conjunto de medições já realizadas.

Registre entregas aprovadas, gasto, tempo até o arquivo ficar utilizável e correção manual. Separe 1K de 4K e Thinking equivalente das configurações padrão. Assim fica claro se o ganho exige mais raciocínio ou espera.

Testar a API do Google com parâmetros explícitos

O exemplo segue a documentação atual da Interactions API. Ele exige uma chave Google Gemini em GEMINI_API_KEY e o pacote google-genai atualizado. O prompt em inglês permanece fixo para reproduzir a comparação. Conferimos o código na documentação, mas não executamos geração paga.

python -m pip install -U google-genai

import base64
import os
from pathlib import Path
from google import genai

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
result = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input=(
        'Create a studio poster of a blue ceramic mug. '
        'Use exactly the headline "MORNING LIGHT" and the price "$24". '
        'Keep all text clearly readable. No other text.'
    ),
    generation_config={"thinking_level": "medium"},
    response_format={
        "type": "image",
        "mime_type": "image/png",
        "aspect_ratio": "4:1",
        "image_size": "2K",
    },
)

output = result.output_image
if output is None or not output.data:
    raise RuntimeError("No image returned; inspect the response before retrying.")
Path("nano-banana-2-1.png").write_bytes(base64.b64decode(output.data))

Para continuar editando, o guia usa previous_interaction_id=result.id. Preserve o estado correto da conversa e contabilize toda a sequência.

Rota atual da OmniaKey: o Nano Banana 2.1 está listado como gemini-nano-banana-2.1 a $0.0168 por chamada (página do modelo); o Nano Banana 2 continua disponível como gemini-3.1-flash-image a $0.068 por chamada (página do modelo).

Criar imagens Nano Banana na OmniaKey

Se você quer testar a família Nano Banana em um único gateway, a OmniaKey expõe as duas versões como rotas de imagem disponíveis. Crie uma tarefa com gemini-nano-banana-2.1, escolha generate ou edit e consulte o status até a URL assinada do asset ficar pronta. Esta rota está listada a $0.0168 por chamada; a rota anterior gemini-3.1-flash-image segue a $0.068 por chamada. Veja a página do Nano Banana 2.1 e a documentação da API de imagens para o contrato atual.

curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nano-banana-omnia-001" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "type": "image",
    "operation": "generate",
    "input": {"prompt": "A blue ceramic mug on a quiet studio table, no text"},
    "parameters": {"aspect_ratio": "16:9", "image_size": "2K"}
  }'

Uma solicitação aceita retorna 202 Accepted e um ID de tarefa. Consulte GET /v1/media/tasks/{id} até terminar e depois baixe assets[].url. Para editar, envie uma imagem Base64 inline em input.image e reutilize a mesma chave de idempotência apenas ao repetir o corpo idêntico. Esse contrato do gateway é diferente do exemplo da Interactions API do Google abaixo.

Perguntas frequentes

Posso criar imagens Nano Banana na OmniaKey?

Sim. Use POST /v1/media/tasks com gemini-nano-banana-2.1 para gerar ou editar com o Nano Banana 2.1, consulte a tarefa e baixe o asset assinado. Esta rota está listada a $0.0168 por chamada; a rota anterior gemini-3.1-flash-image continua disponível a $0.068 por chamada.

É o mesmo modelo que Gemini 3.1 Flash Image?

É o sucessor, com ID diferente: gemini-nano-banana-2.1. O antigo usa gemini-3.1-flash-image. Não presuma alias nem migração automática.

Aceita 4K e várias referências?

Sim. O Google documenta 1K, 2K, 4K e até 14 referências, com orientações de fidelidade para 4 personagens e 10 objetos. Valide sua tarefa específica.

Custa metade?

A saída de imagem cai 50% em 1K e 2K, e 25% em 4K. Entrada e texto/Thinking ficam mais caros, então a chamada completa não custa necessariamente metade.

É preciso migrar imediatamente?

O modelo anterior foi marcado como obsoleto em 6 de outubro de 2026, sem data de desligamento. Planeje e valide tamanhos, Thinking, qualidade e cobrança antes de mudar a produção.

Fontes

• Notas de versão da Gemini API
• Ficha do Nano Banana 2.1
• Guia de geração e edição de imagens
• Preços da Google Gemini API