Okapi Okapi

Vertex AI gemini-2.5-flash-lite model retirement

Stopped workingSubscribe to Vertex AIShare

Vertex AI retired model gemini-2.5-flash-lite on October 20, 2026. Calls to model gemini-2.5-flash-lite fail since that date.


The error you get

What Vertex AI answers a call to gemini-2.5-flash-lite 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-lite` 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-lite

Move to gemini-3.8-flash, gemini-3.5-flash-lite, or Gemma 4, as recommended by Google.

In Vertex AI's words

Model ID: gemini-2.5-flash-lite; Release date: July 22, 2025; Retirement date: October 20, 2026; Replacement model ID: gemini-3.8-flash or gemini-3.5-flash-lite or Gemma 4

Vertex AI, Deprecations page

Facts

API
Vertex AI aiplatform.googleapis.com
Model
gemini-2.5-flash-lite
Released
June 17, 2025 (models.dev)
Kind
Model retirement
Takes effect
October 20, 2026
Calls after that day
Fail
Source
Deprecations page
Last updated
Verified
, against Vertex AI's own pages

Questions

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

Calls to the model gemini-2.5-flash-lite on Vertex AI stopped working on October 20, 2026.

What happens to calls after October 20, 2026?

They have failed since October 20, 2026.

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

Vertex AI answers HTTP 404: "Publisher model `projects/{project}/locations/{region}/publishers/google/models/gemini-2.5-flash-lite` 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-lite released?

gemini-2.5-flash-lite 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-flash-lite on other APIs 3

  1. Lovable AI Gateway google/gemini-2.5-flash-liteModel retirement Redirected
  2. OpenRouter google/gemini-2.5-flash-liteModel retirement Stopped working
  3. No date Llmtr google/gemini-2.5-flash-liteModel retirement Deprecated, no date

More from Vertex AI 10

  1. gemini-2.5-flashModel retirement Stopped working
  2. gemini-2.5-proModel retirement Stopped working
  3. deepseek-ocr-maasModel retirement Stopped working
  4. deepseek-r1-0528-maasModel retirement Stopped working
  5. deepseek-v3.1-maasModel retirement Stopped working
  6. deepseek-v3.2-maasModel retirement Stopped working
  7. glm-4.7-maasModel retirement Stopped working
  8. glm-5-maasModel retirement Stopped working
  9. gpt-oss-20b-maasModel retirement Stopped working
  10. kimi-k2-thinking-maasModel 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 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.