Model versions and lifecycle
This document defines key terms related to the lifecycle stages and importantdates for Gemini and embedding models that are available onGoogle Cloud Vertex AI. It also gives you the recommended upgrades forthe models and points you to available migration paths.
Key Terms
Stable model: A publicly released version of the model that is available andsupported for production use starting on the release date. A stable modelversion is typically released with aretirement date, which indicates the lastday that the model is available. One month before the retirement date, new accessto the model is blocked for online inference, batch inference, and tuning. Afterthis date, the model is no longer accessible or supported by Google.
- Latest stable models: The latest version within the model familyrecommended for new and active projects and should be the target formigrations from earlier versions. SeeLatest stablemodels.
- Retired models: The model version is past its retirement date and hasbeen permanently deactivated. Retired models are no longer accessible orsupported by Google. API requests referencing a retired model ID typicallyreturns a 404 error. SeeRetired models.
- Recommended upgrades: The latest stable model that we recommendswitching to. Latest stable models tend to offer better performance and morecapabilities as compared to legacy stable models. See the recommendedupgradesRetired models sections.
Latest stable models
The following table lists the latest stable models:
Gemini models
| Model ID | Release date | Retirement date |
|---|---|---|
gemini-live-2.5-flash-native-audio | December 12, 2025 | December 13, 2026 |
gemini-2.5-pro | June 17, 2025 | June 17, 2026 |
gemini-2.5-flash | June 17, 2025 | June 17, 2026 |
gemini-2.5-flash-lite | July 22, 2025 | July 22, 2026 |
gemini-2.5-flash-image | October 2, 2025 | October 2, 2026 |
gemini-2.0-flash-001 | February 5, 2025 | June 1, 2026 |
gemini-2.0-flash-lite-001 | February 25, 2025 | June 1, 2026 |
Imagen models
| Model ID | Release date | Retirement date |
|---|---|---|
virtual-try-on-001 | January 20, 2026 | January 20, 2027 |
imagen-4.0-generate-001 | August 14, 2025 | No retirement date announced |
imagen-4.0-fast-generate-001 | August 14, 2025 | No retirement date announced |
imagen-4.0-ultra-generate-001 | August 14, 2025 | No retirement date announced |
imagen-3.0-generate-002 | January 29, 2025 | No retirement date announced |
imagen-3.0-generate-001 | December 10, 2024 | No retirement date announced |
imagen-3.0-fast-generate-001 | December 10, 2024 | No retirement date announced |
imagen-3.0-capability-001 | December 10, 2024 | No retirement date announced |
Veo models
| Model ID | Release date | Retirement date |
|---|---|---|
veo-3.1-generate-001 | November 17, 2025 | No retirement date announced |
veo-3.1-fast-generate-001 | November 17, 2025 | No retirement date announced |
veo-3.0-generate-001 | July 29, 2025 | No retirement date announced |
veo-3.0-fast-generate-001 | July 29, 2025 | No retirement date announced |
veo-2.0-generate-001 | May 27, 2025 | No retirement date announced |
Embeddings models
| Model ID | Release date | Retirement date | |
|---|---|---|---|
gemini-embedding-001 | May 20, 2025 | No retirement date announced | |
text-embedding-005 | November 18, 2024 | April 1, 2027 | |
text-embedding-004 | May 14, 2024 | April 1, 2027 | |
text-multilingual-embedding-002 | May 14, 2024 | April 1, 2027 | |
multimodalembedding@001 | February 12, 2024 | April 1, 2027 |
Migrate to a latest stable model
To learn how to migrate to a latest stable model, seeMigrate to the latest Gemini models.This guide gives you a set of migration steps that aims to minimize somepotential risks involved in model migration and helps you use new models in anoptimal way.
However, if you don't have time to follow the guide and just need to quicklyresolve the errors caused by models reaching their retirement dates, do the following:
- Update your application to point to the recommended upgrades.
- Test all mission critical features to make sure everything works as expected.
- Deploy the updates like you normally would.
Gemini auto-updated aliases
The auto-updated alias of a Gemini model always points to the lateststable model. When a new latest stable model is available, the auto-updatedalias automatically points to the new version.
The following table shows the auto-updated aliases for Gemini modelsand the latest stable models that they point to.
| Auto-updated alias | Stable version reference |
|---|---|
gemini-2.5-pro | gemini-2.5-pro |
gemini-2.5-flash | gemini-2.5-flash |
gemini-2.5-flash-lite | gemini-2.5-flash-lite |
gemini-2.0-flash-lite | gemini-2.0-flash-lite-001 |
gemini-2.0-flash | gemini-2.0-flash-001 |
Retired models
The following table lists the retired models (click to expand)
| Model ID | Release date | Retirement date | Recommended upgrade |
|---|---|---|---|
gemini-1.5-pro-001 | May 24, 2024 | May 24, 2025 | gemini-2.0-flash |
gemini-1.5-pro-002 | September 24, 2024 | September 24, 2025 | gemini-2.0-flash |
gemini-1.5-flash-001 | May 24, 2024 | May 24, 2025 | gemini-2.0-flash-lite |
gemini-1.5-flash-002 | September 24, 2024 | September 24, 2025 | gemini-2.0-flash-lite |
textembedding-gecko@003* | December 12, 2023 | May 24, 2025 | gemini-embedding-001 |
textembedding-gecko-multilingual@001 | November 2, 2023 | May 24, 2025 | gemini-embedding-001 |
gemini-1.0-pro-001 | February 15, 2024 | April 21, 2025 | gemini-2.0-flash |
gemini-1.0-pro-002 | April 9, 2024 | April 21, 2025 | gemini-2.0-flash |
gemini-1.0-pro-vision-001 | February 15, 2024 | April 21, 2025 | gemini-2.0-flash |
text-bison | May 2023 | April 21, 2025 | gemini-2.0-flash-lite |
chat-bison | May 2023 | April 21, 2025 | gemini-2.0-flash-lite |
code-gecko | May 2023 | April 21, 2025 | gemini-2.0-flash-lite |
textembedding-gecko@002 | November 2, 2023 | April 21, 2025 | gemini-embedding-001 |
textembedding-gecko@001 | June 7, 2023 | April 21, 2025 | gemini-embedding-001 |
imagetext | June 7, 2023 | September 24, 2025 | gemini-2.5-flash-image |
imagegeneration@002 | August 17, 2023 | September 24, 2025 | imagen-3.0-capability-001 orimagen-3.0-generate-002 |
imagegeneration@005 | November 22, 2023 | September 24, 2025 | imagen-3.0-capability-001 orimagen-3.0-generate-002 |
imagegeneration@006 | March 27, 2024 | September 24, 2025 | imagen-3.0-capability-001 orimagen-3.0-generate-002 |
What's next
- To learn which regions models are available, seeDeployments and endpoints.
- For details about individual models, seeGoogle models and click the model that you want tolearn more about.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.