deprecations.md +86 −72
135To improve reliability and make it easier for developers to choose the right models, we are deprecating a set of older OpenAI models. Access to these models will be shut down on the dates below.135To improve reliability and make it easier for developers to choose the right models, we are deprecating a set of older OpenAI models. Access to these models will be shut down on the dates below.
136 136
137| Shutdown date | Model snapshot | Substitute model |137| Shutdown date | Model snapshot | Substitute model |
138138| ------------- | ---------------------------------------------------------------------- | ------------------------------------- || ---------------- | ---------------------------------------------------------------------- | ------------------------------------- |
139| October 23, 2026 | `gpt-3.5-turbo-0125` \| `gpt-3.5-turbo`, `gpt-3.5-turbo-completions` | `gpt-5.6-terra` |
140| October 23, 2026 | `gpt-4-0613` \| `gpt-4`, `gpt-4-0613-completions`, `gpt-4-completions` | `gpt-5.6-sol` |
141| October 23, 2026 | `gpt-4-1106-preview` | `gpt-5.6-sol` |
142| October 23, 2026 | `gpt-4-turbo` \| `gpt-4-turbo-2024-04-09`, `gpt-4-turbo-completions` | `gpt-5.6-sol` |
143| October 23, 2026 | `gpt-4.1-nano` \| `gpt-4.1-nano-2025-04-14` | `gpt-5.6-luna` |
144| October 23, 2026 | `gpt-4o-2024-05-13` | `gpt-5.6-sol` |
145| October 23, 2026 | `gpt-image-1` | `gpt-image-2` |
146| October 23, 2026 | `o1-2024-12-17` \| `o1` | `gpt-5.6-sol` |
147| October 23, 2026 | `o1-pro-2025-03-19` \| `o1-pro` | `gpt-5.6-sol` (`reasoning.mode: pro`) |
148| October 23, 2026 | `o3-mini-2025-01-31` \| `o3-mini` | `gpt-5.6-sol` |
149| October 23, 2026 | `ft-o4-mini-2025-04-16` | `gpt-5.6-terra` |
150| October 23, 2026 | `o4-mini-2025-04-16` \| `o4-mini` | `gpt-5.6-terra` |
151
152We are also removing fine-tuned versions as below:
153
154| Shutdown date | Model snapshot | Recommended replacement base model |
155| ---------------- | ---------------------------- | ---------------------------------- |
156| October 23, 2026 | `ft-gpt-3.5-turbo` | `gpt-5.4-mini` |
157| October 23, 2026 | `ft-gpt-4` | `gpt-5.5` |
158| October 23, 2026 | `ft-gpt-4.1-nano-2025-04-14` | `gpt-5.4-nano` |
159| October 23, 2026 | `ft-babbage-002` | `gpt-5.4-mini` |
160| October 23, 2026 | `ft-davinci-002` | `gpt-5.4-mini` |
161
162### 2026-03-24: Sora 2 video generation models and Videos API
163
164On March 24th, 2026, we notified developers using the Videos API and Sora 2 video generation model aliases and snapshots of their deprecation and removal from the API on September 24, 2026.
165
166| Shutdown date | Model / system | Recommended replacement |
167| ------------- | ----------------------- | ----------------------- |
168| 2026-09-24 | Videos API | --- |
169| 2026-09-24 | `sora-2` | --- |
170| 2026-09-24 | `sora-2-pro` | --- |
171| 2026-09-24 | `sora-2-2025-10-06` | --- |
172| 2026-09-24 | `sora-2-2025-12-08` | --- |
173| 2026-09-24 | `sora-2-pro-2025-10-06` | --- |
174
175### 2025-09-26: Legacy GPT model snapshots
176
177To improve reliability and make it easier for developers to choose the right models, we are deprecating a set of older OpenAI models with declining usage over the next six to twelve months. Access to these models will be shut down on the dates below.
178
179| Shutdown date | Model / system | Recommended replacement |
180| ------------- | ------------------------ | ------------------------------ |
181| 2026-09-28 | `gpt-3.5-turbo-instruct` | `gpt-5.4-mini` or `gpt-5-mini` |
182| 2026-09-28 | `babbage-002` | `gpt-5.4-mini` or `gpt-5-mini` |
183| 2026-09-28 | `davinci-002` | `gpt-5.4-mini` or `gpt-5-mini` |
184| 2026-09-28 | `gpt-3.5-turbo-1106` | `gpt-5.4-mini` or `gpt-5-mini` |
185
186### 2025-08-20: Assistants API
187
188On August 26th, 2025, we notified developers using the Assistants API of its deprecation and removal from the API one year later, on August 26, 2026.
189
190When we released the [Responses API](https://developers.openai.com/api/reference/resources/responses/methods/create) in [March 2025](https://developers.openai.com/api/docs/changelog), we announced plans to bring all Assistants API features to the easier to use Responses API, with a sunset date in 2026.
191
192See the Assistants to Conversations [migration guide](https://developers.openai.com/api/docs/assistants/migration) to learn more about how to migrate your current integration to the Responses API and Conversations API.
193
194| Shutdown date | Model / system | Recommended replacement |
195| ------------- | -------------- | ----------------------------------- |
196| 2026‑08‑26 | Assistants API | Responses API and Conversations API |
197
198## Past deprecations
199
200Past deprecations are listed below, with the most recent announcements at the top.
201
202### 2026-04-22: Legacy GPT model snapshots (July 2026 shutdown)
203
204On April 22, 2026, we announced the deprecation of the following older OpenAI models. Access to these models was shut down on July 23, 2026.
205
206| Shutdown date | Model snapshot | Substitute model |
207| ------------- | ------------------------------------------------------------- | ---------------------------- |
139| July 23, 2026 | `computer-use-preview-2025-03-11` \| `computer-use-preview` | `gpt-5.6-terra` |208| July 23, 2026 | `computer-use-preview-2025-03-11` \| `computer-use-preview` | `gpt-5.6-terra` |
140| July 23, 2026 | `gpt-4o-mini-search-preview-2025-03-11` | `gpt-5.6-terra` |209| July 23, 2026 | `gpt-4o-mini-search-preview-2025-03-11` | `gpt-5.6-terra` |
141| July 23, 2026 | `gpt-4o-mini-tts-2025-03-20` | `gpt-4o-mini-tts-2025-12-15` |210| July 23, 2026 | `gpt-4o-mini-tts-2025-03-20` | `gpt-4o-mini-tts-2025-12-15` |
151| July 23, 2026 | `o3-deep-research-2025-06-26` \| `o3-deep-research` | `gpt-5.6-sol` |220| July 23, 2026 | `o3-deep-research-2025-06-26` \| `o3-deep-research` | `gpt-5.6-sol` |
152| July 23, 2026 | `o4-mini-deep-research-2025-06-26` \| `o4-mini-deep-research` | `gpt-5.6-sol` |221| July 23, 2026 | `o4-mini-deep-research-2025-06-26` \| `o4-mini-deep-research` | `gpt-5.6-sol` |
153| July 23, 2026 | `gpt-5.2-codex` | `gpt-5.6-sol` |222| July 23, 2026 | `gpt-5.2-codex` | `gpt-5.6-sol` |
154| 2026-10-23 | `gpt-3.5-turbo-0125` \| `gpt-3.5-turbo`, `gpt-3.5-turbo-completions` | `gpt-5.6-terra` |
155| 2026-10-23 | `gpt-4-0613` \| `gpt-4`, `gpt-4-0613-completions`, `gpt-4-completions` | `gpt-5.6-sol` |
156| 2026-10-23 | `gpt-4-1106-preview` | `gpt-5.6-sol` |
157| 2026-10-23 | `gpt-4-turbo` \| `gpt-4-turbo-2024-04-09`, `gpt-4-turbo-completions` | `gpt-5.6-sol` |
158| 2026-10-23 | `gpt-4.1-nano` \| `gpt-4.1-nano-2025-04-14` | `gpt-5.6-luna` |
159| 2026-10-23 | `gpt-4o-2024-05-13` | `gpt-5.6-sol` |
160| 2026-10-23 | `gpt-image-1` | `gpt-image-2` |
161| 2026-10-23 | `o1-2024-12-17` \| `o1` | `gpt-5.6-sol` |
162| 2026-10-23 | `o1-pro-2025-03-19` \| `o1-pro` | `gpt-5.6-sol` (`reasoning.mode: pro`) |
163| 2026-10-23 | `o3-mini-2025-01-31` \| `o3-mini` | `gpt-5.6-sol` |
164| 2026-10-23 | `ft-o4-mini-2025-04-16` | `gpt-5.6-terra` |
165| 2026-10-23 | `o4-mini-2025-04-16` \| `o4-mini` | `gpt-5.6-terra` |
166 223
167224We are also removing fine-tuned versions as below:### 2025-11-18: chatgpt-4o-latest snapshot
168 225
169226| Shutdown date | Model snapshot | Recommended replacement base model |On November 18th, 2025, we notified developers using `chatgpt-4o-latest` model snapshot of its deprecation and removal from the API on February 17, 2026.
170| ------------- | ---------------------------- | ---------------------------------- |
171| 2026-10-23 | `ft-gpt-3.5-turbo` | `gpt-5.4-mini` |
172| 2026-10-23 | `ft-gpt-4` | `gpt-5.5` |
173| 2026-10-23 | `ft-gpt-4.1-nano-2025-04-14` | `gpt-5.4-nano` |
174| 2026-10-23 | `ft-babbage-002` | `gpt-5.4-mini` |
175| 2026-10-23 | `ft-davinci-002` | `gpt-5.4-mini` |
176 227
177228### 2026-03-24: Sora 2 video generation models and Videos API| Shutdown date | Model / system | Recommended replacement |
229| ------------- | ------------------- | ----------------------- |
230| 2026-02-17 | `chatgpt-4o-latest` | `gpt-5.1-chat-latest` |
178 231
179232On March 24th, 2026, we notified developers using the Videos API and Sora 2 video generation model aliases and snapshots of their deprecation and removal from the API on September 24, 2026.### 2025-11-17: codex-mini-latest model snapshot
233
234On November 17th, 2025, we notified developers using `codex-mini-latest` model of its deprecation and removal from the API on February 12, 2026. As part of this deprecation, we will no longer support our legacy local shell tool, which is only available for use with `codex-mini-latest`. For new use cases, please use our latest shell tool.
180 235
181| Shutdown date | Model / system | Recommended replacement |236| Shutdown date | Model / system | Recommended replacement |
182237| ------------- | ----------------------- | ----------------------- || ------------- | ------------------- | ----------------------- |
183238| 2026-09-24 | Videos API | --- || 2026-02-12 | `codex-mini-latest` | `gpt-5-codex-mini` |
184| 2026-09-24 | `sora-2` | --- |
185| 2026-09-24 | `sora-2-pro` | --- |
186| 2026-09-24 | `sora-2-2025-10-06` | --- |
187| 2026-09-24 | `sora-2-2025-12-08` | --- |
188| 2026-09-24 | `sora-2-pro-2025-10-06` | --- |
189 239
190### 2025-11-14: DALL·E model snapshots240### 2025-11-14: DALL·E model snapshots
191 241
196| 2026-05-12 | `dall-e-2` | `gpt-image-2`, `gpt-image-1`, or `gpt-image-1-mini` |246| 2026-05-12 | `dall-e-2` | `gpt-image-2`, `gpt-image-1`, or `gpt-image-1-mini` |
197| 2026-05-12 | `dall-e-3` | `gpt-image-2`, `gpt-image-1`, or `gpt-image-1-mini` |247| 2026-05-12 | `dall-e-3` | `gpt-image-2`, `gpt-image-1`, or `gpt-image-1-mini` |
198 248
199249### 2025-09-26: Legacy GPT model snapshots### 2025-09-26: Legacy GPT model snapshots (March 2026 shutdown)
200 250
201251To improve reliability and make it easier for developers to choose the right models, we are deprecating a set of older OpenAI models with declining usage over the next six to twelve months. Access to these models will be shut down on the dates below.To improve reliability and make it easier for developers to choose the right models, we deprecated a set of older OpenAI models with declining usage. Access to these models was shut down on March 26, 2026.
202 252
203| Shutdown date | Model / system | Recommended replacement |253| Shutdown date | Model / system | Recommended replacement |
204254| ------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------ || ------------- | -------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
205| 2026‑03‑26 | `gpt-4-0314` | `gpt-5` or `gpt-4.1*` |255| 2026‑03‑26 | `gpt-4-0314` | `gpt-5` or `gpt-4.1*` |
206| 2026‑03‑26 | `gpt-4-1106-preview` | `gpt-5` or `gpt-4.1*` |256| 2026‑03‑26 | `gpt-4-1106-preview` | `gpt-5` or `gpt-4.1*` |
207| 2026‑03‑26 | `gpt-4-0125-preview` (including `gpt-4-turbo-preview` and `gpt-4-turbo-preview-completions`, which point to this snapshot) | `gpt-5` or `gpt-4.1*` |257| 2026‑03‑26 | `gpt-4-0125-preview` (including `gpt-4-turbo-preview` and `gpt-4-turbo-preview-completions`, which point to this snapshot) | `gpt-5` or `gpt-4.1*` |
208| 2026-09-28 | `gpt-3.5-turbo-instruct` | `gpt-5.4-mini` or `gpt-5-mini` |
209| 2026-09-28 | `babbage-002` | `gpt-5.4-mini` or `gpt-5-mini` |
210| 2026-09-28 | `davinci-002` | `gpt-5.4-mini` or `gpt-5-mini` |
211| 2026-09-28 | `gpt-3.5-turbo-1106` | `gpt-5.4-mini` or `gpt-5-mini` |
212 258
213\*For tasks that are especially latency sensitive and don't require reasoning259\*For tasks that are especially latency sensitive and don't require reasoning
214 260
222| ------------- | ------------------------ | ----------------------- |268| ------------- | ------------------------ | ----------------------- |
223| 2026‑05‑12 | OpenAI-Beta: realtime=v1 | Realtime API |269| 2026‑05‑12 | OpenAI-Beta: realtime=v1 | Realtime API |
224 270
225### 2025-08-20: Assistants API
226
227On August 26th, 2025, we notified developers using the Assistants API of its deprecation and removal from the API one year later, on August 26, 2026.
228
229When we released the [Responses API](https://developers.openai.com/api/reference/resources/responses/methods/create) in [March 2025](https://developers.openai.com/api/docs/changelog), we announced plans to bring all Assistants API features to the easier to use Responses API, with a sunset date in 2026.
230
231See the Assistants to Conversations [migration guide](https://developers.openai.com/api/docs/assistants/migration) to learn more about how to migrate your current integration to the Responses API and Conversations API.
232
233| Shutdown date | Model / system | Recommended replacement |
234| ------------- | -------------- | ----------------------------------- |
235| 2026‑08‑26 | Assistants API | Responses API and Conversations API |
236
237### 2025-09-15: gpt-4o-realtime-preview models271### 2025-09-15: gpt-4o-realtime-preview models
238 272
239In September, 2025, we notified developers using gpt-4o-realtime-preview models of their deprecation and removal from the API in six months.273In September, 2025, we notified developers using gpt-4o-realtime-preview models of their deprecation and removal from the API in six months.
247| 2026-05-07 | gpt-4o-audio-preview | gpt-audio-1.5 |281| 2026-05-07 | gpt-4o-audio-preview | gpt-audio-1.5 |
248| 2026-05-07 | gpt-4o-mini-audio-preview | gpt-audio-mini |282| 2026-05-07 | gpt-4o-mini-audio-preview | gpt-audio-mini |
249 283
250## Past deprecations
251
252Past deprecations are listed below, with the most recent announcements at the top.
253
254### 2025-11-18: chatgpt-4o-latest snapshot
255
256On November 18th, 2025, we notified developers using `chatgpt-4o-latest` model snapshot of its deprecation and removal from the API on February 17, 2026.
257
258| Shutdown date | Model / system | Recommended replacement |
259| ------------- | ------------------- | ----------------------- |
260| 2026-02-17 | `chatgpt-4o-latest` | `gpt-5.1-chat-latest` |
261
262### 2025-11-17: codex-mini-latest model snapshot
263
264On November 17th, 2025, we notified developers using `codex-mini-latest` model of its deprecation and removal from the API on February 12, 2026. As part of this deprecation, we will no longer support our legacy local shell tool, which is only available for use with `codex-mini-latest`. For new use cases, please use our latest shell tool.
265
266| Shutdown date | Model / system | Recommended replacement |
267| ------------- | ------------------- | ----------------------- |
268| 2026-02-12 | `codex-mini-latest` | `gpt-5-codex-mini` |
269
270### 2025-06-10: gpt-4o-realtime-preview-2024-10-01284### 2025-06-10: gpt-4o-realtime-preview-2024-10-01
271 285
272On June 10th, 2025, we notified developers using gpt-4o-realtime-preview-2024-10-01 of its deprecation and removal from the API in three months.286On June 10th, 2025, we notified developers using gpt-4o-realtime-preview-2024-10-01 of its deprecation and removal from the API in three months.
464 478
465### Plain-text aliases479### Plain-text aliases
466 480
467- computer-use-preview-2025-03-11 | computer-use-preview
468- o3-deep-research-2025-06-26 | o3-deep-research
469- o4-mini-deep-research-2025-06-26 | o4-mini-deep-research
470- gpt-3.5-turbo-0125 | gpt-3.5-turbo, gpt-3.5-turbo-completions481- gpt-3.5-turbo-0125 | gpt-3.5-turbo, gpt-3.5-turbo-completions
471- gpt-4-0613 | gpt-4, gpt-4-0613-completions, gpt-4-completions482- gpt-4-0613 | gpt-4, gpt-4-0613-completions, gpt-4-completions
472- gpt-4-turbo | gpt-4-turbo-2024-04-09, gpt-4-turbo-completions483- gpt-4-turbo | gpt-4-turbo-2024-04-09, gpt-4-turbo-completions
475- o1-pro-2025-03-19 | o1-pro486- o1-pro-2025-03-19 | o1-pro
476- o3-mini-2025-01-31 | o3-mini487- o3-mini-2025-01-31 | o3-mini
477- o4-mini-2025-04-16 | o4-mini488- o4-mini-2025-04-16 | o4-mini
489- computer-use-preview-2025-03-11 | computer-use-preview
490- o3-deep-research-2025-06-26 | o3-deep-research
491- o4-mini-deep-research-2025-06-26 | o4-mini-deep-research