Versões de modelo e ciclo de vida

Este guia define termos importantes relacionados às etapas do ciclo de vida do Gemini e dos modelos de incorporação, além de fornecer informações sobre datas importantes, upgrades recomendados e caminhos de migração.

Neste guia, abordamos os seguintes tópicos:

• Termos principais:saiba mais sobre as definições de modelos estáveis, legados e desativados.
• Modelos estáveis mais recentes:confira a lista dos modelos mais recentes e recomendados para uso.
• Modelos legados estáveis:encontre informações sobre modelos mais antigos e compatíveis e os caminhos de upgrade sugeridos.
• Migrar para um modelo estável mais recente:receba instruções sobre como atualizar seus aplicativos para usar os modelos mais recentes.
• Aliases atualizados automaticamente do Gemini:saiba como usar aliases que apontam automaticamente para as versões mais recentes do modelo.
• Modelos desativados:confira uma lista de modelos que não estão mais disponíveis ou não têm mais suporte.

Termos importantes

• Modelo estável: uma versão lançada publicamente de um modelo disponível e com suporte para uso em produção. Uma versão estável de um modelo geralmente tem uma data de desativação, que é o último dia em que o modelo fica disponível. Depois dessa data, o modelo não estará mais acessível nem terá suporte do Google.

  • Modelo estável mais recente: a versão mais recente de uma família de modelos. O Google recomenda essa versão para projetos novos e ativos. Ele também deve ser seu destino ao migrar de versões anteriores. Consulte Modelos estáveis mais recentes.
  • Modelo estável legado: uma versão de modelo que foi substituída por uma versão mais recente. Embora os modelos estáveis legados ainda tenham suporte, migre para o modelo mais recente para aproveitar os recursos e melhorias mais recentes. O Google pode restringir o acesso a modelos estáveis legados para novos projetos. Consulte Modelos legados estáveis.

• Modelo desativado: uma versão de modelo que passou da data de desativação e foi desativada permanentemente. O Google não oferece mais suporte a modelos desativados, e eles estão inacessíveis. As solicitações de API que fazem referência a um ID de modelo desativado geralmente retornam um erro 404 Not Found. Consulte Modelos desativados.

• Upgrade recomendado: o modelo estável mais recente para o qual você deve fazer upgrade. Os modelos estáveis mais recentes geralmente oferecem melhor desempenho e mais recursos do que os legados. Para recomendações específicas, consulte os caminhos de upgrade nas seções Modelos legados estáveis e Modelos desativados.

Modelos estáveis mais recentes

A tabela a seguir lista os modelos estáveis mais recentes:

ID do modelo	Data de lançamento	Data de desativação	Detalhes
gemini-2.5-pro	17 de junho de 2025	17 de junho de 2026
gemini-2.5-flash	17 de junho de 2025	17 de junho de 2026
gemini-2.5-flash-lite	22 de julho de 2025	22 de julho de 2026
gemini-2.0-flash-001	5 de fevereiro de 2025	5 de fevereiro de 2026	Gemini 2.0: Flash, Flash-Lite e Pro – Blog para desenvolvedores do Google
gemini-2.0-flash-lite-001	25 de fevereiro de 2025	25 de fevereiro de 2026	Gemini 2.0: Flash, Flash-Lite e Pro – Blog para desenvolvedores do Google
gemini-embedding-001	20 de maio de 2025	Nenhuma data de desativação anunciada
text-embedding-005	18 de novembro de 2024	Nenhuma data de desativação anunciada
text-multilingual-embedding-002	14 de maio de 2024	Nenhuma data de desativação anunciada
multimodalembedding@001	12 de fevereiro de 2024	Nenhuma data de desativação anunciada

Modelos estáveis legados

A tabela a seguir lista os modelos legados estáveis:

ID do modelo	Data de lançamento	Data de desativação	Upgrade recomendado
gemini-1.5-pro-002*	24 de setembro de 2024	24 de setembro de 2025	gemini-2.0-flash
gemini-1.5-flash-002*	24 de setembro de 2024	24 de setembro de 2025	gemini-2.0-flash-lite
text-embedding-004	14 de maio de 2024	18 de novembro de 2025	gemini-embedding-001

*Restrito para novos projetos.

Migrar para um modelo estável mais recente

Para saber como migrar para um modelo estável mais recente, consulte Migrar seu aplicativo para o Gemini 2 com a API Gemini na Vertex AI. Este guia mostra as etapas de migração para ajudar você a minimizar riscos e usar novos modelos de maneira eficaz.

Se você precisar atualizar seu aplicativo para resolver erros causados por um modelo que atingiu a data de desativação, faça o seguinte:

1. Atualize seu aplicativo para apontar para o upgrade recomendado.
2. Teste todos os recursos essenciais para garantir que eles funcionem conforme o esperado.
3. Implante as atualizações.

Aliases atualizados automaticamente pelo Gemini

Você pode especificar um modelo usando um ID de versão fixada (por exemplo, gemini-1.5-pro-002) ou um alias atualizado automaticamente (por exemplo, gemini-1.5-pro). Um alias atualizado automaticamente para um modelo do Gemini sempre aponta para a versão estável mais recente desse modelo. Quando uma nova versão estável é lançada, o alias aponta automaticamente para ela.

A tabela a seguir compara essas duas opções.

Opção	Descrição	Prós	Caso de uso
Versão fixada (por exemplo, gemini-1.5-pro-002)	Usa uma versão específica e imutável do modelo.	Comportamento previsível e saídas estáveis, já que o modelo subjacente não muda.	Ambientes Production em que a consistência e a capacidade de reprodução são essenciais.
Alias atualizado automaticamente (por exemplo, gemini-1.5-pro)	Aponta automaticamente para a versão estável mais recente de um modelo.	Acesso aos recursos e melhorias mais recentes sem mudanças manuais no código.	Aplicativos de desenvolvimento ou não críticos em que o uso dos recursos mais recentes do modelo é priorizado em vez da consistência estrita da versão.

A tabela a seguir mostra os aliases atualizados automaticamente para modelos do Gemini e os modelos estáveis mais recentes que eles indicam.

Alias atualizado automaticamente	Referência de versão estável
gemini-2.0-flash-lite	gemini-2.0-flash-lite-001
gemini-2.0-flash	gemini-2.0-flash-001
gemini-1.5-pro	gemini-1.5-pro-002
gemini-1.5-flash	gemini-1.5-flash-002

Modelos desativados

A seguir

• Para saber em quais regiões os modelos estão disponíveis, consulte Implantações e endpoints.
• Para detalhes sobre modelos individuais, consulte Modelos do Google e clique no modelo que você quer conhecer melhor.