gemini-embedding-001 model retirement
Stops workingSubscribe to Gemini APIShare
On May 14, 2028, Google will shut down model gemini-embedding-001. Calls targeting this model will fail after that day. Developers using this embedding model must transition before the shutdown date.
The error you get from May 14, 2028
What Gemini API answers a call to gemini-embedding-001 once the model is gone, as recorded from real responses:
{"error":{"code":404,"message":"This model models/gemini-embedding-001 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-embedding-001 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-embedding-001
Move to the recommended replacement gemini-embedding-2. The embedding spaces of gemini-embedding-001 and gemini-embedding-2 are incompatible, so you must re-embed all existing data. The task_type parameter is not supported, so put the task directly in the prompt.
Google: the embedding spaces of gemini-embedding-001 and gemini-embedding-2 are incompatible, so you must re-embed all of your existing data. task_type is not supported; put the task in the prompt.
In Gemini API's words
Model: gemini-embedding-001; Release date: July 14, 2025; Shutdown date: May 14, 2028; Recommended replacement: gemini-embedding-2
Facts
- API
- Gemini API
generativelanguage.googleapis.com - Model
gemini-embedding-001- Released
- May 20, 2025 (models.dev)
- Kind
- Model retirement
- Takes effect
- May 14, 2028
- Calls after that day
- Fail
- Source
- Deprecations page
- Last updated
- Verified
- , against Gemini API's own pages
Questions
When does gemini-embedding-001 shut down?
Calls to the model gemini-embedding-001 stop working on May 14, 2028.
What happens to calls after May 14, 2028?
They fail from that day.
What error does gemini-embedding-001 return once it is shut down?
Gemini API answers HTTP 404: "This model models/gemini-embedding-001 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-embedding-001 released?
gemini-embedding-001 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.
More from Gemini API 10
-
gemini-2.5-flash-native-audio-preview-12-2025Model retirement Stops workingin 11 days -
gemini-2.5-flash-preview-ttsModel retirement Stops workingin 11 days -
gemini-2.5-pro-preview-ttsModel retirement Stops workingin 11 days -
gemini-3.1-flash-live-previewModel retirement Stops workingin 11 days -
gemini-3.1-flash-tts-previewModel retirement Stops workingin 11 days -
gemini-2.5-flashModel retirement Redirectsin 25 days -
gemini-2.5-proModel retirement Redirectsin 25 days -
gemini-omni-1.1-flashModel retirement Stops workingin 27 days -
gemini-2.5-flash-imageModel retirement Stops workingin 129 days -
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 May 14, 2028.