Nota do autor: O Gemini 3.1 Flash Image e o Gemini 3 Pro Image tornaram-se GA (Disponibilidade Geral) em 28 de maio. Este artigo analisa a linha do tempo da remoção do sufixo -preview, as 5 principais mudanças entre o Nano Banana Pro e o 2, e os pontos essenciais de integração via APIYI.

No dia 28 de maio, o Google DeepMind promoveu os dois modelos de geração de imagens, gemini-3.1-flash-image-preview e gemini-3-pro-image-preview, para a versão oficial (GA), correspondendo ao Nano Banana 2 e ao Nano Banana Pro, respectivamente. Isso significa que os desenvolvedores não precisam mais usar IDs temporários com o sufixo -preview em ambientes de produção; agora, podem chamar a versão estável diretamente. No mesmo dia, o gemini-3.1-flash-image também recebeu uma nova capacidade: conversão de vídeo para imagem (video-to-image).
Para os usuários da APIYI, a mudança mais direta é: a interface que antes era chamada via gemini-3.1-flash-image-preview foi atualizada de forma transparente para gemini-3.1-flash-image. Não é necessário reescrever o código do cliente, basta alterar o nome do modelo para herdar todas as novas capacidades. No dia do lançamento do GA, a APIYI já havia concluído a sincronização, permitindo que os desenvolvedores façam chamadas diretamente via protocolo compatível com OpenAI em apiyi.com.
Este artigo sistematiza três questões centrais: quando o sufixo -preview será removido, quais as mudanças no Nano Banana Pro e no Nano Banana 2 durante o processo de GA, e como realizar a migração rapidamente em ambientes de produção. Todas as informações provêm de anúncios oficiais do Google e dos cartões de modelo do DeepMind, evitando confusões de versão causadas por especulações.
Qual é a linha do tempo fundamental para a remoção do preview do Gemini 3.1 Flash Image?
Para entender o significado desta transição para GA, precisamos observar o ritmo de lançamento da série Nano Banana. Desde a primeira visualização até a versão estável, o processo levou cerca de 6 meses, seguindo o ritmo padrão do Google AI: "visualização → coleta de feedback → GA".
| Data | Evento | ID do Modelo | Status |
|---|---|---|---|
| 20 de novembro de 2025 | Primeira visualização do Nano Banana Pro | gemini-3-pro-image-preview |
Preview |
| 26 de fevereiro de 2026 | Primeira visualização do Nano Banana 2 | gemini-3.1-flash-image-preview |
Preview |
| 28 de maio de 2026 | Ambos os modelos tornam-se GA | gemini-3-pro-image / gemini-3.1-flash-image |
GA ✅ |
| 25 de junho de 2026 | Desativação oficial da versão preview | Modelos com sufixo *-preview |
Desativado |
A linha do tempo revela sinais importantes.
Primeiro, o Pro e o 2 foram "lançados juntos e graduados juntos". Embora o tempo de visualização entre eles tenha sido de 3 meses, o Google optou por torná-los GA no mesmo dia, confirmando a estratégia de "modelo duplo" para geração de imagens — um focado em qualidade máxima (Pro) e outro em eficiência máxima (Flash/2).
Segundo, a versão preview terá um período de carência de cerca de 4 semanas após o GA, sendo desativada oficialmente em 25 de junho. Isso dá aos desenvolvedores tempo suficiente para a migração, mas qualquer código em produção que ainda utilize o sufixo *-preview deve ser atualizado antes dessa data para evitar erros do tipo 404.
Terceiro, o GA não significa apenas "remover o preview". O gemini-3.1-flash-image ganhou, no dia do GA, a capacidade de video-to-image, permitindo gerar miniaturas, pôsteres e imagens estáticas de quadros-chave a partir de vídeos. Esta é uma funcionalidade que a versão preview nunca teve.
🎯 Sugestão de migração: Se você está usando
gemini-3.1-flash-image-previewougemini-3-pro-image-preview, recomendamos concluir a substituição do ID do modelo antes de 25 de junho. Ao utilizar a plataforma APIYI (apiyi.com), o suporte para ambos os IDs (antigo e novo) já está disponível, garantindo uma transição suave.
As 5 principais mudanças entre o Nano Banana Pro e o 2
A transição para a GA (Disponibilidade Geral) não é apenas uma mudança de nome. Da versão de prévia para a estável, ambos os modelos passaram por otimizações sistemáticas em capacidade, estabilidade e estratégia de preços. Abaixo, detalhamos as 5 principais mudanças.

