Skip to content

Commit a7f0797

Browse files
denreadenrea
authored
Merge pull request #268080 from gojira/keijik/0227-model-retirements
Add model retirements page
2 parents 8fc4971 + ce9d58a commit a7f0797

File tree

3 files changed

+136
-2
lines changed

3 files changed

+136
-2
lines changed

‎articles/ai-services/openai/concepts/model-retirements.md

Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
---
2+
title: Azure OpenAI Service model retirements
3+
titleSuffix: Azure OpenAI
4+
description: Learn about the model deprecations and retirements in Azure OpenAI.
5+
ms.service: azure-ai-openai
6+
ms.topic: conceptual
7+
ms.date: 03/13/2024
8+
ms.custom:
9+
manager: nitinme
10+
author: mrbullwinkle
11+
ms.author: mbullwin
12+
recommendations: false
13+
---
14+
15+
# Azure OpenAI Service model deprecations and retirements
16+
17+
## Overview
18+
19+
Azure OpenAI Service models are continually refreshed with newer and more capable models. As part of this process, we deprecate and retire older models. This document provides information about the models that are currently available, deprecated, and retired.
20+
21+
### Terminology
22+
23+
* Retirement
24+
* When a model is retired, it's no longer available for use. Azure OpenAI Service deployments of a retired model always return error responses.
25+
* Deprecation
26+
* When a model is deprecated, it's no longer available for new customers. It continues to be available for use by customers with existing deployments until the model is retired.
27+
28+
## Preretirement notification
29+
30+
Azure OpenAI notifies customers of active Azure OpenAI Service deployments for models with upcoming retirements. We notify customers of upcoming retirements as follows for each deployment:
31+
32+
* At least 60 days before retirement
33+
* At least 30 days before retirement
34+
* At retirement
35+
36+
Retirements are done on a rolling basis, region by region.
37+
38+
### Who is notified of upcoming retirements
39+
40+
Azure OpenAI notifies those who are members of the following roles for each subscription with a deployment of a model with an upcoming retirement.
41+
42+
* Owner
43+
* Contributor
44+
* Reader
45+
* Monitoring contributor
46+
* Monitoring reader
47+
48+
## How to get ready for model retirements and version upgrades
49+
50+
To prepare for model retirements and version upgrades, we recommend that customers evaluate their applications with the new models and versions and evaluate their behavior. We also recommend that customers update their applications to use the new models and versions before the retirement date.
51+
52+
For more information, see [How to upgrade to a new model or version](./model-versions.md).
53+
54+
## Current models
55+
56+
These models are currently available for use in Azure OpenAI Service.
57+
58+
| Model | Version | Retirement date |
59+
| ---- | ---- | ---- |
60+
| `gpt-35-turbo` | 0301 | No earlier than June 13, 2024 |
61+
| `gpt-35-turbo`<br>`gpt-35-turbo-16k` | 0613 | No earlier than July 13, 2024 |
62+
| `gpt-35-turbo` | 1106 | No earlier than Nov 17, 2025 |
63+
| `gpt-35-turbo` | 0125 | No earlier than Feb 22, 2025 |
64+
| `gpt-4`<br>`gpt-4-32k` | 0314 | No earlier than July 13, 2024 |
65+
| `gpt-4`<br>`gpt-4-32k` | 0613 | No earlier than Sep 30, 2024 |
66+
| `gpt-4` | 1106-preview | To be upgraded to a stable version with date to be announced |
67+
| `gpt-4` | 0125-preview | To be upgraded to a stable version with date to be announced |
68+
| `gpt-4` | vision-preview | To be upgraded to a stable version with date to be announced |
69+
| `gpt-3.5-turbo-instruct` | 0914 | No earlier than Sep 14, 2025 |
70+
| `text-embedding-ada-002` | 2 | No earlier than April 3, 2025 |
71+
| `text-embedding-ada-002` | 1 | No earlier than April 3, 2025 |
72+
| `text-embedding-3-small` | | No earlier than Feb 2, 2025 |
73+
| `text-embedding-3-large` | | No earlier than Feb 2, 2025 |
74+
75+
76+
## Deprecated models
77+
78+
These models were deprecated on July 6, 2023 and will be retired on July 5, 2024. These models are no longer available for new deployments. Deployments created before July 6, 2023 remain available to customers until July 5, 2024. We recommend customers migrate their applications to deployments of replacement models before the July 5, 2024 retirement.
79+
80+
If you're an existing customer looking for information about these models, see [Legacy models](./legacy-models.md).
81+
82+
| Model | Deprecation date | Retirement date | Suggested replacement |
83+
| --------- | --------------------- | ------------------- | -------------------- |
84+
| ada | July 6, 2023 | July 5, 2024 | babbage-002 |
85+
| babbage | July 6, 2023 | July 5, 2024 | babbage-002 |
86+
| curie | July 6, 2023 | July 5, 2024 | davinci-002 |
87+
| davinci | July 6, 2023 | July 5, 2024 | davinci-002 |
88+
| text-ada-001 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
89+
| text-babbage-001 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
90+
| text-curie-001 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
91+
| text-davinci-002 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
92+
| text-davinci-003 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
93+
| code-cushman-001 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
94+
| code-davinci-002 | July 6, 2023 | July 5, 2024 | gpt-35-turbo-instruct |
95+
| text-similarity-ada-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
96+
| text-similarity-babbage-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
97+
| text-similarity-curie-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
98+
| text-similarity-davinci-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
99+
| text-search-ada-doc-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
100+
| text-search-ada-query-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
101+
| text-search-babbage-doc-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
102+
| text-search-babbage-query-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
103+
| text-search-curie-doc-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
104+
| text-search-curie-query-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
105+
| text-search-davinci-doc-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
106+
| text-search-davinci-query-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
107+
| code-search-ada-code-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
108+
| code-search-ada-text-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
109+
| code-search-babbage-code-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
110+
| code-search-babbage-text-001 | July 6, 2023 | July 5, 2024 | text-embedding-3-small |
111+
112+
## Retirement and deprecation history
113+
114+
### March 13, 2024
115+
116+
We published this document to provide information about the current models, deprecated models, and upcoming retirements.
117+
118+
### February 23, 2024
119+
120+
We announced the upcoming in-place upgrade of `gpt-4` version `1106-preview` to `0125-preview` to start no earlier than March 8, 2024.
121+
122+
### November 30, 2023
123+
124+
The default version of `gpt-4` and `gpt-3-32k` was updated from `0314` to `0613` starting on November 30, 2023. The upgrade of `0314` deployments set for autoupgrade to `0613` was completed on December 3, 2023.
125+
126+
### July 6, 2023
127+
128+
We announced the deprecation of models with upcoming retirement on July 5, 2024.

