OpenAI
gpt-4o-mini-tts-2025-03-20 model retirement
Stops workingSubscribe to OpenAIShare
On January 6, 2027, model gpt-4o-mini-tts-2025-03-20 will shut down. Requests that use this model will fail after that date. The change affects any integration calling model gpt-4o-mini-tts-2025-03-20.
The error you get from January 6, 2027
What OpenAI answers a call to gpt-4o-mini-tts-2025-03-20 once the model is gone, as recorded from real responses:
{"error":{"message":"The model `gpt-4o-mini-tts-2025-03-20` 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-4o-mini-tts-2025-03-20
Move to the recommended replacement gpt-realtime-2.1-mini. This transition requires more than updating the model identifier, as gpt-realtime-2.1-mini is not served on /v1/audio/speech and runs only on the Realtime API at /v1/realtime over WebRTC or WebSocket. Audio is returned as base64 chunks in response.output_audio.delta events rather than as an mp3 or wav response body.
gpt-realtime-2.1-mini is not served on /v1/audio/speech: it runs only on the Realtime API (/v1/realtime, over WebRTC or WebSocket). Audio comes back as base64 chunks in response.output_audio.delta events (for example audio/pcm at 24 kHz), not as an mp3 or wav response body.
In OpenAI's words
Shutdown date: Jan 6, 2027; Model / system: gpt-4o-mini-tts | gpt-4o-mini-tts-2025-03-20; Recommended replacement: gpt-realtime-2.1-mini
Facts
- API
- OpenAI
api.openai.com - Model
gpt-4o-mini-tts-2025-03-20- Kind
- Model retirement
- Takes effect
- January 6, 2027
- Calls after that day
- Fail
- Source
- Deprecations page
- Last updated
- Verified
- , against OpenAI's own pages
Questions
When does gpt-4o-mini-tts-2025-03-20 shut down?
Calls to the model gpt-4o-mini-tts-2025-03-20 on OpenAI stop working on January 6, 2027.
What happens to calls after January 6, 2027?
They fail from that day.
What error does gpt-4o-mini-tts-2025-03-20 return once it is shut down?
OpenAI answers HTTP 404: "The model `gpt-4o-mini-tts-2025-03-20` has been deprecated, learn more here: https://platform.openai.com/docs/deprecations". Send another model to fix it.
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 OpenAI 10
-
gpt-4o-mini-ttsModel retirement Stops workingin 61 days -
gpt-4o-mini-tts-2025-12-15Model retirement Stops workingin 61 days -
tts-1Model retirement Stops workingin 61 days -
tts-1-hdModel retirement Stops workingin 61 days -
gpt-4.1Model retirement Stops workingin 69 days -
gpt-4.1-2025-04-14Model retirement Stops workingin 69 days -
gpt-4.1-miniModel retirement Stops workingin 69 days -
gpt-4.1-mini-2025-04-14Model retirement Stops workingin 69 days -
gpt-4oModel retirement Stops workingin 69 days -
gpt-4o-2024-08-06Model retirement Stops workingin 69 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 January 6, 2027.