OpenAI
o4-mini model retirement
Stopped workingSubscribe to OpenAIShare
On October 23, 2026, the o4-mini model was retired. Requests targeting model o4-mini fail since that day. This shutdown also affected the o4-mini-2025-04-16 snapshot.
The error you get
What OpenAI answers a call to o4-mini once the model is gone, as recorded from real responses:
{"error":{"message":"The model `o4-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 o4-mini
Move to gpt-5.6-terra, which is recommended by OpenAI as the substitute model.
In OpenAI's words
Shutdown date: October 23, 2026; Model snapshot: o4-mini-2025-04-16 | o4-mini; Substitute model: gpt-5.6-terra
Facts
- API
- OpenAI
api.openai.com - Model
o4-mini- Released
- April 16, 2025 (models.dev)
- Kind
- Model retirement
- Takes effect
- October 23, 2026
- Calls after that day
- Fail
- Source
- Deprecations page
- Last updated
- Verified
- , against OpenAI's own pages
Questions
When does o4-mini shut down?
Calls to the model o4-mini on OpenAI stopped working on October 23, 2026.
What happens to calls after October 23, 2026?
They have failed since October 23, 2026.
What error does o4-mini return once it is shut down?
OpenAI answers HTTP 404: "The model `o4-mini` has been deprecated, learn more here: https://platform.openai.com/docs/deprecations". Send another model to fix it.
When was o4-mini released?
o4-mini was released on April 16, 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.
o4-mini on other APIs 2
-
Azure AI Foundry
o4-miniModel retirement Stops workingin 13 days -
Azure OpenAI
o4-miniModel retirement Stops workingin 344 days
More from OpenAI 10
-
ft-babbage-002Model retirement Stopped working -
ft-davinci-002Model retirement Stopped working -
ft-gpt-3.5-turboModel retirement Stopped working -
ft-gpt-4Model retirement Stopped working -
ft-gpt-4.1-nanoModel retirement Stopped working -
ft-gpt-4.1-nano-2025-04-14Model retirement Stopped working -
ft-o4-miniModel retirement Stopped working -
ft-o4-mini-2025-04-16Model retirement Stopped working -
gpt-3.5-turboModel retirement Stopped working -
gpt-3.5-turbo-0125Model 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.