realtime webrtc

Author: eric-urban

articles/ai-services/openai/concepts/models.md

@@ -258,7 +258,7 @@ Details about maximum request tokens and training data are available in the foll
 |`gpt-4o-mini-realtime-preview` (2024-12-17) <br> **GPT-4o audio** | **Audio model** for real-time audio processing. |Input: 128,000  <br> Output: 4,096 | Oct 2023 |
 |`gpt-4o-audio-preview` (2024-12-17) <br> **GPT-4o audio** | **Audio model** for audio and text generation. |Input: 128,000  <br> Output: 4,096 | Oct 2023 |
 |`gpt-4o-realtime-preview` (2024-12-17) <br> **GPT-4o audio** | **Audio model** for real-time audio processing. |Input: 128,000  <br> Output: 4,096 | Oct 2023 |
-|`gpt-4o-realtime-preview` (2024-10-01) <br> **GPT-4o audio** | **Audio model** for real-time audio processing. |Input: 128,000  <br> Output: 4,096 | Oct 2023 |
+|`gpt-4o-mini-realtime-preview` (2024-12-17) <br> **GPT-4o audio** | **Audio model** for real-time audio processing. |Input: 128,000  <br> Output: 4,096 | Oct 2023 |
 
 To compare the availability of GPT-4o audio models across all regions, see the [models table](#global-standard-model-availability).
 

articles/ai-services/openai/how-to/realtime-audio-webrtc.md

@@ -33,7 +33,8 @@ Use the [Realtime API via WebSockets](./realtime-audio-websockets.md) if you nee
 The GPT 4o real-time models are available for global deployments in [East US 2 and Sweden Central regions](../concepts/models.md#global-standard-model-availability).
 - `gpt-4o-mini-realtime-preview` (2024-12-17)
 - `gpt-4o-realtime-preview` (2024-12-17)
-- `gpt-4o-realtime-preview` (2024-10-01)
+
+You should use API version `2025-04-01-preview` in the URL for the Realtime API. The API version is included in the sessions URL.
 
 For more information about supported models, see the [models and versions documentation](../concepts/models.md#audio-models).
 
@@ -51,21 +52,28 @@ You use different URLs to get an ephemeral API key and connect to the Realtime A
 
 | URL | Description | 
 |---|---|
-| Sessions URL | The `/realtime/sessions` URL is used to get an ephemeral API key. The sessions URL includes the Azure OpenAI resource URL, deployment name, the `/realtime/sessions` path, and the API version. |
-| WebRTC URL | The WebRTC URL is used to establish a WebRTC peer connection with the Realtime API. The WebRTC URL includes the region and the `realtimeapi-preview.ai.azure.com/v1/realtimertc` path.<br/><br/>The supported regions are `eastus2` and `swedencentral`. |
+| Sessions URL | The `/realtime/sessions` URL is used to get an ephemeral API key. The sessions URL includes the Azure OpenAI resource URL, deployment name, the `/realtime/sessions` path, and the API version.<br/><br/>You should use API version `2025-04-01-preview` in the URL.<br/><br/>For an example and more information, see the [Sessions URL](#sessions-url) section below.|
+| WebRTC URL | The WebRTC URL is used to establish a WebRTC peer connection with the Realtime API. The WebRTC URL includes the region and the `realtimeapi-preview.ai.azure.com/v1/realtimertc` path.<br/><br/>The supported regions are `eastus2` and `swedencentral`.<br/><br/>For an example and more information, see the [Sessions URL](#webrtc-url) section below.|
 
+### Sessions URL
 Here's an example of a well-constructed `realtime/sessions` URL that you use to get an ephemeral API key:
 
 ```http
-https://YourAzureOpenAIResourceName.openai.azure.com/openai/deployments/gpt-4o-mini-realtime-preview/realtime/sessions?api-version=2025-02-01-preview
+https://YourAzureOpenAIResourceName.openai.azure.com/openai/realtimeapi/sessions?api-version=2025-04-01-preview
 ```
-
+### WebRTC URL
 Make sure the region of the WebRTC URL matches the region of your Azure OpenAI resource.
 
 For example:
 - If your Azure OpenAI resource is in the swedencentral region,
-the WebRTC URL should be `https://swedencentral.realtimeapi-preview.ai.azure.com/v1/realtimertc`.
-- If your Azure OpenAI resource is in the eastus2 region, the WebRTC URL should be `https://eastus2.realtimeapi-preview.ai.azure.com/v1/realtimertc`.
+the WebRTC URL should be:
+    ```http
+    https://swedencentral.realtimeapi-preview.ai.azure.com/v1/realtimertc
+    ```
+- If your Azure OpenAI resource is in the eastus2 region, the WebRTC URL should be:
+    ```http
+    https://eastys2.realtimeapi-preview.ai.azure.com/v1/realtimertc
+    ```
 
 The sessions URL includes the Azure OpenAI resource URL, deployment name, the `/realtime/sessions` path, and the API version. The Azure OpenAI resource region isn't part of the sessions URL.
 
@@ -141,7 +149,7 @@ The sample code is an HTML page that allows you to start a session with the GPT-
             // The SESSIONS_URL includes the Azure OpenAI resource URL,
             // deployment name, the /realtime/sessions path, and the API version.
             // The Azure OpenAI resource region isn't part of the SESSIONS_URL.
-            const SESSIONS_URL="https://YourAzureOpenAIResourceName.openai.azure.com/openai/deployments/gpt-4o-mini-realtime-preview/realtime/sessions?api-version=2025-02-01-preview"
+            const SESSIONS_URL="https://YourAzureOpenAIResourceName.openai.azure.com/openai/realtimeapi/sessions?api-version=2025-04-01-preview"
     		
             // The API key of the Azure OpenAI resource.
             const API_KEY = "YOUR_API_KEY_HERE"; 

articles/ai-services/openai/how-to/realtime-audio-websockets.md

@@ -30,7 +30,8 @@ Use the Realtime API via WebSockets in server-to-server scenarios where low late
 The GPT-4o real-time models are available for global deployments in [East US 2 and Sweden Central regions](../concepts/models.md#global-standard-model-availability).
 - `gpt-4o-mini-realtime-preview` (2024-12-17)
 - `gpt-4o-realtime-preview` (2024-12-17)
-- `gpt-4o-realtime-preview` (2024-10-01)
+
+You should use API version `2025-04-01-preview` in the URL for the Realtime API. 
 
 For more information about supported models, see the [models and versions documentation](../concepts/models.md#audio-models).
 

articles/ai-services/openai/how-to/realtime-audio.md

@@ -29,7 +29,8 @@ You can use the Realtime API via WebRTC or WebSocket to send audio input to the
 The GPT 4o real-time models are available for global deployments in [East US 2 and Sweden Central regions](../concepts/models.md#global-standard-model-availability).
 - `gpt-4o-mini-realtime-preview` (2024-12-17)
 - `gpt-4o-realtime-preview` (2024-12-17)
-- `gpt-4o-realtime-preview` (2024-10-01)
+
+You should use API version `2025-04-01-preview` in the URL for the Realtime API. 
 
 See the [models and versions documentation](../concepts/models.md#audio-models) for more information.
 

articles/ai-services/openai/includes/realtime-javascript.md

@@ -73,7 +73,7 @@ For the recommended keyless authentication with Microsoft Entra ID, you need to:
         const endpoint = process.env.AZURE_OPENAI_ENDPOINT || "AZURE_OPENAI_ENDPOINT";
         // Required Azure OpenAI deployment name and API version
         const deploymentName = process.env.AZURE_OPENAI_DEPLOYMENT_NAME || "gpt-4o-mini-realtime-preview";
-        const apiVersion = process.env.OPENAI_API_VERSION || "2024-10-01-preview";
+        const apiVersion = process.env.OPENAI_API_VERSION || "2025-04-01-preview";
         // Keyless authentication 
         const credential = new DefaultAzureCredential();
         const scope = "https://cognitiveservices.azure.com/.default";
@@ -156,7 +156,7 @@ For the recommended keyless authentication with Microsoft Entra ID, you need to:
         const apiKey = process.env.AZURE_OPENAI_API_KEY || "Your API key";
         // Required Azure OpenAI deployment name and API version
         const deploymentName = process.env.AZURE_OPENAI_DEPLOYMENT_NAME || "gpt-4o-mini-realtime-preview";
-        const apiVersion = process.env.OPENAI_API_VERSION || "2024-10-01-preview";
+        const apiVersion = process.env.OPENAI_API_VERSION || "2025-04-01-preview";
         const azureOpenAIClient = new AzureOpenAI({
             apiKey: apiKey,
             apiVersion: apiVersion,

articles/ai-services/openai/includes/realtime-python.md

@@ -109,7 +109,7 @@ For the recommended keyless authentication with Microsoft Entra ID, you need to:
         client = AsyncAzureOpenAI(
             azure_endpoint=os.environ["AZURE_OPENAI_ENDPOINT"],
             azure_ad_token_provider=token_provider,
-            api_version="2024-10-01-preview",
+            api_version="2025-04-01-preview",
         )
         async with client.beta.realtime.connect(
             model="gpt-4o-realtime-preview",  # name of your deployment
@@ -181,7 +181,7 @@ For the recommended keyless authentication with Microsoft Entra ID, you need to:
         client = AsyncAzureOpenAI(
             azure_endpoint=os.environ["AZURE_OPENAI_ENDPOINT"],
             api_key=os.environ["AZURE_OPENAI_API_KEY"],
-            api_version="2024-10-01-preview",
+            api_version="2025-04-01-preview",
         )
         async with client.beta.realtime.connect(
             model="gpt-4o-realtime-preview",  # deployment name of your model

articles/ai-services/openai/includes/realtime-typescript.md

@@ -84,7 +84,7 @@ For the recommended keyless authentication with Microsoft Entra ID, you need to:
         
         // Required Azure OpenAI deployment name and API version
         const deploymentName = process.env.AZURE_OPENAI_DEPLOYMENT_NAME || "gpt-4o-mini-realtime-preview";
-        const apiVersion = process.env.OPENAI_API_VERSION || "2024-10-01-preview"; 
+        const apiVersion = process.env.OPENAI_API_VERSION || "2025-04-01-preview"; 
     
         // Keyless authentication 
         const credential = new DefaultAzureCredential();
@@ -197,7 +197,7 @@ For the recommended keyless authentication with Microsoft Entra ID, you need to:
         
         // Required Azure OpenAI deployment name and API version
         const deploymentName = process.env.AZURE_OPENAI_DEPLOYMENT_NAME || "gpt-4o-mini-realtime-preview";
-        const apiVersion = process.env.OPENAI_API_VERSION || "2024-10-01-preview"; 
+        const apiVersion = process.env.OPENAI_API_VERSION || "2025-04-01-preview"; 
         
         const azureOpenAIClient = new AzureOpenAI({
             apiKey: apiKey,

articles/ai-services/openai/realtime-audio-quickstart.md

@@ -26,13 +26,12 @@ Most users of the Realtime API need to deliver and receive audio from an end-use
 The GPT 4o real-time models are available for global deployments.
 - `gpt-4o-realtime-preview` (version `2024-12-17`)
 - `gpt-4o-mini-realtime-preview` (version `2024-12-17`)
-- `gpt-4o-realtime-preview` (version `2024-10-01`)
 
 See the [models and versions documentation](./concepts/models.md#audio-models) for more information.
 
 ## API support
 
-Support for the Realtime API was first added in API version `2024-10-01-preview`. Use version `2024-10-01-preview` to access the Realtime API. 
+Support for the Realtime API was first added in API version `2024-10-01-preview` (retired). Use version `2025-04-01-preview` to access the latest Realtime API features. 
 
 ::: zone pivot="ai-foundry-portal"