‎articles/ai-services/openai/toc.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,8 @@ items:
1010
href: quotas-limits.md
1111
- name: Models
1212
href: ./concepts/models.md
13-
- name: Legacy models
14-
href: ./concepts/legacy-models.md
13+
- name: Model retirements
14+
href: ./concepts/model-retirements.md
1515
- name: Pricing
1616
href: https://azure.microsoft.com/pricing/details/cognitive-services/openai-service/
1717
- name: What's new
@@ -74,6 +74,8 @@ items:
7474
href: ./concepts/use-your-data.md
7575
- name: Using your data - image (preview)
7676
href: ./concepts/use-your-image-data.md
77+
- name: Legacy models
78+
href: ./concepts/legacy-models.md
7779
- name: How-to
7880
items:
7981
- name: API version lifecycle

‎articles/ai-services/openai/whats-new.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,10 @@ recommendations: false
1818

1919
## March 2024
2020

21+
### Model deprecations and retirements
22+
23+
We have added a page to track [model deprecations and retirements](./concepts/model-retirements.md) in Azure OpenAI Service. This page provides information about the models that are currently available, deprecated, and retired.
24+
2125
### 2024-03-01-preview API released
2226

2327
`2024-03-01-preview` has all the same functionality as `2024-02-15-preview` and adds two new parameters for embeddings:

0 commit comments

Comments
 (0)