Okapi Okapi

gemini-2.5-flash-preview-05-20 model retirement

Stopped workingSubscribe to Gemini APIShare

Calls to the model gemini-2.5-flash-preview-05-20 stopped working on November 18, 2025.


The error you get

What Gemini API answers a call to gemini-2.5-flash-preview-05-20 once the model is gone, as recorded from real responses:

Once it is closed to new API keys: HTTP 404
{"error":{"code":404,"message":"This model models/gemini-2.5-flash-preview-05-20 is no longer available to new users. Please update your code to use a newer model for the latest features and improvements.","status":"NOT_FOUND"}}
Once it is shut down: HTTP 404
{"error":{"code":404,"message":"models/gemini-2.5-flash-preview-05-20 is not found for API version v1beta, or is not supported for generateContent. Call ModelService.ListModels to see the list of available models and their supported methods.","status":"NOT_FOUND"}}

What to use instead of gemini-2.5-flash-preview-05-20

Move to gemini-3.6-flash, recommended by Google.

In Gemini API's words

Model: gemini-2.5-flash-preview-05-20; Release date: May 20, 2025; Shutdown date: November 18, 2025; Recommended replacement: gemini-3.6-flash

Gemini API, Deprecations page

Facts

API
Gemini API generativelanguage.googleapis.com
Model
gemini-2.5-flash-preview-05-20
Released
May 20, 2025 (models.dev)
Kind
Model retirement
Takes effect
November 18, 2025
Calls after that day
Fail
Source
Deprecations page
Last updated
Verified
, against Gemini API's own pages

Questions

When does gemini-2.5-flash-preview-05-20 shut down?

Calls to the model gemini-2.5-flash-preview-05-20 stopped working on November 18, 2025.

What happens to calls after November 18, 2025?

They have failed since November 18, 2025.

What error does gemini-2.5-flash-preview-05-20 return once it is shut down?

Gemini API answers HTTP 404: "This model models/gemini-2.5-flash-preview-05-20 is no longer available to new users. Please update your code to use a newer model for the latest features and improvements.". Send another model to fix it.

When was gemini-2.5-flash-preview-05-20 released?

gemini-2.5-flash-preview-05-20 was released on May 20, 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-flash-preview-05-20 on other APIs 2

  1. Vertex AI gemini-2.5-flash-preview-05-20Model retirement Stopped working
  2. No date Nano-gpt gemini-2.5-flash-preview-05-20Model retirement Deprecated, no date

More from Gemini API 10

  1. embedding-001Model retirement Stopped working
  2. embedding-gecko-001Model retirement Stopped working
  3. gemini-embedding-expModel retirement Stopped working
  4. imagen-3.0-generate-002Model retirement Stopped working
  5. veo-3.0-fast-generate-previewModel retirement Stopped working
  6. veo-3.0-generate-previewModel retirement Stopped working
  7. gemini-2.0-flash-preview-image-generationModel retirement Stopped working
  8. gemini-2.5-pro-preview-03-25Model retirement Stopped working
  9. gemini-2.5-pro-preview-05-06Model retirement Stopped working
  10. gemini-2.5-pro-preview-06-05Model retirement Stopped working

You fixed this one by hand.

Okapi opens the pull request with the fix before the next breaking change reaches your code.

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.