Gemini 2.5 Flash & Flash-Lite Deprecation, Shutdown Dates & Migration Guide
Track confirmed UTC deprecation and shutdown dates for Gemini 2.5 Flash & Flash-Lite (Google) across Google Gemini, Google Vertex AI. Preview gemini-2.5-flash → gemini-3.5-flash-lite upgrades locally below, audit full configs in the Model Config Auditor, or benchmark token pricing in DevToken.
1. Quick .env & SDK Snippet Replacement Matcher
Edit or paste your .env assignment, LiteLLM route, or SDK model identifier below to check live 3-state EOL status and copy a ready-to-apply replacement diff locally in your browser.
Replacement Diff Preview (gemini-2.5-flash → gemini-3.5-flash-lite)
# GEMINI_MODEL: gemini-2.5-flash -> gemini-3.5-flash-lite [DEPRECATED · EOL 2026-12-01]
- GEMINI_MODEL="gemini-2.5-flash"
+ GEMINI_MODEL="gemini-3.5-flash-lite"
# VERTEX_MODEL: gemini-live-2.5-flash-native-audio -> gemini-3.8-live [DEPRECATED · EOL 2026-12-13]
- VERTEX_MODEL="gemini-live-2.5-flash-native-audio"
+ VERTEX_MODEL="gemini-3.8-live"
2. Cross-Ecosystem Gemini 2.5 Flash & Flash-Lite Lifecycle Matrix (14)
Direct vendor APIs and cloud platforms retire dated snapshots on independent schedules. Verify the exact model ID, vendor lifecycle stage, and UTC shutdown date matching your deployment.
| Model ID | Provider | Calculated Status | Confirmed Shutdown (UTC) | Vendor Lifecycle | Replacement & Migration | Source |
|---|---|---|---|---|---|---|
gemini-2.5-flash-native-audio-preview-12-2025 |
Google Gemini | DEPRECATED (5d) | 2026-11-17in 5d | Deprecated | Docs ↗ | |
gemini-2.5-flash-preview-tts |
Google Gemini | DEPRECATED (5d) | 2026-11-17in 5d | Deprecated | Docs ↗ | |
gemini-2.5-flash |
Google Gemini | DEPRECATED (19d) | 2026-12-01in 19d | Deprecated | Docs ↗ | |
gemini-live-2.5-flash-native-audio |
Google Vertex AIGemini Models | DEPRECATED (31d) | 2026-12-13in 31d | Deprecated | Docs ↗ | |
gemini-2.5-flash-image |
Google Gemini | DEPRECATED (123d) | 2027-03-15in 123d | Deprecated | Docs ↗ | |
gemini-2.5-flash-image |
Google Vertex AIGemini Models | DEPRECATED (123d) | 2027-03-15in 123d | Deprecated | Docs ↗ | |
gemini-2.5-flash |
Google Vertex AIGemini Models | RETIRED | 2026-10-2023d ago | Retired | Docs ↗ | |
gemini-2.5-flash-lite |
Google Vertex AIGemini Models | RETIRED | 2026-10-2023d ago | Retired | Docs ↗ | |
gemini-2.5-flash-lite-preview-09-2025 |
Google Gemini | RETIRED | 2026-03-31226d ago | Retired | Docs ↗ | |
gemini-2.5-flash-preview-09-2025 |
Google Gemini | RETIRED | 2026-02-17268d ago | Retired | Docs ↗ | |
gemini-2.5-flash-image-preview |
Google Gemini | RETIRED | 2026-01-15301d ago | Retired | Docs ↗ | |
gemini-live-2.5-flash-preview |
Google Gemini | RETIRED | 2025-12-09338d ago | Retired | Docs ↗ | |
gemini-2.5-flash-preview-05-20 |
Google Gemini | RETIRED | 2025-11-18359d ago | Retired | Docs ↗ | |
gemini-2.5-flash-lite |
Google Gemini | ACTIVE | No EOL | Active | — | — |
3. Production Migration Checklist (gemini-2.5-flash → gemini-3.5-flash-lite)
Follow this deterministic engineering sequence before retiring pinned snapshots in production services and SDK clients:
- Inventory pinned model IDs: Search repositories and deployment manifests for
GEMINI_MODEL,gemini/LiteLLM routes, and dated snapshot strings in the Gemini 2.5 Flash & Flash-Lite family (6 deprecated, 7 retired, 1 active variants tracked). - Benchmark successor quality & token pricing: Validate structured output schemas, tool-calling payloads, and latency against
gemini-3.5-flash-lite, then compare input, output, and cached token rates in DevToken. - Enforce keyless CI guardrails: Wire RSS, Atom, iCal feeds & CI Guard into pull-request checks so retired or deprecated Gemini 2.5 Flash & Flash-Lite identifiers cannot re-enter production.
4. Related Google & Ecosystem Migration Guides
Compare sibling model families or inspect full provider-level schedules across every ecosystem hosting this family:
Gemini 1.5 Pro
RETIREDGemini 1.5 Flash
RETIREDGemini 2.0 Flash & Flash-Lite
RETIREDGemini 2.5 Pro
DEPRECATED (5d)Google Text & Gemini Embeddings (004 / Gecko)
DEPRECATED (140d)5. Gemini 2.5 Flash & Flash-Lite Deprecation & Upgrade FAQ
Is Gemini 2.5 Flash & Flash-Lite deprecated or retired across Google Gemini, Google Vertex AI?
LLMEOL tracks 14 Gemini 2.5 Flash & Flash-Lite variants across Google Gemini, Google Vertex AI: 6 deprecated with scheduled shutdowns, 7 retired past their UTC EOL date, and 1 active with no announced shutdown date. Check the cross-ecosystem matrix above for exact snapshot dates.
What is the recommended replacement model when migrating off gemini-2.5-flash?
The primary recommended upgrade target for gemini-2.5-flash is gemini-3.5-flash-lite. Always test prompt formatting, max output tokens, and tool schemas on gemini-3.5-flash-lite, and compare token pricing in DevToken before switching production traffic.
How can I replace gemini-2.5-flash in .env and LiteLLM configs safely?
Paste your GEMINI_MODEL assignment or LiteLLM model block into the Quick Replacement Matcher on this page to generate an exact diff, or open the full Local Model Config Auditor to scan multi-service manifests with zero network upload.