Model versions and lifecycle

Each Generative AI on Vertex AI language model is initially available in a preview version and then in a stable version. Each stable version has an auto-updated alias. This page explains how model versioning works with all Google models.

To learn about Imagen on Vertex AI model versions and their lifecycle, see Imagen on Vertex AI model versions and lifecycle.

If you tune a Gemini model, then the tuned model shares the same discontinuation date as the base model that you used in the tuning process. For more information, see Overview of model tuning for Gemini.

Gemini stable version

A stable version of a Gemini model does not change and continues to be available until its discontinuation date. Don't use a stable version after its discontinuation date; switch to a newer, available stable version. You can identify the version of a stable model by the three-digit number that's appended to the model name. For example, gemini-1.5-pro-001 is version number one of the stable release of the Gemini 1.5 Pro model.

Google releases stable versions at a regular cadence. You can switch from one stable version to another as long as the other version is still available. When you do this, run your tuning jobs again because there might be prompt, output, and other differences between the versions.

To use the stable version of a Gemini model, append the three-digit version number to the model with a hyphen (-). For example, to specify version one of the stable gemini-1.5-pro model, append -001 to the model's name:

https://us-central1-aiplatform.googleapis.com/v1/projects/my_project/locations/us-central1/publishers/google/models/gemini-1.5-pro-001

Available stable Gemini model versions

The following stable model versions are available for generally available Gemini models:

Gemini 1.5 Flash model Release date Discontinuation date Model version highlights

gemini-1.5-flash-002

September 24, 2024

September 24, 2025

Gemini 1.5 Flash model	Release date	Discontinuation date	Model version highlights
gemini-1.5-flash-002	September 24, 2024	September 24, 2025	Improved general model quality with significant gains in the following categories: Factuality and reduce model hallucinations. Openbook Q&A for RAG use cases. Instruction following. Multilingual understanding in 102 languages, especially in Korean, French, German, Spanish, Japanese, Russian, and Chinese. SQL generation. Audio understanding. Document understanding. Long context. Math and reasoning. Gemini 1.5 Flash 002 uses dynamic shared quota. Sometimes gemini-1.5-flash-002 can respond in your local language, even if the prompt is written in another language. This issue only applies to non-English prompts. To mitigate this issue, we recommend you add the following to your system instructions to ensure the model responds in the same language as the prompt: `All questions should be answered comprehensively with details, unless the user requests a concise response specifically. Respond in the same language as the query.`
gemini-1.5-flash-001	May 24, 2024	May 24, 2025	Initial version of Gemini 1.5 Flash.

Improved general model quality with significant gains in the following categories:

Factuality and reduce model hallucinations.
Openbook Q&A for RAG use cases.
Instruction following.
Multilingual understanding in 102 languages, especially in Korean, French, German, Spanish, Japanese, Russian, and Chinese.
SQL generation.
Audio understanding.
Document understanding.
Long context.
Math and reasoning.

Gemini 1.5 Flash 002 uses dynamic shared quota.

Sometimes gemini-1.5-flash-002 can respond in your local language, even if the prompt is written in another language. This issue only applies to non-English prompts. To mitigate this issue, we recommend you add the following to your system instructions to ensure the model responds in the same language as the prompt:

All questions should be answered comprehensively with details, unless the user requests a concise response specifically. Respond in the same language as the query.

gemini-1.5-flash-001 May 24, 2024 May 24, 2025 Initial version of Gemini 1.5 Flash.

Gemini 1.5 Pro model Release date Discontinuation date Model version highlights

gemini-1.5-pro-002

September 24, 2024

September 24, 2025

