refresh openai quickstarts

eric-urban · eric-urban · commit 6913c58aaff5 · 2025-05-22T16:29:32.000-07:00
diff --git a/articles/ai-foundry/includes/chat-with-data.md b/articles/ai-foundry/includes/chat-with-data.md
@@ -15,7 +15,7 @@ To complete this section, you need a local copy of product data. The [Azure-Samp
 Follow these steps to add your data in the chat playground to help the assistant answer questions about your products. You're not changing the deployed model itself. Your data is stored separately and securely in your Azure subscription.
 
 1. Go to your project in [Azure AI Foundry](https://ai.azure.com). 
-1. Select **Playgrounds**.
+1. Select **Playgrounds** from the left pane.
 1. Select **Try the chat playground**.
 1. Select your deployed chat model from the **Deployment** dropdown. 
 
diff --git a/articles/ai-services/openai/audio-completions-quickstart.md b/articles/ai-services/openai/audio-completions-quickstart.md
@@ -5,7 +5,7 @@ description: Walkthrough on how to get started with audio generation using Azure
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: how-to
-ms.date: 2/6/2025
+ms.date: 5/23/2025
 author: eric-urban
 ms.author: eur
 ms.custom: references_regions
diff --git a/articles/ai-services/openai/includes/audio-completions-ai-foundry.md b/articles/ai-services/openai/includes/audio-completions-ai-foundry.md
@@ -17,8 +17,14 @@ ms.date: 1/7/2025
 
 To chat with your deployed `gpt-4o-mini-audio-preview` model in the **Chat** playground of [Azure AI Foundry portal](https://ai.azure.com), follow these steps:
 
-1. Go to the [Azure OpenAI in Azure AI Foundry Models page](https://ai.azure.com/resource/overview) in Azure AI Foundry portal. Make sure you're signed in with the Azure subscription that has your Azure OpenAI in Azure AI Foundry Models resource and the deployed `gpt-4o-mini-audio-preview` model.
-1. Select the **Chat** playground from under **Resource playground** in the left pane.
+1. Go to the [Azure AI Foundry portal](https://ai.azure.com) and select your project that has your deployed `gpt-4o-mini-audio-preview` model.
+1. Go to your project in [Azure AI Foundry](https://ai.azure.com). 
+1. Select **Playgrounds** from the left pane.
+1. Select **Audio playground** > **Try the Chat playground**. 
+
+    > [!NOTE]
+    > The **Audio playground** doesn't support the `gpt-4o-mini-audio-preview` model. Use the **Chat playground** as described in this section.
+
 1. Select your deployed `gpt-4o-mini-audio-preview` model from the **Deployment** dropdown. 
 1. Start chatting with the model and listen to the audio responses.
 
diff --git a/articles/ai-services/openai/includes/audio-completions-deploy-model.md b/articles/ai-services/openai/includes/audio-completions-deploy-model.md
@@ -4,15 +4,15 @@ author: eric-urban
 ms.author: eur
 ms.service: azure-ai-openai
 ms.topic: include
-ms.date: 1/21/2025
+ms.date: 5/23/2025
 ---
 
 To deploy the `gpt-4o-mini-audio-preview` model in the Azure AI Foundry portal:
-1. Go to the [Azure OpenAI in Azure AI Foundry Models page](https://ai.azure.com/resource/overview) in Azure AI Foundry portal. Make sure you're signed in with the Azure subscription that has your Azure OpenAI in Azure AI Foundry Models resource and the deployed `gpt-4o-mini-audio-preview` model.
-1. Select the **Chat** playground from under **Playgrounds** in the left pane.
-1. Select **+ Create new deployment** > **From base models** to open the deployment window. 
-1. Search for and select the `gpt-4o-mini-audio-preview` model and then select **Deploy to selected resource**.
-1. In the deployment wizard, select the `2024-12-17` model version.
+1. Go to the [Azure AI Foundry portal](https://ai.azure.com) and create or select your project. 
+1. Select **Models + endpoints** from under **My assets** in the left pane.
+1. Select **+ Deploy model** > **Deploy base model** to open the deployment window. 
+1. Search for and select the `gpt-4o-mini-audio-preview` model and then select **Confirm**.
+1. Review the deployment details and select **Deploy**.
 1. Follow the wizard to finish deploying the model.
 
 Now that you have a deployment of the `gpt-4o-mini-audio-preview` model, you can interact with it in the Azure AI Foundry portal **Chat** playground or chat completions API.
diff --git a/articles/ai-services/openai/includes/realtime-deploy-model.md b/articles/ai-services/openai/includes/realtime-deploy-model.md
@@ -8,11 +8,11 @@ ms.date: 1/21/2025
 ---
 
 To deploy the `gpt-4o-mini-realtime-preview` model in the Azure AI Foundry portal:
-1. Go to the [Azure OpenAI in Azure AI Foundry Models page](https://ai.azure.com/resource/overview) in Azure AI Foundry portal. Make sure you're signed in with the Azure subscription that has your Azure OpenAI in Azure AI Foundry Models resource (with or without model deployments.)
-1. Select the **Real-time audio** playground from under **Playgrounds** in the left pane.
-1. Select **+ Create new deployment** > **From base models** to open the deployment window. 
-1. Search for and select the `gpt-4o-mini-realtime-preview` model and then select **Deploy to selected resource**.
-1. In the deployment wizard, select the `2024-12-17` model version.
+1. Go to the [Azure AI Foundry portal](https://ai.azure.com) and create or select your project. 
+1. Select **Models + endpoints** from under **My assets** in the left pane.
+1. Select **+ Deploy model** > **Deploy base model** to open the deployment window. 
+1. Search for and select the `gpt-4o-mini-realtime-preview` model and then select **Confirm**.
+1. Review the deployment details and select **Deploy**.
 1. Follow the wizard to finish deploying the model.
 
-Now that you have a deployment of the `gpt-4o-mini-realtime-preview` model, you can interact with it in real time in the Azure AI Foundry portal **Real-time audio** playground or Realtime API.
+Now that you have a deployment of the `gpt-4o-mini-realtime-preview` model, you can interact with it in the Azure AI Foundry portal **Audio** playground or Realtime API.
diff --git a/articles/ai-services/openai/includes/realtime-portal.md b/articles/ai-services/openai/includes/realtime-portal.md
@@ -15,17 +15,18 @@ ms.date: 3/20/2025
 
 To chat with your deployed `gpt-4o-mini-realtime-preview` model in the [Azure AI Foundry](https://ai.azure.com) **Real-time audio** playground, follow these steps:
 
-1. Go to the [Azure OpenAI in Azure AI Foundry Models page](https://ai.azure.com/resource/overview) in Azure AI Foundry portal. Make sure you're signed in with the Azure subscription that has your Azure OpenAI in Azure AI Foundry Models resource and the deployed `gpt-4o-mini-realtime-preview` model.
-1. Select the **Real-time audio** playground from under **Playgrounds** in the left pane.
-1. Select your deployed `gpt-4o-mini-realtime-preview` model from the **Deployment** dropdown. 
-1. Select **Enable microphone** to allow the browser to access your microphone. If you already granted permission, you can skip this step.
+1. Go to the [Azure AI Foundry portal](https://ai.azure.com) and select your project that has your deployed `gpt-4o-mini-realtime-preview` model.
+1. Select **Playgrounds** from the left pane.
+1. Select **Audio playground** > **Try the Audio playground**. 
 
-    :::image type="content" source="../media/how-to/real-time/real-time-playground.png" alt-text="Screenshot of the real-time audio playground with the deployed model selected." lightbox="../media/how-to/real-time/real-time-playground.png":::
+    > [!NOTE]
+    > The **Chat playground** doesn't support the `gpt-4o-mini-realtime-preview` model. Use the **Audio playground** as described in this section.
+
+1. Select your deployed `gpt-4o-mini-realtime-preview` model from the **Deployment** dropdown.
+
+    :::image type="content" source="../media/how-to/real-time/real-time-playground.png" alt-text="Screenshot of the audio playground with the deployed model selected." lightbox="../media/how-to/real-time/real-time-playground.png":::
 
 1. Optionally, you can edit contents in the **Give the model instructions and context** text box. Give the model instructions about how it should behave and any context it should reference when generating a response. You can describe the assistant's personality, tell it what it should and shouldn't answer, and tell it how to format responses.
 1. Optionally, change settings such as threshold, prefix padding, and silence duration.
 1. Select **Start listening** to start the session. You can speak into the microphone to start a chat.
-
-    :::image type="content" source="../media/how-to/real-time/real-time-playground-start-listening.png" alt-text="Screenshot of the real-time audio playground with the start listening button and microphone access enabled." lightbox="../media/how-to/real-time/real-time-playground-start-listening.png":::
-
 1. You can interrupt the chat at any time by speaking. You can end the chat by selecting the **Stop listening** button.
diff --git a/articles/ai-services/openai/includes/text-to-speech-rest.md b/articles/ai-services/openai/includes/text-to-speech-rest.md
@@ -73,7 +73,7 @@ echo export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE" >> /etc/envi
 In a bash shell, run the following command. You need to replace `YourDeploymentName` with the deployment name you chose when you deployed the text to speech model. The deployment name isn't necessarily the same as the model name. Entering the model name results in an error unless you chose a deployment name that is identical to the underlying model name.
 
 ```bash
-curl $AZURE_OPENAI_ENDPOINT/openai/deployments/YourDeploymentName/audio/speech?api-version=2024-02-15-preview \
+curl $AZURE_OPENAI_ENDPOINT/openai/deployments/YourDeploymentName/audio/speech?api-version=2025-04-01-preview \
  -H "api-key: $AZURE_OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
@@ -83,7 +83,7 @@ curl $AZURE_OPENAI_ENDPOINT/openai/deployments/YourDeploymentName/audio/speech?a
 }' --output speech.mp3
 ```
 
-The format of your first line of the command with an example endpoint would appear as follows curl `https://aoai-docs.openai.azure.com/openai/deployments/{YourDeploymentName}/audio/speech?api-version=2024-02-15-preview \`. 
+The format of your first line of the command with an example endpoint would appear as follows curl `https://aoai-docs.openai.azure.com/openai/deployments/{YourDeploymentName}/audio/speech?api-version=2025-04-01-preview \`. 
 
 > [!IMPORTANT]
 > For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](/azure/key-vault/general/overview). For more information about credential security, see this [security](../../security-features.md) article.
diff --git a/articles/ai-services/openai/includes/text-to-speech-typescript.md b/articles/ai-services/openai/includes/text-to-speech-typescript.md
@@ -86,7 +86,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 || "tts";
-    const apiVersion = process.env.OPENAI_API_VERSION || "2024-08-01-preview";
+    const apiVersion = process.env.OPENAI_API_VERSION || "2025-04-01-preview";
 
     // keyless authentication    
     const credential = new DefaultAzureCredential();
@@ -184,7 +184,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 || "tts";
-    const apiVersion = process.env.OPENAI_API_VERSION || "2024-08-01-preview";
+    const apiVersion = process.env.OPENAI_API_VERSION || "2025-04-01-preview";
     
     function getClient(): AzureOpenAI {
       return new AzureOpenAI({
diff --git a/articles/ai-services/openai/media/how-to/real-time/real-time-playground-start-listening.png b/articles/ai-services/openai/media/how-to/real-time/real-time-playground-start-listening.png
diff --git a/articles/ai-services/openai/media/how-to/real-time/real-time-playground.png b/articles/ai-services/openai/media/how-to/real-time/real-time-playground.png
diff --git a/articles/ai-services/openai/realtime-audio-quickstart.md b/articles/ai-services/openai/realtime-audio-quickstart.md
@@ -5,7 +5,7 @@ description: Learn how to use GPT-4o Realtime API for speech and audio with Azur
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: how-to
-ms.date: 3/20/2025
+ms.date: 5/23/2025
 author: eric-urban
 ms.author: eur
 ms.custom: references_regions, ignite-2024
diff --git a/articles/ai-services/openai/text-to-speech-quickstart.md b/articles/ai-services/openai/text-to-speech-quickstart.md
@@ -5,7 +5,7 @@ description: Use the Azure OpenAI for text to speech with OpenAI voices.
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: quickstart
-ms.date: 3/10/2025
+ms.date: 5/23/2025
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
diff --git a/articles/ai-services/openai/whisper-quickstart.md b/articles/ai-services/openai/whisper-quickstart.md
@@ -6,7 +6,7 @@ manager: nitinme
 ms.service: azure-ai-openai
 ms.custom: devx-track-python
 ms.topic: quickstart
-ms.date: 3/10/2025
+ms.date: 5/23/2025
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
diff --git a/articles/ai-services/speech-service/whisper-overview.md b/articles/ai-services/speech-service/whisper-overview.md
@@ -6,7 +6,7 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: overview
-ms.date: 2/28/2025
+ms.date: 5/23/2025
 ms.author: eur
 #Customer intent: As a developer, I want to learn about the Whisper model from OpenAI that I can use for speech to text and speech translation.
 ---
