Okapi Okapi

gemini-2.5-flash-preview-tts model retirement

Stops workingin 11 daysSubscribe to Gemini APIShare

On November 17, 2026, the model gemini-2.5-flash-preview-tts will be shut down. Any calls directed to this model will fail after that date.


The error you get from November 17, 2026

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

Move to gemini-3.8-flash-tts or gemini-3.8-flash-lite-tts, which are recommended by Google.

In Gemini API's words

Model: gemini-2.5-flash-preview-tts; Release date: May 20, 2025; Shutdown date: November 17, 2026; Recommended replacement: gemini-3.8-flash-tts or gemini-3.8-flash-lite-tts

Gemini API, Deprecations page

Facts

API
Gemini API generativelanguage.googleapis.com
Model
gemini-2.5-flash-preview-tts
Released
May 1, 2025 (models.dev)
Kind
Model retirement
Takes effect
November 17, 2026
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-tts shut down?

Calls to the model gemini-2.5-flash-preview-tts stop working on November 17, 2026.

What happens to calls after November 17, 2026?

They fail from that day.

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

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

gemini-2.5-flash-preview-tts was released on May 1, 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.


More from Gemini API 10

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

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.