You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/ai-foundry/openai/how-to/dotnet-migration.md
+2-3Lines changed: 2 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,15 +7,14 @@ ms.author: mbullwin
7
7
ms.service: azure-ai-openai
8
8
ms.custom: devx-track-dotnet
9
9
ms.topic: how-to
10
-
ms.date: 07/02/2025
10
+
ms.date: 09/30/2025
11
11
manager: nitinme
12
12
---
13
13
14
14
# Migrate from 1.0 beta to 2.0 (`Azure.AI.OpenAI`)
15
15
16
16
> [!NOTE]
17
-
> This guide describes how to migrate an application that previously used a 1.0 beta version of the `Azure.AI.OpenAI` library to use the new 2.0 library.
18
-
> For general guidance on using `OpenAI` and `Azure.AI.OpenAI` features, see [the OpenAI README](https://github.com/openai/openai-dotnet/blob/main/README.md) or [the Azure.AI.OpenAI README](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/openai/Azure.AI.OpenAI/README.md).
17
+
> This guidance is no longer recommended. To take advantage of the latest v1 API refer to the [.NET programming language guide](../supported-languages.md).
Copy file name to clipboardExpand all lines: articles/ai-foundry/openai/how-to/migration.md
+8-5Lines changed: 8 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,14 +7,17 @@ ms.author: mbullwin
7
7
ms.service: azure-ai-openai
8
8
ms.custom: devx-track-python
9
9
ms.topic: how-to
10
-
ms.date: 07/02/2025
10
+
ms.date: 09/30/2025
11
11
manager: nitinme
12
12
---
13
13
14
14
# Migrating to the OpenAI Python API library 1.x
15
15
16
16
OpenAI released a new version of the [OpenAI Python API library](https://github.com/openai/openai-python/). This guide is supplemental to [OpenAI's migration guide](https://github.com/openai/openai-python/discussions/742) and will help bring you up to speed on the changes specific to Azure OpenAI.
17
17
18
+
> [!NOTE]
19
+
> This guidance is no longer recommended. To take advantage of the latest v1 API refer to the [Python programming language guide](../supported-languages.md).
20
+
18
21
## Updates
19
22
20
23
- This is a new version of the OpenAI Python API library.
@@ -35,7 +38,7 @@ OpenAI released a new version of the [OpenAI Python API library](https://github.
35
38
## Test before you migrate
36
39
37
40
> [!IMPORTANT]
38
-
> Automatic migration of your code using `openai migrate`is not supported with Azure OpenAI.
41
+
> Automatic migration of your code using `openai migrate`isn't supported with Azure OpenAI.
39
42
40
43
As this is a new version of the library with breaking changes, you should test your code extensively against the new release before migrating any production applications to rely on version 1.x. You should also review your code and internal processes to make sure that you're following best practices and pinning your production code to only versions that you have fully tested.
41
44
@@ -61,7 +64,7 @@ This provides context for what has changed and allows you to test the new librar
61
64
62
65
# [OpenAI Python 1.x](#tab/python-new)
63
66
64
-
You need to set the `model` variable to the deployment name you chose when you deployed the GPT-3.5-Turbo or GPT-4 models. Entering the model name results in an error unless you chose a deployment name that is identical to the underlying model name.
67
+
You need to set the `model` variable to the deployment name you chose when you deployed the GPT-3.5-Turbo or GPT-4 models. Entering the model name results in an error unless you chose a deployment name that's identical to the underlying model name.
65
68
66
69
```python
67
70
import os
@@ -90,7 +93,7 @@ Additional examples can be found in our [in-depth Chat Completion article](chatg
90
93
91
94
# [OpenAI Python 0.28.1](#tab/python)
92
95
93
-
You need to set the `engine` variable to the deployment name you chose when you deployed the GPT-3.5-Turbo or GPT-4 models. Entering the model name will result in an error unless you chose a deployment name that is identical to the underlying model name.
96
+
You need to set the `engine` variable to the deployment name you chose when you deployed the GPT-3.5-Turbo or GPT-4 models. Entering the model name will result in an error unless you chose a deployment name that's identical to the underlying model name.
94
97
95
98
```python
96
99
import os
@@ -536,7 +539,7 @@ asyncio.run(dall_e())
536
539
## Name changes
537
540
538
541
> [!NOTE]
539
-
> All a* methods have been removed; the async client must be used instead.
542
+
> All `a*` methods have been removed; the async client must be used instead.
0 commit comments