Deprecations · 38 models
Google Gemini API model deprecations
Every Gemini API API model with an announced shutdown, what replaces it, and how much notice Gemini API promises.
From Gemini API's official page as of
Retiring
| Model | Status | Announced | Shutdown | Days left | Replacement | Source |
|---|---|---|---|---|---|---|
| Gemini 3.1 Flash TTS Previewgemini-3.1-flash-tts-previewpreview; date is earliest possible shutdown | Retiring | — | Nov 17, 2026 | 24 | gemini-3.8-flash-tts or gemini-3.8-flash-lite-tts | Official pagechecked Oct 23, 2026 |
| Gemini 2.5 Flash/Pro TTS Previewgemini-2.5-flash-preview-tts, gemini-2.5-pro-preview-ttspreview; earliest possible shutdown | Retiring | — | Nov 17, 2026 | 24 | gemini-3.8-flash-tts or gemini-3.8-flash-lite-tts | Official pagechecked Oct 23, 2026 |
| Gemini 3.1 Flash Live Previewgemini-3.1-flash-live-previewpreview; earliest possible shutdown | Retiring | — | Nov 17, 2026 | 24 | gemini-3.8-live | Official pagechecked Oct 23, 2026 |
| Gemini 2.5 Flash Native Audio Preview (12-2025)gemini-2.5-flash-native-audio-preview-12-2025preview; earliest possible shutdown | Retiring | — | Nov 17, 2026 | 24 | gemini-3.8-live | Official pagechecked Oct 23, 2026 |
| Gemini 2.5 Flash Imagegemini-2.5-flash-imageearliest possible shutdown | Retiring | — | Mar 15, 2027 | 142 | gemini-3.1-flash-lite-image | Official pagechecked Oct 23, 2026 |
| Gemini 3.1 Flash-Litegemini-3.1-flash-litestable; earliest possible shutdown | Retiring | — | May 7, 2027 | 195 | gemini-3.5-flash-lite | Official pagechecked Oct 23, 2026 |
| Gemini Embedding 001gemini-embedding-001earliest possible shutdown | Retiring | — | May 14, 2028 | 568 | gemini-embedding-2 | Official pagechecked Oct 23, 2026 |
Deprecated or legacy, no date yet
| Model | Status | Announced | Shutdown | Replacement | Source |
|---|---|---|---|---|---|
| Gemini 3.1 Flash Imagegemini-3.1-flash-image | Deprecated | Oct 6, 2026 | — | gemini-nano-banana-2.1 | Official pagechecked Oct 23, 2026 |
| Gemini 3.7 Flashgemini-3.7-flashendpoint not shutting down; API requests auto-route to gemini-3.8-flash | Deprecated | Oct 8, 2026 | — | gemini-3.8-flash | Official pagechecked Oct 23, 2026 |
| Gemini 3.5 Flashgemini-3.5-flashendpoint not shutting down; API requests auto-route to gemini-3.6-flash | Deprecated | Oct 8, 2026 | — | gemini-3.6-flash | Official pagechecked Oct 23, 2026 |
Gemini API's deprecation policy
- Google calls the listed shutdown dates "the earliest possible dates" on which a model might be retired and promises advance notice of the exact date. No minimum notice period is published for the Gemini API.
- Dates can differ from Vertex AI: the same model can retire on one platform and keep running on the other.
- No feed; changes are announced in the Gemini API changelog.
Already retired
28 model entries, newest first.
| Model | Status | Announced | Shutdown | Replacement | Source |
|---|---|---|---|---|---|
| Deep Research Pro Preview agent (12-2025)deep-research-pro-preview-12-2025managed agent, not a model; announced in changelog 2026-10-08 | Retired | Oct 8, 2026 | Oct 23, 2026 | deep-research-preview-04-2026 | Official pagechecked Oct 23, 2026 |
| Veo 3.1 / 3.1 Fast / 3.1 Lite Previewveo-3.1-generate-preview, veo-3.1-fast-generate-preview, veo-3.1-lite-generate-previewpreview | Retired | — | Oct 22, 2026 | gemini-omni-1.1-flash | Official pagechecked Oct 23, 2026 |
| Gemini Omni Flash Previewgemini-omni-flash-previewchangelog 2026-08-27 said the endpoint 'will be deprecated on September 30, 2026'; shutdown per deprecations table | Retired | Aug 27, 2026 | Oct 22, 2026 | gemini-omni-1.1-flash | Official pagechecked Oct 23, 2026 |
| Antigravity Preview agent (05-2026)antigravity-preview-05-2026managed agent, not a model; announced in changelog 2026-09-17 | Retired | Sep 17, 2026 | Oct 5, 2026 | antigravity-preview-09-2026 | Official pagechecked Oct 23, 2026 |
| Gemini Robotics-ER 1.6 Previewgemini-robotics-er-1.6-previewannounced in changelog 2026-07-30 | Retired | Jul 30, 2026 | Aug 31, 2026 | gemini-robotics-er-2-preview | Official pagechecked Oct 23, 2026 |
| Imagen 4 (Standard/Ultra/Fast)imagen-4.0-generate-001, imagen-4.0-ultra-generate-001, imagen-4.0-fast-generate-001announced in changelog 2026-06-15 | Retired | Jun 15, 2026 | Aug 17, 2026 | gemini-nano-banana-2.1 | Official pagechecked Oct 23, 2026 |
| Gemini Embedding 2 Previewembedding-2-previewid as written in deprecations table; changelog 2026-03-10 called the release gemini-embedding-2-preview | Retired | — | Aug 10, 2026 | gemini-embedding-2 | Official pagechecked Oct 23, 2026 |
| Gemini 2.5 Computer Use Previewgemini-2.5-computer-use-preview-10-2025preview | Retired | — | Jul 28, 2026 | gemini-3.8-flash | Official pagechecked Oct 23, 2026 |
| Veo 2 / Veo 3 / Veo 3 Fast (GA)veo-2.0-generate-001, veo-3.0-generate-001, veo-3.0-fast-generate-001or GA Veo 3.1 on Gemini Enterprise Agent Platform; announced in changelog 2026-06-15 | Retired | Jun 15, 2026 | Jun 30, 2026 | gemini-omni-1.1-flash | Official pagechecked Oct 23, 2026 |
| Gemini 3.1 Flash Image Preview / Gemini 3 Pro Image Previewgemini-3.1-flash-image-preview, gemini-3-pro-image-previewgemini-3.1-flash-image-preview -> gemini-nano-banana-2.1; announced in changelog 2026-05-28 | Retired | May 28, 2026 | Jun 25, 2026 | gemini-nano-banana-2.1 / gemini-3-pro-image | Official pagechecked Oct 23, 2026 |
| Gemini 2.0 Flash / Flash-Litegemini-2.0-flash, gemini-2.0-flash-001, gemini-2.0-flash-lite, gemini-2.0-flash-lite-001flash-lite -> gemini-3.1-flash-lite; announced in changelog 2026-02-18; shutdown confirmed in changelog 2026-06-01 | Retired | Feb 18, 2026 | Jun 1, 2026 | gemini-3.6-flash / gemini-3.1-flash-lite | Official pagechecked Oct 23, 2026 |
| Gemini 3.1 Flash-Lite Previewgemini-3.1-flash-lite-previewannounced in changelog 2026-05-07 | Retired | May 7, 2026 | May 25, 2026 | gemini-3.1-flash-lite | Official pagechecked Oct 23, 2026 |
| Gemini Robotics-ER 1.5 Previewgemini-robotics-er-1.5-previewannounced in changelog 2026-04-14 | Retired | Apr 14, 2026 | Apr 30, 2026 | gemini-robotics-er-2-preview | Official pagechecked Oct 23, 2026 |
| Gemini 2.5 Flash-Lite Preview (09-2025)gemini-2.5-flash-lite-preview-09-2025announced in changelog 2026-03-10 | Retired | Mar 10, 2026 | Mar 31, 2026 | gemini-3.1-flash-lite | Official pagechecked Oct 23, 2026 |
| Gemini 3 Pro Previewgemini-3-pro-previewalias gemini-3-pro-preview now points to gemini-3.1-pro-preview | Retired | Feb 26, 2026 | Mar 9, 2026 | gemini-3.1-pro-preview | Official pagechecked Oct 23, 2026 |
| Gemini 2.5 Flash Preview (09-2025)gemini-2.5-flash-preview-09-25id as written on deprecations page; launch note used gemini-2.5-flash-preview-09-2025 | Retired | Jan 15, 2026 | Feb 17, 2026 | gemini-3.6-flash | Official pagechecked Oct 23, 2026 |
| Imagen 4 Preview (06-06)imagen-4.0-generate-preview-06-06, imagen-4.0-ultra-generate-preview-06-06announced in changelog 2026-01-15 | Retired | Jan 15, 2026 | Feb 17, 2026 | gemini-nano-banana-2.1 | Official pagechecked Oct 23, 2026 |
| Gemini 2.5 Flash Image Previewgemini-2.5-flash-image-previewannounced in changelog 2025-12-04 | Retired | Dec 4, 2025 | Jan 15, 2026 | gemini-nano-banana-2.1 | Official pagechecked Oct 23, 2026 |
| Text Embedding 004text-embedding-004Gemini API only; on Vertex it runs to 2027-04-01 | Retired | Dec 3, 2025 | Jan 14, 2026 | gemini-embedding-2 | Official pagechecked Oct 23, 2026 |
| Gemini 2.0 Flash Live / Live 2.5 Flash Previewgemini-2.0-flash-live-001, gemini-live-2.5-flash-previewannounced in changelog 2025-10-20 | Retired | Oct 20, 2025 | Dec 9, 2025 | gemini-3.8-live | Official pagechecked Oct 23, 2026 |
| Gemini 2.0 Flash-Lite Previewgemini-2.0-flash-lite-preview, gemini-2.0-flash-lite-preview-02-05same 2025-11-04 notice also shut gemini-2.0-flash-exp, gemini-2.0-pro-exp(-02-05) on Dec 9 | Retired | Nov 4, 2025 | Dec 9, 2025 | gemini-3.1-flash-lite | Official pagechecked Oct 23, 2026 |
| Gemini 2.5 Pro Preview (03-25, 05-06, 06-05)gemini-2.5-pro-preview-03-25, gemini-2.5-pro-preview-05-06, gemini-2.5-pro-preview-06-05same notice also shut gemini-2.0-flash-thinking-exp variants on Dec 2 | Retired | Nov 4, 2025 | Dec 2, 2025 | gemini-3.1-pro-preview | Official pagechecked Oct 23, 2026 |
| Gemini 2.5 Flash Preview (05-20)gemini-2.5-flash-preview-05-20gemini-2.5-flash-lite-preview-06-17 shut same day (changelog) | Retired | Nov 4, 2025 | Nov 18, 2025 | gemini-3.6-flash | Official pagechecked Oct 23, 2026 |
| Gemini 2.0 Flash Preview Image Generationgemini-2.0-flash-preview-image-generationgemini-2.0-flash-exp-image-generation shut same day (changelog) | Retired | Nov 11, 2025 | Nov 14, 2025 | gemini-nano-banana-2.1 | Official pagechecked Oct 23, 2026 |
| Veo 3 / Veo 3 Fast Previewveo-3.0-generate-preview, veo-3.0-fast-generate-previewannounced in changelog 2025-10-15 | Retired | Oct 15, 2025 | Nov 12, 2025 | gemini-omni-1.1-flash | Official pagechecked Oct 23, 2026 |
| Imagen 3imagen-3.0-generate-002 | Retired | — | Nov 10, 2025 | gemini-nano-banana-2.1 | Official pagechecked Oct 23, 2026 |
| Legacy embedding modelsembedding-001, embedding-gecko-001, gemini-embedding-exp, gemini-embedding-exp-03-07changelog 2025-09-16 announced 'October 2025' only | Retired | Sep 16, 2025 | Oct 30, 2025 | gemini-embedding-2 | Official pagechecked Oct 23, 2026 |
| Gemini 1.5 Pro / Flash / Flash-8Bgemini-1.5-pro, gemini-1.5-flash, gemini-1.5-flash-8bnotable older shutdown (changelog entry 2025-09-29) | Retired | — | Sep 29, 2025 | — | Official pagechecked Oct 23, 2026 |
Questions
Which Gemini API models are being deprecated?
7 Gemini API model entries have announced shutdown dates, the nearest on Nov 17, 2026 (Gemini 3.1 Flash TTS Preview, Gemini 2.5 Flash/Pro TTS Preview, Gemini 3.1 Flash Live Preview, Gemini 2.5 Flash Native Audio Preview (12-2025)). 3 more are deprecated or legacy without a date.
How much notice does Gemini API give before retiring a model?
Google calls the listed shutdown dates "the earliest possible dates" on which a model might be retired and promises advance notice of the exact date. No minimum notice period is published for the Gemini API.
How can I monitor Gemini API deprecations?
No feed; changes are announced in the Gemini API changelog. The official page is https://ai.google.dev/gemini-api/docs/deprecations.