Mudança 1: Padronização do ID do modelo, remoção do sufixo -preview
A mudança mais visível é a limpeza dos IDs dos modelos. Confira a comparação entre os IDs antigos e novos:
| Finalidade do modelo | ID da versão de prévia (descontinuado) | ID da versão GA oficial |
|---|---|---|
| Imagem de alta qualidade (Pro) | gemini-3-pro-image-preview |
gemini-3-pro-image |
| Imagem de alta eficiência (Flash/2) | gemini-3.1-flash-image-preview |
gemini-3.1-flash-image |
O significado prático de remover o sufixo -preview vai além da estética. Isso representa que o Google integrou esses dois modelos ao seu SLA oficial e sistema de gerenciamento de versões: a partir de agora, você conta com testes de regressão estáveis, janelas de alteração de capacidade previsíveis e um compromisso de disponibilidade de nível de produção.
Mudança 2: gemini-3.1-flash-image adiciona capacidade de vídeo para imagem
Esta é a atualização de capacidade mais "relevante" no dia da GA. A nova versão do gemini-3.1-flash-image suporta vídeo como entrada, gerando diretamente imagens estáticas representativas — os usos típicos incluem:
- Geração automática de miniaturas (thumbnails) para vídeos
- Extração de quadros-chave de vídeos longos para criação de pôsteres
- Captura de cenas representativas de transmissões ao vivo para capas de stream
- Geração de pôsteres promocionais combinando vídeo + comando
A versão de prévia suportava apenas entrada de texto e imagem, sem processar vídeos. Com essa lacuna preenchida na GA, o valor do gemini-3.1-flash-image em plataformas de vídeo, ferramentas de vídeos curtos e e-commerce aumentou significativamente.
Mudança 3: Janela de contexto expandida para 1M de tokens
O cartão do modelo DeepMind mostra que a janela de contexto de entrada do gemini-3.1-flash-image pode chegar a 1 milhão de tokens. Essa especificação é muito rara em modelos de geração de imagens, o que significa que:
- Uma única invocação pode receber uma grande quantidade de imagens de referência e materiais de marca
- Comandos longos e histórico de edições de múltiplas rodadas podem ser transmitidos integralmente
- Pode suportar combinações complexas de "referências multiorigem + comandos de estilo"
| Dimensão da especificação | gemini-3.1-flash-image (GA) |
|---|---|
| Janela de contexto de entrada | 1 milhão de tokens |
| Capacidade de saída de imagem | Até 4K tokens |
| Capacidade de saída de texto | Até 64K tokens |
| Modalidades de entrada | Texto, imagem, áudio, vídeo |
| Corte de conhecimento | Janeiro de 2025 |
Mudança 4: Suporte oficial para resolução 4K, com saídas em vários níveis a partir de 512px
A nova versão promete oficialmente suporte para vários níveis de resolução, de 512px a 4K. Os desenvolvedores podem escolher o nível adequado conforme o cenário para equilibrar custo e qualidade. Várias proporções de aspecto também foram confirmadas na GA, incluindo as comuns 1:1, 4:3, 3:4, 16:9, 9:16, entre outras.
Mudança 5: Consistência de múltiplos sujeitos elevada para 5 personagens e 14 objetos
Na fase de prévia, o Nano Banana 2 já havia feito avanços na consistência de múltiplos sujeitos. Na fase GA, a oficialização traz indicadores quantitativos claros: manutenção da consistência visual de até 5 personagens e 14 objetos em uma única imagem. Este é um "compromisso quantitativo" raro em modelos de geração de imagem públicos, sendo um benefício direto para cenários como ilustrações de histórias, imagens de composição de produtos e imagens principais de SKUs de e-commerce.
🎯 Seleção de capacidade: Se o seu negócio foca em cenas com múltiplos sujeitos e ilustrações de histórias, recomendamos avaliar o gemini-3.1-flash-image. Você pode testar rapidamente a estabilidade com diferentes números de sujeitos através da plataforma APIYI (apiyi.com), que já está totalmente sincronizada com a versão GA.
Por que o Gemini 3.1 Flash Image e o Gemini 3 Pro Image coexistem
Após o lançamento geral (GA), o Google não deixou que o Flash substituísse o Pro, nem que o Pro absorvesse o Flash. Em vez disso, definiu claramente ambos como uma estratégia de "trilha dupla". A filosofia de produto por trás disso é algo que todo desenvolvedor deve compreender.

