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:
{"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"}}
{"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
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
-
Vertex AI
gemini-2.5-flash-preview-05-20Model retirement Stopped working -
No date
Nano-gpt
gemini-2.5-flash-preview-05-20Model retirement Deprecated, no date
More from Gemini API 10
-
embedding-001Model retirement Stopped working -
embedding-gecko-001Model retirement Stopped working -
gemini-embedding-expModel retirement Stopped working -
imagen-3.0-generate-002Model retirement Stopped working -
veo-3.0-fast-generate-previewModel retirement Stopped working -
veo-3.0-generate-previewModel retirement Stopped working -
gemini-2.0-flash-preview-image-generationModel retirement Stopped working -
gemini-2.5-pro-preview-03-25Model retirement Stopped working -
gemini-2.5-pro-preview-05-06Model retirement Stopped working -
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.