Okapi Okapi

gemini-2.5-flash-image model retirement

Stops workingin 129 daysSubscribe to Gemini APIShare

On March 15, 2027, the gemini-2.5-flash-image model will stop working. Calls using model gemini-2.5-flash-image will fail after this date. This shutdown affects all requests directed to this specific model.


The error you get from March 15, 2027

What Gemini API answers a call to gemini-2.5-flash-image 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-image 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-image 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-image

Move to the recommended replacement gemini-3.1-flash-lite-image.

In Gemini API's words

Model: gemini-2.5-flash-image; Release date: October 2, 2025; Shutdown date: March 15, 2027; Recommended replacement: gemini-3.1-flash-lite-image

Gemini API, Deprecations page

Facts

API
Gemini API generativelanguage.googleapis.com
Model
gemini-2.5-flash-image
Released
August 26, 2025 (models.dev)
Kind
Model retirement
Takes effect
March 15, 2027
Calls after that day
Fail
Source
Deprecations page
Last updated
Verified
, against Gemini API's own pages

Questions

When does gemini-2.5-flash-image shut down?

Calls to the model gemini-2.5-flash-image stop working on March 15, 2027.

What happens to calls after March 15, 2027?

They fail from that day.

What error does gemini-2.5-flash-image return once it is shut down?

Gemini API answers HTTP 404: "This model models/gemini-2.5-flash-image 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-image released?

gemini-2.5-flash-image was released on August 26, 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-image on other APIs 2

  1. Vertex AI gemini-2.5-flash-imageModel retirement Stops workingin 129 days
  2. Lovable AI Gateway google/gemini-2.5-flash-imageModel retirement Stops workingin 129 days

More from Gemini API 10

  1. gemini-omni-flash-previewModel retirement Stopped working
  2. gemini-2.5-flash-native-audio-preview-12-2025Model retirement Stops workingin 11 days
  3. gemini-2.5-flash-preview-ttsModel retirement Stops workingin 11 days
  4. gemini-2.5-pro-preview-ttsModel retirement Stops workingin 11 days
  5. gemini-3.1-flash-live-previewModel retirement Stops workingin 11 days
  6. gemini-3.1-flash-tts-previewModel retirement Stops workingin 11 days
  7. gemini-2.5-flashModel retirement Redirectsin 25 days
  8. gemini-2.5-proModel retirement Redirectsin 25 days
  9. gemini-omni-1.1-flashModel retirement Stops workingin 27 days
  10. gemini-3.1-flash-liteModel retirement Stops workingin 182 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 March 15, 2027.

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.