Gemini 1.5 Pro model	Release date	Discontinuation date	Model version highlights
gemini-1.5-pro-002	September 24, 2024	September 24, 2025	Improved general model quality with significant gains in the following categories: Factuality and reduce model hallucinations. Openbook Q&A for RAG use cases. Instruction following. Multilingual understanding in 102 languages, especially in Korean, French, German, Spanish, Japanese, Russian, and Chinese. SQL generation. Audio understanding. Document understanding. Long context. Math and reasoning. Gemini 1.5 Pro 002 uses dynamic shared quota. Sometimes gemini-1.5-pro-002 can respond in your local language, even if the prompt is written in another language. This issue only applies to non-English prompts. To mitigate this issue, we recommend you add the following to your system instructions to ensure the model responds in the same language as the prompt: `All questions should be answered comprehensively with details, unless the user requests a concise response specifically. Respond in the same language as the query.`
gemini-1.5-pro-001	May 24, 2024	May 24, 2025	Initial version of Gemini 1.5 Pro.

Improved general model quality with significant gains in the following categories:

Factuality and reduce model hallucinations.
Openbook Q&A for RAG use cases.
Instruction following.
Multilingual understanding in 102 languages, especially in Korean, French, German, Spanish, Japanese, Russian, and Chinese.
SQL generation.
Audio understanding.
Document understanding.
Long context.
Math and reasoning.

Gemini 1.5 Pro 002 uses dynamic shared quota.

Sometimes gemini-1.5-pro-002 can respond in your local language, even if the prompt is written in another language. This issue only applies to non-English prompts. To mitigate this issue, we recommend you add the following to your system instructions to ensure the model responds in the same language as the prompt:

All questions should be answered comprehensively with details, unless the user requests a concise response specifically. Respond in the same language as the query.

gemini-1.5-pro-001 May 24, 2024 May 24, 2025 Initial version of Gemini 1.5 Pro.

Gemini 1.0 Pro Vision model	Release date	Discontinuation date
gemini-1.0-pro-vision-001	February 15, 2024	April 9, 2025

Gemini 1.0 Pro model	Release date	Discontinuation date
gemini-1.0-pro-001	February 15, 2024	April 9, 2025
gemini-1.0-pro-002	April 9, 2024	April 9, 2025

Gemini auto-updated alias

The auto-updated alias of a Gemini model points to the most recent stable version. When a new stable version is released, the auto-updated alias points to the new version. This means that if you specify the auto-updated alias of a Gemini model in your code, the model could behave differently without notice when the next stable version is released. Because of this, use an auto-updated alias with caution if you tune your model.

To use the auto-updated alias for a model, don't append anything to the model name. For example, the following uses the auto-updated version of the gemini-1.0-pro-vision model:

https://us-central1-aiplatform.googleapis.com/v1/projects/my_project/locations/us-central1/publishers/google/models/gemini-1.0-pro-vision

Gemini auto-updated aliases

The following table shows the available auto-updated aliases for Gemini model versions and the stable version each references.

Auto-updated alias	Referenced stable version
`gemini-1.5-flash`	`gemini-1.5-flash-001` Note: To use the latest version (`002`), append `-002` to the model name instead of using the alias.
`gemini-1.0-pro-vision`	`gemini-1.0-pro-vision-001`
`gemini-1.5-pro`	`gemini-1.5-pro-001` Note: To use the latest version (`002`), append `-002` to the model name instead of using the alias.
`gemini-1.0-pro`	`gemini-1.0-pro-002`
`gemini-pro-experimental`	See Experimental models.
`gemini-flash-experimental`	See Experimental models.

Code completion stable model versions

The following stable model versions are available for generally available Generative AI models:

code-gecko model	Release date	Discontinuation date
code-gecko@002	December 6, 2023	April 9, 2025

Embeddings stable model versions

The following stable model versions are available for generally available Generative AI models:

Model name	Release date	Discontinuation date
text-embedding-005	Nov 18, 2024	To be determined.
text-embedding-004	May 14, 2024	Nov 18, 2025
text-multilingual-embedding-002	May 14, 2024	To be determined.
textembedding-gecko@003	December 12, 2023	May 14, 2025
textembedding-gecko-multilingual@001	November 2, 2023	May 14, 2025
textembedding-gecko@002 (regressed, but still supported)	November 2, 2023	April 9, 2025
textembedding-gecko@001 (regressed, but still supported)	June 7, 2023	April 9, 2025
multimodalembedding@001	February 12, 2024	To be determined.

Legacy models

For information about the discontinuation dates of legacy models like PaLM 2, see Legacy model information.