Okapi Okapi

gemini-2.5-pro model retirement

Redirectsin 25 daysSubscribe to Gemini APIShare

On December 1, 2026, Gemini API will retire model gemini-2.5-pro. API calls targeting model gemini-2.5-pro will not fail; instead, Gemini API will automatically redirect those requests to gemini-3.8-flash.


What to use instead of gemini-2.5-pro

Update your requests to target the recommended replacement, gemini-3.8-flash, before gemini-2.5-pro stops working on December 1, 2026.

In Gemini API's words

Model: gemini-2.5-pro; Release date: June 17, 2025; Shutdown date: December 1, 2026; Recommended replacement: 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)

Gemini API, Deprecations page

Facts

API
Gemini API generativelanguage.googleapis.com
Model
gemini-2.5-pro
Released
June 17, 2025 (models.dev)
Kind
Model retirement
Takes effect
December 1, 2026
Calls after that day
Answered by a newer version
Source
Deprecations page
Last updated
Verified
, against Gemini API's own pages

Questions

When does this change take effect?

From December 1, 2026, Gemini API answers calls to the model gemini-2.5-pro from a newer version.

What happens to calls after December 1, 2026?

Gemini API answers them from a newer version. The response can differ from what your code expects.

When was gemini-2.5-pro released?

gemini-2.5-pro was released on June 17, 2025, according to models.dev.

How do I find the calls this hits in my code?

Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.


gemini-2.5-pro on other APIs 3

  1. Vertex AI gemini-2.5-proModel retirement Stopped working
  2. Lovable AI Gateway google/gemini-2.5-proModel retirement Redirected
  3. OpenRouter google/gemini-2.5-proModel retirement Stopped working

More from Gemini API 10

  1. gemini-omni-flash-previewModel retirement Stopped working
  2. veo-3.1-fast-generate-previewModel retirement Stopped working
  3. veo-3.1-generate-previewModel retirement Stopped working
  4. gemini-2.5-flash-native-audio-preview-12-2025Model retirement Stops workingin 11 days
  5. gemini-2.5-flash-preview-ttsModel retirement Stops workingin 11 days
  6. gemini-2.5-pro-preview-ttsModel retirement Stops workingin 11 days
  7. gemini-3.1-flash-live-previewModel retirement Stops workingin 11 days
  8. gemini-3.1-flash-tts-previewModel retirement Stops workingin 11 days
  9. gemini-2.5-flashModel retirement Redirectsin 25 days
  10. gemini-omni-1.1-flashModel retirement Stops workingin 27 days

Is your code calling this?

Okapi finds the calls this change hits in your repo and opens the pull request with the fix before December 1, 2026.

Add to GitHub

Get notifications

Subscribe to Gemini API

Hear about each breaking change Gemini API announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • Gemini API

2Where to get it

/breaking-changes/feed.xml

Paste it into Feedly, Inoreader, NetNewsWire or any reader. New changes show up as they're announced.