OpenAI
gpt-5-mini model retirement
Stops workingSubscribe to OpenAIShare
On December 11, 2026, OpenAI will shut down the model gpt-5-mini. After that day, requests using model gpt-5-mini will fail.
The error you get from December 11, 2026
What OpenAI answers a call to gpt-5-mini once the model is gone, as recorded from real responses:
{"error":{"message":"The model `gpt-5-mini` has been deprecated, learn more here: https://platform.openai.com/docs/deprecations","type":"invalid_request_error","param":null,"code":"model_not_found"}}What to use instead of gpt-5-mini
Move to gpt-5.6-terra, which OpenAI recommends as the replacement.
In OpenAI's words
Shutdown date: Dec 11, 2026; Model / system: gpt-5-mini | gpt-5-mini-2025-08-07; Recommended replacement: gpt-5.6-terra
Facts
- API
- OpenAI
api.openai.com - Model
gpt-5-mini- Released
- August 7, 2025 (models.dev)
- Kind
- Model retirement
- Takes effect
- December 11, 2026
- Calls after that day
- Fail
- Source
- Deprecations page
- Last updated
- Verified
- , against OpenAI's own pages
Questions
When does gpt-5-mini shut down?
Calls to the model gpt-5-mini on OpenAI stop working on December 11, 2026.
What happens to calls after December 11, 2026?
They fail from that day.
What error does gpt-5-mini return once it is shut down?
OpenAI answers HTTP 404: "The model `gpt-5-mini` has been deprecated, learn more here: https://platform.openai.com/docs/deprecations". Send another model to fix it.
When was gpt-5-mini released?
gpt-5-mini was released on August 7, 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.
gpt-5-mini on other APIs 2
-
Lovable AI Gateway
openai/gpt-5-miniModel retirement Redirectsin 35 days -
Azure AI Foundry
gpt-5-miniModel retirement Stops workingin 249 days
More from OpenAI 10
-
gpt-5Model retirement Stops workingin 35 days -
gpt-5-2025-08-07Model retirement Stops workingin 35 days -
gpt-5-mini-2025-08-07Model retirement Stops workingin 35 days -
gpt-5-nanoModel retirement Stops workingin 35 days -
gpt-5-nano-2025-08-07Model retirement Stops workingin 35 days -
gpt-5-proModel retirement Stops workingin 35 days -
gpt-5-pro-2025-10-06Model retirement Stops workingin 35 days -
o3Model retirement Stops workingin 35 days -
o3-2025-04-16Model retirement Stops workingin 35 days -
o3-proModel retirement Stops workingin 35 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 December 11, 2026.