Okapi Okapi

Vertex AI gemini-2.5-flash-image model retirement

Stops workingin 129 daysSubscribe to Vertex AIShare

On March 15, 2027, the gemini-2.5-flash-image model will be retired. Calls using model gemini-2.5-flash-image will fail after this date.


The error you get from March 15, 2027

What Vertex AI answers a call to gemini-2.5-flash-image once the model is gone, as recorded from real responses:

HTTP 404
{"error":{"code":404,"message":"Publisher model `projects/{project}/locations/{region}/publishers/google/models/gemini-2.5-flash-image` was not found or your project does not have access to it. Ensure you are using a valid model name and that the model is available in the specified region.","status":"NOT_FOUND"}}

What to use instead of gemini-2.5-flash-image

Move to gemini-3.1-flash-lite-image, recommended by Google.

In Vertex AI's words

Model ID: gemini-2.5-flash-image; Release date: October 2, 2025; Retirement date: March 15, 2027; Replacement model ID: gemini-3.1-flash-lite-image

Vertex AI, Deprecations page

Facts

API
Vertex AI aiplatform.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 Vertex AI's own pages

Questions

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

Calls to the model gemini-2.5-flash-image on Vertex AI 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?

Vertex AI answers HTTP 404: "Publisher model `projects/{project}/locations/{region}/publishers/google/models/gemini-2.5-flash-image` was not found or your project does not have access to it. Ensure you are using a valid model name and that the model is available in the specified region.". 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. Gemini API 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 Vertex AI 10

  1. claude-sonnet-4-5Model retirement Stops workingin 24 days
  2. gemini-live-2.5-flash-native-audioModel retirement Stops workingin 37 days
  3. gemini-3.7-flashModel retirement Stops workingin 83 days
  4. /v1/projects/{id}/locations/{id}/featurestores*Endpoint removal Stops workingin 103 days
  5. /v1beta1/projects/{id}/locations/{id}/featurestores*Endpoint removal Stops workingin 103 days
  6. POST /v1/projects/{id}/locations/{id}/endpoints/{id}:explainEndpoint removal Stops workingin 130 days
  7. POST /v1beta1/projects/{id}/locations/{id}/endpoints/{id}:explainEndpoint removal Stops workingin 130 days
  8. text-embedding-004Model retirement Stops workingin 146 days
  9. text-embedding-005Model retirement Stops workingin 146 days
  10. text-multilingual-embedding-002Model retirement Stops workingin 146 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 Vertex AI

Hear about each breaking change Vertex AI announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • Vertex AI

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.