Posicionamento de desempenho: Pro foca em qualidade, Flash foca em eficiência
O Pro é ideal para "momentos visuais críticos" — cartazes com texto visível, infográficos, materiais de marca e mockups de produtos com layout complexo. O Flash é ideal para "cenários de alta vazão" — imagens para plataformas de conteúdo (UGC), imagens principais de produtos em e-commerce, imagens para redes sociais e imagens intermediárias em fluxos de trabalho de agentes.
| Dimensão | gemini-3-pro-image | gemini-3.1-flash-image |
|---|---|---|
| Posicionamento principal | Alta qualidade, layout complexo | Alta eficiência, alta vazão |
| Renderização de texto | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| Gráficos complexos | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| Velocidade | Padrão | Mais rápido |
| Custo por imagem | Base | ~33% a 59% menor (2K/4K) |
| Consistência de múltiplos sujeitos | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ (5 personagens/14 objetos) |
| Entrada de vídeo | Suporte parcial | ✅ Suporte oficial |
| Cenários recomendados | Materiais de marca, infográficos | Invocação de modelo via API padrão |
Estrutura de custos: Flash é significativamente mais barato que o Pro
Dados de testes de terceiros mostram que, na resolução 2K, o custo por imagem do Pro é cerca de 33% maior que o do Flash, e essa diferença aumenta para cerca de 59% na resolução 4K. Para aplicações onde a imagem é o principal formato de produto, essa diferença impacta diretamente a fatura mensal.
Quando escolher o Pro e quando escolher o Flash? Lista de decisão
Você pode usar esta lista simplificada para a seleção:
- O comando contém texto visível → Priorize o Pro (renderização de texto mais estável)
- Precisa de cores de marca e layout precisos → Priorize o Pro
- Chamadas de API de alta concorrência → Priorize o Flash
- Geração em lote de imagens UGC → Priorize o Flash
- Cenários complexos com múltiplos sujeitos → Priorize o Flash (indicador de 5 personagens e 14 objetos)
- Miniaturas/capas de vídeo → Deve ser o Flash (o Pro não possui essa capacidade)
- Cenário incerto → Use o Flash por padrão; se a qualidade não for suficiente, suba para o Pro
🎯 Estratégia híbrida: Muitas aplicações de produção adotam um fluxo de duas etapas: "Flash para rascunhos, Pro para a versão final". Recomendamos usar a plataforma APIYI (apiyi.com) para invocar ambos os modelos; o protocolo compatível com OpenAI da plataforma permite alternar entre os modelos apenas alterando o campo
model.
Como chamar a versão GA do Gemini 3.1 Flash Image na APIYI
A APIYI disponibilizou a versão GA em 28 de maio. Os desenvolvedores podem realizar a invocação do modelo de duas formas: através do protocolo nativo do Gemini ou pelo protocolo compatível com OpenAI. Este último é mais adequado para projetos que estão migrando do ecossistema OpenAI.
Exemplo de invocação simples (protocolo compatível com OpenAI)
from openai import OpenAI
client = OpenAI(
api_key="Sua chave API da APIYI",
base_url="https://api.apiyi.com/v1"
)
response = client.chat.completions.create(
model="gemini-3.1-flash-image", # Versão oficial GA, sem o sufixo -preview
messages=[
{"role": "user", "content": "Gere uma imagem principal de um tênis esportivo estilo e-commerce, fundo branco, proporção 3:4"}
]
)
print(response.choices[0].message.content)
Alternando para a versão Pro
response = client.chat.completions.create(
model="gemini-3-pro-image", # Mude para a versão Pro de alta qualidade
messages=[
{"role": "user", "content": "Gere um pôster visual principal para um lançamento de produto, contendo o nome da marca ACME e a data 10.06.2026"}
]
)
Basta alterar o campo model; o restante do código de invocação permanece exatamente o mesmo.
Exemplo de entrada de vídeo (capacidade exclusiva do Flash)
# Utilizando a capacidade de vídeo para imagem do gemini-3.1-flash-image
response = client.chat.completions.create(
model="gemini-3.1-flash-image",
messages=[
{"role": "user", "content": [
{"type": "text", "text": "Gere uma imagem de capa atraente a partir deste vídeo"},
{"type": "video_url", "video_url": {"url": "https://example.com/video.mp4"}}
]}
]
)
Todo o processo de migração geralmente requer apenas a substituição do campo model. O código original do SDK da OpenAI pode ser reutilizado diretamente, sem a necessidade de reescrever a lógica do cliente.
Quando os modelos antigos -preview serão descontinuados? Observações sobre a migração
Embora a versão GA já tenha sido lançada, as versões de visualização não foram encerradas no mesmo dia. De acordo com o anúncio oficial do Google, o gemini-3.1-flash-image-preview e o gemini-3-pro-image-preview serão oficialmente descontinuados em 25 de junho de 2026. Isso significa que os desenvolvedores ainda têm um período de carência de cerca de 4 semanas para concluir a migração, mas é fundamental não deixar para a última hora.
Cronograma de migração
| Período | Status | Ação recomendada |
|---|---|---|
| 28 de maio — 10 de junho | Versões coexistentes | Mudar ambiente de desenvolvimento para teste GA |
| 10 de junho — 20 de junho | Versões coexistentes | Migração gradual em ambiente de produção |
| 20 de junho — 24 de junho | Final do período de carência | Concluir todas as migrações, monitorar e comparar |
| 25 de junho em diante | Apenas GA disponível | Versão preview retorna 404, migração obrigatória |
Checklist de migração
Antes de concluir a transição, recomenda-se verificar os seguintes itens:
- Todos os campos com a string
gemini-3.1-flash-image-previewno código foram substituídos porgemini-3.1-flash-image - Todos os campos com a string
gemini-3-pro-image-previewno código foram substituídos porgemini-3-pro-image - Testes cobrindo tipos críticos de comando (incluindo texto, múltiplos objetos, saída 4K, etc.)
- Comparação das métricas de latência e qualidade entre a versão GA e a preview
- Validação do comportamento dos fluxos relacionados à entrada de vídeo no GA Flash
🎯 Dica para uma migração suave: Ao realizar a invocação na plataforma APIYI, tanto o ID antigo quanto o novo estarão disponíveis durante o período de carência, permitindo uma transição gradual no cliente. Recomendamos utilizar a plataforma APIYI (apiyi.com) para validar a versão GA com 10% do tráfego primeiro e, após confirmar a estabilidade, realizar a migração total para reduzir riscos em produção.
Análise de impacto do GA do Gemini 3.1 Flash Image
O impacto desta transição para GA (Disponibilidade Geral) no setor de geração de imagens é muito mais profundo do que uma simples atualização de modelo. Ela marca a conclusão da "matriz de modelo duplo" do Google, estabelecendo uma competição clara e diferenciada frente à série GPT Image da OpenAI, Midjourney e Stable Diffusion.
Para desenvolvedores: lógica de seleção mais clara
Durante a fase de preview, os desenvolvedores frequentemente ficavam confusos sobre "usar o Pro ou o 2". Após o GA, o posicionamento ficou claro: Flash como padrão, e Pro para cenários que envolvem texto ou branding. Essa "escolha dupla clara" reduz o custo de tentativa e erro.
Para produtos de aplicação: prontos para produção
Modelos em preview geralmente não são recomendados para produção (sem garantia de SLA, comportamento da API sujeito a mudanças). Com o GA, tanto o gemini-3.1-flash-image quanto o gemini-3-pro-image possuem SLA de nível de produção, permitindo que as aplicações os integrem com segurança em seus fluxos de trabalho principais.
Para o cenário competitivo: pressão de custos do Flash
A vantagem de custo do Nano Banana 2 nos níveis de 2K e 4K será transmitida para as aplicações de IA a jusante, forçando indiretamente outros fornecedores de API de imagem a ajustarem suas estratégias de preços. Espera-se que, no próximo trimestre, a curva de preços das principais APIs de imagem caia ainda mais.
FAQ: Perguntas frequentes sobre o GA do Gemini 3.1 Flash Image
Quando o sufixo -preview do gemini-3.1-flash-image foi removido?
Em 28 de maio de 2026. No mesmo dia, o gemini-3-pro-image-preview também foi alterado para gemini-3-pro-image. As versões de preview serão oficialmente descontinuadas em 25 de junho de 2026.
Nano Banana Pro e Nano Banana 2 são o mesmo modelo?
Não. O Nano Banana Pro corresponde ao gemini-3-pro-image, focado em alta qualidade e layout complexo; o Nano Banana 2 corresponde ao gemini-3.1-flash-image, focado em alta eficiência e throughput. Ambos existem em paralelo, atendendo a cenários diferentes.
A versão GA é exatamente igual à versão de preview?
Não exatamente. Além de remover o sufixo -preview, a versão GA adicionou a capacidade de vídeo para imagem (video-to-image) ao gemini-3.1-flash-image, além de melhorias na estabilidade geral e no SLA. Para especificações detalhadas, consulte a documentação da APIYI em help.apiyi.com.
Como invocar a versão GA na APIYI?
Basta alterar o campo model de gemini-3.1-flash-image-preview para gemini-3.1-flash-image; não é necessário ajustar outros parâmetros de invocação. Recomendamos realizar a invocação através da plataforma APIYI (apiyi.com), que já está totalmente sincronizada com a versão GA.
Devo escolher o Pro ou o Flash por padrão?
O Google e a maioria das avaliações sugerem usar o Flash (gemini-3.1-flash-image) como opção padrão, migrando para o Pro apenas quando o comando contiver texto visível, exigir layout preciso ou em cenários de saída crítica de marca. Isso garante a melhor relação custo-benefício na maioria dos casos.
Quais modalidades de entrada o gemini-3.1-flash-image suporta?
A versão GA suporta quatro modalidades de entrada: texto, imagem, áudio e vídeo, com uma janela de contexto de entrada de até 1 milhão de tokens. A entrada de vídeo é uma capacidade recém-adicionada na fase GA.
Se eu ainda estiver usando a versão de preview, serei afetado?
Não no curto prazo, mas após 25 de junho a versão de preview será desativada e as invocações falharão. Recomendamos concluir a migração antes de 20 de junho para garantir uma margem de segurança. Você pode monitorar as diferenças de comportamento entre as duas versões através da plataforma APIYI (apiyi.com).
O Flash 4K é muito mais caro que o 2K? Vale a pena subir para 4K?
A diferença entre os níveis de resolução não é exagerada, mas o custo por imagem em 4K é significativamente maior que em 2K. Se o seu cenário de negócio for focado em redes sociais ou imagens para web, o 2K geralmente é suficiente; apenas cenários como materiais impressos, displays de grande formato ou pôsteres profissionais exigem 4K.
Principais pontos do Gemini 3.1 Flash Image GA
- Data de GA confirmada: 28 de maio de 2026, com o gemini-3.1-flash-image e o gemini-3-pro-image saindo da fase de preview simultaneamente.
- Data de encerramento da versão preview: 25 de junho de 2026; a migração do ID do modelo deve ser concluída antes desta data.
- Nova entrada de vídeo no Flash: A versão GA do gemini-3.1-flash-image agora suporta a geração de vídeo para imagem (video-to-image).
- Janela de contexto de 1M de tokens: A janela de entrada do Flash chega a 1 milhão de tokens, permitindo combinações complexas de múltiplas imagens de referência.
- Critérios rígidos para múltiplos sujeitos: Mantém a consistência facial de até 5 personagens e 14 objetos em uma única imagem.
- Coexistência Pro/Flash: A matriz de modelo duplo está oficialmente estabelecida, facilitando a escolha de acordo com o cenário de uso.
- Sincronização no APIYI: A versão GA foi sincronizada em 28 de maio, com suporte para invocação direta via protocolo compatível com OpenAI.
Resumo
A disponibilidade geral (GA) simultânea do Gemini 3.1 Flash Image e do Gemini 3 Pro Image marca um passo importante para o Google, consolidando a transição de "capacidades experimentais" para uma "matriz de modelo duplo de nível de produção" no setor de geração de imagens. A remoção do sufixo -preview é apenas a ponta do iceberg; por trás disso, temos um SLA estável, novos recursos de vídeo, uma janela de contexto de 1 milhão de tokens e um compromisso quantificável com a consistência de múltiplos sujeitos.
Para os desenvolvedores, esta atualização praticamente não tem custo de migração — basta substituir o ID do modelo para aproveitar todas as novas funcionalidades. O ponto principal agora é definir a estratégia de uso: utilize o Flash por padrão para priorizar custo e velocidade, e suba para o Pro em cenários críticos onde a qualidade é a prioridade.
🎯 Recomendação final: Recomendamos utilizar a plataforma APIYI (apiyi.com) para invocar tanto o gemini-3.1-flash-image quanto o gemini-3-pro-image, aproveitando uma interface unificada e a flexibilidade de alternar entre eles conforme o cenário. A plataforma já concluiu a sincronização com a versão GA em 28 de maio, e o protocolo compatível com OpenAI permite que a integração seja feita em poucos minutos, garantindo uma transição suave entre os IDs antigos e novos durante o período de carência até 25 de junho.
Autor: Equipe técnica APIYI | Para mais testes de modelos de IA, visite help.apiyi.com
