gemini-2.5-pro deprecation — retirement date and replacement
Source last checked: 2026-11-08.
Google is retiring gemini-2.5-pro on 2026-12-01 — in 23 days. The provider’s documented replacement is gemini-3.8-flash. This page is built from Google’s official deprecation notice and is rechecked weekly; the source link is below.
When is gemini-2.5-pro being deprecated?
| Model | Provider | Retires | Replacement |
|---|---|---|---|
| gemini-2.5-pro | 2026-12-01 | gemini-3.8-flash |
gemini-2.5-pro is no longer available in Google AI Studio; effective December 1, 2026, API requests to gemini-2.5-pro will automatically route to gemini-3.8-flash
Source: Google deprecation notice
Test before switching
- Check the replacement's supported API endpoints and request parameters.
- Test your prompts, structured output, streaming and tool calls on staging.
- Compare quality, latency, pricing and rate limits on your workload.
- Keep a rollback path while the old model remains available.
Download retirement dates for your models.
What should I migrate gemini-2.5-pro to?
Google documents gemini-3.8-flash as the successor. This is not a compatibility guarantee: request parameters, API endpoints, pricing, tool calls and output behaviour may differ. Check the linked provider documentation and run your own workload before switching.
Measured latency of the Google API host
| Region | p50 TTFB | p95 | Uptime | Probes |
|---|---|---|---|---|
| Asia (Tokyo) | 63 ms | 118 ms | 100% | 287 |
| Europe (Germany) | 93 ms | 102 ms | 100% | 297 |
| South America (Santiago) | 972 ms | 1071 ms | 100% | 98 |
| US (Central) | 41 ms | 111 ms | 100% | 287 |
Edge latency to the provider’s API host over the last 24 hours, measured from 4 regions. This measures the endpoint, not the model: swapping models on the same host is not an inference benchmark or a promise about the replacement model. Compare edge latency
What else retires on 2026-12-01?
| Model | Provider | Retires | Replacement |
|---|---|---|---|
| gpt-image-1-mini | OpenAI | 2026-12-01 | gpt-image-2.6-sunburst or gpt-image-2.6-flare |
| gpt-image-1.5 | OpenAI | 2026-12-01 | gpt-image-2.6-sunburst or gpt-image-2.6-flare |
| chatgpt-image-latest | OpenAI | 2026-12-01 | gpt-image-2.6-sunburst or gpt-image-2.6-flare |
| gpt-image-1.5-2025-12-16 | OpenAI | 2026-12-01 | gpt-image-2.6-sunburst or gpt-image-2.6-flare |
| gemini-2.5-flash | 2026-12-01 | gemini-3.5-flash-lite |
These models share a shutdown date. Plan each affected integration before that deadline.
Other Google models being retired
| Model | Provider | Retires | Replacement |
|---|---|---|---|
| gemini-3.1-flash-lite | 2027-05-07 or later | gemini-3.5-flash-lite | |
| gemini-3.1-flash-tts-preview | 2026-11-17 or later | gemini-3.8-flash-tts or gemini-3.8-flash-lite-tts | |
| gemini-3-pro-preview | 2026-03-09 | gemini-3.1-pro-preview | |
| gemini-3.1-flash-lite-preview | 2026-05-25 | gemini-3.1-flash-lite | |
| gemini-2.5-computer-use-preview-10-2025 | 2026-07-28 | gemini-3.8-flash | |
| gemini-2.5-pro-preview-03-25 | 2025-12-02 | gemini-3.8-flash | |
| gemini-2.5-pro-preview-05-06 | 2025-12-02 | gemini-3.8-flash | |
| gemini-2.5-pro-preview-06-05 | 2025-12-02 | gemini-3.8-flash |
How is this calendar maintained?
Entries are pulled from provider documentation by an automated weekly job and every one carries a link to its source. Nothing is inferred from blog posts or social media. When a provider changes a date, the change appears here after the next run and is visible in the changelog. The full calendar across all providers is on the deprecations page, and this provider’s own list is at Google deprecations.