Nota do autor: tutorial de migração para o Nano Banana 2.1, com ID do modelo, resoluções 1K/2K/4K, 14 imagens de referência, níveis de pensamento e critérios de cobrança, além de uma checklist completa para migrar do gemini-3.1-flash-image.
Vamos direto ao ponto: o Nano Banana 2.1 é uma versão atualizada do Nano Banana 2 (gemini-3.1-flash-image), que mantém a proposta de velocidade e custo da linha Flash. Na migração do modelo antigo, as principais mudanças são o ID do modelo e alguns parâmetros, como resolução, quantidade de imagens de referência e nível de pensamento. Não é preciso reestruturar todo o fluxo de geração de imagens.
Este artigo não pretende fazer propaganda do modelo nem tirar conclusões sobre “quanto a qualidade de imagem melhorou em relação à versão 2”, pois ainda não há dados confiáveis de testes comparativos. O conteúdo segue a ordem do que precisa mudar na migração: ID do modelo, resolução, imagens de referência, níveis de pensamento, cobrança e validação. Ao final, você terá uma checklist de migração para o Nano Banana 2.1 pronta para usar, voltada a desenvolvedores e equipes de design que trabalham com imagens para e-commerce, pôsteres, consistência de personagens e combinação de múltiplas imagens.
Principais pontos e ID do modelo Nano Banana 2.1
Para começar, a tabela reúne as informações do Nano Banana 2.1 mais relevantes para a migração. Tudo vem de descrições públicas no cartão oficial do modelo, na documentação da API e na documentação da APIYI, sem dados especulativos.
| Ponto | Nano Banana 2.1 | Impacto na migração |
|---|---|---|
| ID do modelo | gemini-nano-banana-2.1 |
Substitui o antigo gemini-3.1-flash-image |
| Data de lançamento | 6 de outubro de 2026 | É uma versão recente; consulte a documentação mais atual para os detalhes dos parâmetros |
| Resolução | 1K / 2K / 4K, com 1K como padrão | Se não for especificada, a saída será 1K; confira a configuração antiga |
| Imagens de referência | Até 14 imagens, com no máximo 4 personagens e 10 objetos | É preciso rever os limites de combinação de imagens e de séries de imagens |
| Níveis de raciocínio | minimal / medium (padrão) / high |
Afetam a latência e o custo; escolha conforme a tarefa |
| Contexto e saída | Contexto de 131.072, saída máxima de 32.768 | Mais espaço para comandos longos e cenários com várias imagens de referência |
ID do modelo Nano Banana 2.1 e substituição
O ID do modelo Nano Banana 2.1 é gemini-nano-banana-2.1. Segundo as fontes consultadas, ele é o substituto recomendado para gemini-3.1-flash-image, cuja versão prévia foi desativada em 25 de junho de 2026. Se o seu projeto ainda tem o ID antigo fixado no código, este é um bom momento para fazer a troca.
Vale notar que o padrão de nomenclatura mudou bastante: o antigo gemini-3.1-flash-image traz informações de versão e série, enquanto o novo ID usa diretamente a marca Nano Banana. Muitas equipes identificam modelos pelo prefixo do nome em centrais de configuração, variáveis de ambiente e regras de busca nos logs. Atualize esses pontos durante a migração, ou os painéis de monitoramento podem deixar de exibir dados.
Duas descrições da base do Nano Banana 2.1
Atualmente, existem duas descrições para o modelo subjacente ao Nano Banana 2.1. Ao preparar documentação técnica, vale registrar as duas:
- Cartão oficial do modelo: informa que ele é baseado no Gemini 3.6 Flash.
- Documentação da API: descreve o modelo como uma atualização do Nano Banana 2, mantendo velocidade e custo no nível Flash.
As duas descrições não são necessariamente contraditórias: uma trata do modelo-base, e a outra, da evolução da linha de produtos. Mesmo assim, na comunicação externa, é melhor não mencionar apenas uma delas. Em propostas para clientes ou avaliações internas, por exemplo, é mais seguro registrar: “O cartão do modelo informa que ele é baseado no Gemini 3.6 Flash; a documentação da API o descreve como uma atualização do Nano Banana 2”.
Além dos recursos de imagem, o Nano Banana 2.1 aprimorou a renderização de texto e a diagramação de infográficos e oferece grounding com Google Web/Image Search. Ele aceita texto, imagens, vídeos e PDF como entrada e gera imagens e texto como saída. Isso amplia suas possibilidades de uso em cartazes, imagens de produtos com texto e infográficos, entre outros cenários.
Como escolher a resolução do Nano Banana 2.1: 1K, 2K ou 4K
O Nano Banana 2.1 oferece três resoluções: 1K, 2K e 4K. A padrão é 1K. Entre as proporções disponíveis estão 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 e 21:9, cobrindo praticamente todos os usos comuns, como imagens principais para e-commerce, imagens verticais para redes sociais, banners e capas widescreen.
Esta versão também traz uma correção diretamente relacionada à migração: os artefatos de repetição em mosaico nas proporções alongadas e panorâmicas (1:4, 4:1, 1:8 e 8:1) foram corrigidos nas resoluções 2K e 4K. Se você evitava resoluções altas em imagens alongadas, banners ou panoramas por causa desses artefatos, vale reavaliar essas configurações após a migração.
| Resolução | Tokens de saída (aprox.) | Multiplicador em relação a 1K | Cenários indicados |
|---|---|---|---|
| 1K (padrão) | Cerca de 1.120 | 1 vez | Rascunhos, prévias em lote, imagens para redes sociais, testes A/B |
| 2K | Cerca de 1.680 | Cerca de 1,5 vez | Imagens de detalhes de produtos, cartazes comuns, imagens de destaque para landing pages |
| 4K | Cerca de 3.780 | Cerca de 3,4 vezes | Materiais impressos, anúncios de grande formato, imagens-mestras que precisam ser recortadas |
Recomendações para escolher a resolução no Nano Banana 2.1
Os tokens de saída da tabela são uma variável importante na cobrança oficial por token: quanto maior a resolução, mais tokens de saída cada imagem consome. Em 4K, o consumo é cerca de 3,4 vezes maior que em 1K. Por isso, quando a cobrança é por token, “usar 4K por padrão, só por garantia” aumenta bastante os custos.
Uma estratégia prática é dividir o trabalho em duas etapas: usar 1K para explorar ideias e selecionar imagens em lote, gerando e descartando opções rapidamente; depois de definir o caminho, usar 2K ou 4K para a versão final. Se a plataforma cobrar por imagem e o preço for o mesmo de 1K a 4K, essa lógica muda. A seção sobre cobrança mais adiante explica isso separadamente.
Na migração, confira também se o código antigo especifica a resolução. Se a invocação anterior dependia do valor padrão, mas sua aplicação precisa de imagens em 2K ou mais, será necessário informar a resolução explicitamente ao mudar para o Nano Banana 2.1. Caso contrário, a imagem será gerada em 1K, que é o padrão. Consulte a documentação da interface usada para saber os nomes exatos dos campos de resolução e proporção.
Imagens de referência no Nano Banana 2.1: como distribuir o limite de 14
O Nano Banana 2.1 aceita até 14 imagens de referência. Essa é a mudança que mais merece atenção para quem trabalha com fusão de imagens e séries visuais. Dentro desse limite, há mais duas restrições: até 4 personagens para consistência de personagens e até 10 objetos para consistência de objetos.
Esses números determinam como organizar as imagens de referência. Em uma série de ilustrações de marca com vários personagens, por exemplo, você pode fixar até 4 personagens e reservar as demais imagens para cenários, objetos de cena ou amostras de estilo. Já em uma série de imagens de produtos, o limite de 10 objetos é suficiente para cobrir uma linha de SKUs de porte médio.
Usos comuns das imagens de referência no Nano Banana 2.1
O material de referência apresenta quatro tipos principais de uso. Você pode se planejar assim:
- Definição de personagens: use imagens de referência de 1 a 4 personagens, em diferentes ângulos, para manter a aparência de cada um consistente entre as imagens.
- Série de produtos: use produtos da mesma linha como referência de objetos para gerar imagens principais, imagens em contexto e composições com estilo uniforme.
- Fusão de imagens: combine referências de cenário, elemento principal, material e iluminação em uma única imagem. É uma boa opção para pôsteres e imagens conceituais.
- Identidade visual de marca: use cores da marca, materiais com o logo e peças visuais existentes como referência para manter a consistência das peças produzidas em escala.
Na migração, vale adicionar uma validação da quantidade de imagens de referência na camada de invocação: se houver mais de 14, bloqueie o envio diretamente no cliente e avise o usuário, em vez de esperar um erro da API. Já os limites de personagens e objetos são semânticos e talvez não possam ser validados diretamente pela API. Por isso, é melhor informar aos designers na interface: “É possível fixar até 4 personagens e 10 objetos por vez”. Isso ajuda a evitar que o resultado confunda os personagens.
Quanto mais imagens de referência, maior costuma ser o processamento da entrada, o que pode aumentar a latência. Quando o tempo é importante, não é necessário usar as 14 imagens em toda solicitação: escolher algumas que representem melhor as características desejadas costuma ser mais eficiente.
Níveis de raciocínio do Nano Banana 2.1: como configurar minimal, medium e high
O Nano Banana 2.1 oferece três níveis de raciocínio: minimal, medium (padrão) e high. Quanto mais alto o nível, mais o modelo raciocina antes de gerar a imagem, o que geralmente significa mais tempo de espera e consumo de recursos.
A orientação das referências é clara: aumente o nível para composições complexas, diagramação de texto e fusão de várias imagens; reduza-o para edições simples, diminuindo a espera e o custo. A tabela abaixo aplica essa orientação a tarefas específicas.
| Nível de raciocínio | Tarefas recomendadas | Tendência de latência e custo | Sugestão para a migração |
|---|---|---|---|
minimal |
Troca de fundo, ajuste de cores, alterações locais, edições simples | Mais baixos | Ideal para processamento em lote com alta concorrência |
medium (padrão) |
Imagens comuns de produtos, imagens para redes sociais, cartazes com um único elemento principal | Médios | Na dúvida, use o padrão como referência inicial |
high |
Composições complexas, diagramação com muito texto, infográficos, fusão de várias imagens | Mais altos | Ative apenas para tarefas que realmente precisem dele |
Estratégia para distribuir os níveis de raciocínio do Nano Banana 2.1
Um erro comum é pensar: “se a exigência de qualidade é alta, use high em tudo”. Na prática, para edições simples, o ganho de um nível mais alto é limitado, mas o tempo de resposta aumenta de fato. Em interações nas quais o usuário aguarda em tempo real, esse custo fica evidente.
Uma alternativa mais equilibrada é definir o nível na aplicação conforme o tipo de tarefa. Por exemplo, encaminhe “cartazes com textos longos”, “fusão de 14 imagens de referência” e “infográficos” para high; use minimal para “troca de fundo em lote”; e mantenha o padrão medium para as demais tarefas. Assim, você preserva a qualidade das tarefas importantes e controla a latência geral.
Se o modelo antigo não tiver uma configuração correspondente de nível de raciocínio, o padrão após a migração será medium. No início, vale manter esse padrão e coletar dados de referência. Depois, reduza ou aumente o nível gradualmente conforme o tipo de tarefa, evitando mudar muitas variáveis de uma vez e dificultar a identificação da causa dos resultados.
Preços do Nano Banana 2.1: por imagem ou por token
O custo do Nano Banana 2.1 é um dos pontos mais fáceis de calcular errado ao avaliar uma migração, porque existem dois modelos de cobrança. A cobrança oficial é por token de saída: como a quantidade de tokens varia entre 1K, 2K e 4K, o custo também muda. Já a documentação da APIYI informa uma cobrança por imagem de $0.045, com o mesmo preço de 1K a 4K.
| Modelo de cobrança | Unidade de cobrança | Impacto da resolução no custo | Como estimar o custo | Fonte |
|---|---|---|---|---|
| Oficial, por token | Token de saída | 4K usa cerca de 3,4 vezes mais tokens que 1K | Estimar o total de tokens conforme a distribuição de resoluções | Documentação oficial |
| Por imagem | Cada imagem | Mesmo preço de 1K a 4K | Estimar diretamente pelo número de imagens geradas | Documentação da APIYI apiyi.com, com preço de $0.045 por imagem |
Os dois modelos de cobrança do Nano Banana 2.1 não são diretamente comparáveis
Cobrar por imagem e cobrar por token são duas formas diferentes de cálculo. Não faz sentido comparar diretamente “quanto custa cada imagem” com “quanto custa cada milhão de tokens”. A comparação mais útil considera a distribuição do seu próprio uso: qual é a proporção de imagens em 1K, 2K e 4K, quantos tokens cada imagem consome em média e qual seria o custo em cada modelo.
Quando a cobrança é por imagem e o preço é o mesmo de 1K a 4K, o custo marginal das resoluções mais altas deixa de crescer com o número de tokens. Para aplicações de e-commerce e impressão que precisam de muitas imagens finais em 2K ou 4K, isso muda a decisão anterior de “explorar em 1K e aumentar a resolução só na versão final”. Ainda assim, a geração em 1K costuma ser mais rápida, então continua fazendo sentido usá-la na fase de exploração para ganhar velocidade.
💰 Dica sobre preços: a documentação da APIYI apiyi.com informa que o Nano Banana 2.1 custa $0.045 por imagem, com o mesmo preço de 1K a 4K. Os valores podem mudar, então confira o preço vigente no console e na documentação. Verifique também no console se a plataforma oferece suporte a todos os parâmetros, como cada proporção de imagem e nível de raciocínio.
6 passos para migrar do gemini-3.1-flash-image para o Nano Banana 2.1
Depois de analisar cada parâmetro, vamos reuni-los em um fluxo de migração que você pode colocar em prática. Segundo o material de referência, a migração envolve seis passos principais:
- Substitua o ID do modelo: troque
gemini-3.1-flash-imageporgemini-nano-banana-2.1e atualize também a central de configurações, as variáveis de ambiente, as buscas em logs e as regras de monitoramento. - Confira as dimensões e a proporção: verifique se as chamadas antigas dependem da resolução padrão. Especifique 2K/4K quando necessário e reavalie o uso de alta resolução em formatos largos e panorâmicos.
- Confira o limite de imagens de referência: valide no cliente o máximo de 14 imagens e informe no produto que o limite é de 4 personagens e 10 objetos.
- Avalie os níveis de raciocínio: comece com o padrão
mediumpara estabelecer uma referência. Depois, direcione as tarefas paraminimalouhighconforme o tipo e observe as mudanças na latência e nos custos. - Compare a qualidade dos resultados e os custos: execute o modelo antigo e o novo com o mesmo conjunto de comandos e imagens de referência. Compare a qualidade visual, a renderização de texto e o custo por imagem.
- Mantenha uma opção de reversão: preserve uma opção na configuração para voltar ao modelo antigo rapidamente em caso de queda de qualidade ou custos inesperados.
Como acessar o Nano Banana 2.1 pela APIYI
Se você usa uma interface compatível com a OpenAI, basta definir o base_url do cliente como https://api.apiyi.com/v1, inserir sua chave API da APIYI e alterar o parâmetro model para gemini-nano-banana-2.1. Uma única chave API permite invocar modelos como Gemini, OpenAI e Claude. Assim, durante a migração, você pode comparar os modelos antigo e novo usando a mesma integração.
Antes de migrar, confirme na lista de modelos do console da APIYI se o gemini-nano-banana-2.1 está disponível e como é feita a cobrança. Confira também no console e na documentação quais parâmetros são compatíveis, como determinadas proporções ou o nível de raciocínio high. Não presuma que todos os parâmetros oficiais já estejam disponíveis.
🚀 Dica de migração: depois de confirmar a cobrança do Nano Banana 2.1 na lista de modelos da APIYI, em apiyi.com, use o crédito gratuito de teste para novos usuários em uma pequena amostra. Compare os resultados dos dois modelos antes de decidir se fará a troca completa.
Use os logs de uso para validar a migração para o Nano Banana 2.1
Validar a migração não é só olhar para as imagens: também é preciso conferir a conta. A APIYI oferece logs de uso que permitem consultar o modelo, o número de chamadas e os custos por solicitação. Na primeira semana após a migração, compare diariamente o volume de chamadas e os custos dos modelos antigo e novo. Confirme se a cobrança está de acordo com o esperado e verifique se ainda há solicitações usando o ID do modelo antigo.
Para avaliar a qualidade, prepare um conjunto fixo de testes que cubra os principais usos do seu negócio: imagens principais de produtos para e-commerce, cartazes com texto, séries com consistência de personagens e combinação de várias imagens. Selecione alguns conjuntos de comandos e imagens de referência para cada categoria, execute-os antes e depois da migração e peça a designers que avaliem os resultados às cegas. Antes de ter seus próprios dados de avaliação, não aceite sem questionar conclusões sobre uma “melhoria em todos os aspectos”.
Perguntas frequentes sobre o Nano Banana 2.1
Q1: Qual é a relação entre Nano Banana 2.1 e gemini-3.1-flash-image?
O Nano Banana 2.1 (`gemini-nano-banana-2.1`) é uma versão aprimorada do Nano Banana 2 (`gemini-3.1-flash-image`) e também o modelo recomendado para substituí-lo, mantendo a velocidade e o custo da linha Flash. Sobre a versão subjacente, o cartão oficial do modelo diz que ele é baseado no Gemini 3.6 Flash, enquanto a documentação da API o descreve como uma atualização do Nano Banana 2. Vale mencionar as duas descrições.
Q2: É necessário mudar a lógica do código para migrar para o Nano Banana 2.1?
Na maioria dos casos, não é preciso refatorar a lógica. As principais mudanças são no ID do modelo e nos parâmetros de resolução, quantidade de imagens de referência e nível de raciocínio. Se a invocação anterior usava a resolução padrão, mas a aplicação precisa de 2K/4K, é necessário especificá-la explicitamente. Ao usar a interface compatível com OpenAI da APIYI apiyi.com, basta alterar o parâmetro `model` para trocar de modelo.
Q3: Se 1K a 4K têm o mesmo preço, usar 4K é sempre mais vantajoso?
Quando a cobrança é por geração e o preço de 1K a 4K é igual, usar 4K não aumenta o custo por imagem, mas a geração e a transferência podem demorar mais, e o armazenamento também custa mais. Para exploração e seleção em lote, ainda vale usar 1K e deixar 2K/4K para a versão final. Consulte o preço por geração no console da APIYI apiyi.com.
Q4: Quais são as limitações conhecidas do Nano Banana 2.1?
É possível usar até 14 imagens de referência, com consistência para no máximo 4 personagens e 10 objetos. Acima desses limites, é necessário dividir a tarefa. O nível de raciocínio `high` aumenta a latência e o custo. Até o momento, não há comparações públicas e confiáveis de qualidade de imagem em testes práticos; por isso, é importante validar os resultados da migração com seu próprio conjunto de avaliação.
Resumo e checklist de migração para o Nano Banana 2.1
Principais pontos sobre o Nano Banana 2.1
- Posicionamento da versão: atualização do Nano Banana 2 que substitui o
gemini-3.1-flash-image, mantendo velocidade e custo de nível Flash. - Base do modelo: o cartão do modelo afirma que ele é baseado no Gemini 3.6 Flash; a documentação da API o descreve como uma atualização do Nano Banana 2. Vale registrar as duas informações.
- Resolução: 1K, 2K e 4K, com 1K como padrão. Os artefatos de mosaico em proporções amplas e panorâmicas foram corrigidos em 2K e 4K.
- Imagens de referência: até 14 imagens, com no máximo 4 personagens e 10 objetos. É adequado para séries de imagens e combinação de várias imagens.
- Nível de raciocínio:
mediumpor padrão; usehighpara composições complexas e diagramação de texto, eminimalpara edições simples. - Cobrança: a cobrança oficial é por token, enquanto a documentação da APIYI indica o mesmo preço por imagem. Os dois critérios não podem ser comparados diretamente; consulte os preços no console.
Checklist de migração para o Nano Banana 2.1
| Item | Ação | Critério de conclusão |
|---|---|---|
| ID do modelo | Substituir todas as ocorrências de gemini-3.1-flash-image por gemini-nano-banana-2.1 |
Não há mais invocações com o ID antigo nos logs de uso |
| Resolução | Verificar se o padrão de 1K atende às necessidades do negócio e especificar 2K ou 4K quando necessário | As dimensões da imagem gerada atendem aos requisitos do negócio |
| Proporção | Reavaliar o uso de 2K e 4K em cenários amplos e panorâmicos | Imagens longas e banners não apresentam artefatos de mosaico |
| Imagens de referência | Validar no cliente o limite de 14 imagens e informar os limites de até 4 personagens e 10 objetos | Solicitações acima dos limites são bloqueadas no cliente |
| Nível de raciocínio | Usar medium como referência inicial e depois direcionar as tarefas conforme a necessidade |
Latência e custo ficam dentro de limites aceitáveis |
| Formato de saída | Confirmar a compatibilidade da lógica de interpretação das saídas de imagem e texto | Armazenamento e exibição nas etapas seguintes funcionam normalmente |
| Verificação de cobrança | Estimar os custos conforme a distribuição de resoluções utilizada e conferir os preços no console | O custo real corresponde à estimativa |
| Avaliação de qualidade | Usar um conjunto fixo de avaliação e comparar os modelos novo e antigo em testes cegos | Não há perda de qualidade nas operações essenciais |
| Opção de reversão | Manter na configuração a possibilidade de voltar ao modelo antigo | É possível retornar ao modelo anterior em poucos minutos |
Migrar para o Nano Banana 2.1 é, essencialmente, uma tarefa de engenharia: trocar o ID, ajustar os parâmetros e validar os resultados. Configure a resolução, as imagens de referência e o nível de raciocínio de acordo com cada necessidade do negócio. Depois, valide a mudança usando tanto o conjunto de avaliação quanto os logs de uso para fazer a transição com mais tranquilidade.
Recomendamos usar a APIYI apiyi.com para invocar os modelos novo e antigo em paralelo com a mesma chave API e compará-los. Confira também a cobrança por chamada nos logs de uso e, depois de confirmar que está tudo certo, faça a migração completa.
Autor: Equipe técnica da APIYI
Contato técnico: Entre em contato pela página inicial do site da APIYI. Para mais informações sobre integração, acesse a central de documentação em docs.apiyi.com
