Merge pull request #5790 from eric-urban/eur/voice-live-api

voice live api regions and pricing and foundry

Author: Stacyrch140

articles/ai-services/speech-service/includes/how-to/video-translation/ai-foundry.md

@@ -68,6 +68,8 @@ To create a video translation project, follow these steps:
 
    :::image type="content" source="../../../media/video-translation/foundry-portal/capabilities-by-scenario.png" alt-text="Screenshot of filtering Speech service capabilities by scenario." lightbox="../../../media/video-translation/foundry-portal/capabilities-by-scenario.png":::
 
+1. Select **Go to Speech playground**.
+
 1. Select **My videos** > **Upload video**.
 
    :::image type="content" source="../../../media/video-translation/foundry-portal/select-upload-video.png" alt-text="Screenshot of selecting the upload video button." lightbox="../../../media/video-translation/foundry-portal/select-upload-video.png":::

articles/ai-services/speech-service/includes/quickstarts/voice-live-api/ai-foundry.md

@@ -0,0 +1,51 @@
+---
+title: include file
+description: include file
+author: eric-urban
+ms.author: eur
+ms.service: azure-ai-speech
+ms.topic: include
+ms.date: 7/1/2025
+ms.custom: references_regions
+---
+
+In this article, you learn how to use voice live with generative AI and Azure AI Speech in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs).
+
+## Prerequisites
+
+- An Azure subscription. <a href="https://azure.microsoft.com/free/ai-services" target="_blank">Create one for free</a>.
+- <a href="https://www.python.org/" target="_blank">Python 3.8 or later version</a>. We recommend using Python 3.10 or later, but having at least Python 3.8 is required. If you don't have a suitable version of Python installed, you can follow the instructions in the [VS Code Python Tutorial](https://code.visualstudio.com/docs/python/python-tutorial#_install-a-python-interpreter) for the easiest way of installing Python on your operating system.
+- An [Azure AI Foundry resource](../../../../multi-service-resource.md) created in one of the supported regions. For more information about region availability, see the [Voice Live API overview documentation](../../../voice-live.md).
+
+> [!TIP]
+> To use the Voice Live API, you don't need to deploy an audio model with your Azure AI Foundry resource. The Voice Live API is fully managed, and the model is automatically deployed for you. For more information about models availability, see the [Voice Live API overview documentation](../../../voice-live.md).
+
+## Try out voice live in the Speech playground
+
+To try out the voice live demo, follow these steps:
+
+1. Go to your project in [Azure AI Foundry](https://ai.azure.com/?cid=learnDocs). 
+1. Select **Playgrounds** from the left pane.
+1. In the **Speech playground** tile, select **Try the Speech playground**.
+1. Select **Speech capabilities by scenario** > **Voice live**.
+
+   :::image type="content" source="../../../media/voice-live/foundry-portal/capabilities-by-scenario.png" alt-text="Screenshot of filtering Speech service capabilities by scenario." lightbox="../../../media/voice-live/foundry-portal/capabilities-by-scenario.png":::
+
+1. Select a sample scenario, such as **Casual chat**.
+
+   :::image type="content" source="../../../media/voice-live/foundry-portal/casual-chat-start.png" alt-text="Screenshot of selecting the casual chat example scenario in the Speech playground." lightbox="../../../media/voice-live/foundry-portal/casual-chat-start.png":::
+
+1. Select **Start** to start chatting with the chat agent.
+
+1. Select **End** to end the chat session.
+
+1. Select a new generative AI model from the drop-down list via **Configuration** > **GenAI** > **Generative AI model**. 
+
+   > [!NOTE]
+   > You can also select an agent that you configured in the **Agents** playground.
+
+   :::image type="content" source="../../../media/voice-live/foundry-portal/casual-chat-generative-ai-select.png" alt-text="Screenshot of the casual chat example scenario in the Speech playground." lightbox="../../../media/voice-live/foundry-portal/casual-chat-generative-ai-select.png":::
+
+1. Edit other settings as needed, such as the **Response instructions**, **Voice**, and **Speaking rate**.
+
+1. Select **Start** to start speaking again and select **End** to end the chat session.

articles/ai-services/speech-service/includes/quickstarts/voice-live-api/realtime-python.md renamed to articles/ai-services/speech-service/includes/quickstarts/voice-live-api/python.md

@@ -4,7 +4,7 @@ author: eric-urban
 ms.author: eur
 ms.service: azure-ai-openai
 ms.topic: include
-ms.date: 6/27/2025
+ms.date: 7/1/2025
 ---
 
 ## Prerequisites

articles/ai-services/speech-service/includes/quickstarts/voice-live-api/resource-authentication.md

@@ -1,9 +1,9 @@
 ---
 author: eric-urban 
 ms.author: eur 
-ms.service: azure-ai-openai
+ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 5/19/2025
+ms.date: 7/1/2025
 ---
 
 You need to retrieve the following information to authenticate your application with your Azure AI Foundry resource:

articles/ai-services/speech-service/media/video-translation/foundry-portal/capabilities-by-scenario.png

@@ -6,7 +6,7 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: conceptual
-ms.date: 3/10/2025
+ms.date: 7/1/2025
 ms.author: eur
 ms.custom: references_regions
 #Customer intent: As a developer, I want to learn about the available regions and endpoints for the Speech service.
@@ -172,6 +172,20 @@ The regions in these tables support most of the core features of the Speech serv
 | westus2            | ✅ |
 | westus3            | ✅ |
 
+# [Voice live](#tab/voice-live)
+
+| **Region** | **gpt-4o-realtime-preview** | **gpt-4o-mini-realtime-preview** | **gpt-4o** | **gpt-4o-mini**  | **gpt-4.1** | **gpt-4.1-mini** | **gpt-4.1-nano** | **phi4-mm-realtime** | **phi4-mini** | 
+|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|
+| centralindia       | Cross-region<sup>1</sup> | Cross-region<sup>1</sup> | Global standard | Global standard | - | Global standard | Global standard | - | - |
+| eastus2       | Global standard | Global standard | Data zone standard | Data zone standard | Data zone standard | Data zone standard | Data zone standard | Regional | Regional |
+| southeastasia       | - | - | - | - | - | Global standard | Global standard | - | - |
+| swedencentral       | Global standard | Global standard | Data zone standard | Data zone standard | Data zone standard | Data zone standard | Data zone standard | Regional | Regional |
+| westus2       | Cross-region<sup>2</sup> | Cross-region<sup>2</sup> | Data zone standard | Data zone standard | Data zone standard | Data zone standard | Data zone standard | Regional | Regional |
+
+<sup>1</sup> The Azure AI Foundry resource must be in Central India. Azure AI Speech features remain in Central India. The voice live API uses Sweden Central as needed for generative AI load balancing.  
+
+<sup>2</sup> The Azure AI Foundry resource must be in West US 2. Azure AI Speech features remain in West US 2. The voice live API uses East US 2 as needed for generative AI load balancing.
+
 # [Intent recognition](#tab/intent-recognition)
 
 | **Region** | **Intent recognition** |
@@ -246,41 +260,40 @@ The regions in these tables support most of the core features of the Speech serv
 | westus2            | ✅ | ✅ |
 | westus3            |  |  |
 
-
 # [Scenarios](#tab/scenarios)
 
-| **Region** | **Pronunciation assessment** | **Speaker recognition** | **Voice assistants** | **Voice Live API** |
-|-----|-----|-----|-----|
-| australiaeast      | ✅ | ✅ |  |  |
-| brazilsouth        | ✅ |  |  |  |
-| canadacentral      | ✅ | ✅ | ✅ |  |
-| centralindia       | ✅ | ✅ |  |  |
-| centralus          | ✅ | ✅ |  |  |
-| eastasia           | ✅ | ✅ | ✅ |  |
-| eastus             | ✅ | ✅ | ✅ |  |
-| eastus2            | ✅ | ✅ | ✅ | ✅ |
-| francecentral      | ✅ | ✅ |  |  |
-| germanywestcentral | ✅ | ✅ |  |  |
-| japaneast          | ✅ | ✅ |  |  |
-| japanwest          | ✅ | ✅ |  |  |
-| koreacentral       | ✅ | ✅ |  |  |
-| northcentralus     | ✅ |  |  |  |
-| northeurope        | ✅ | ✅ | ✅ |  |
-| norwayeast         | ✅ | ✅ |  |  |
-| qatarcentral       | ✅ | ✅ |  |  |
-| southafricanorth   | ✅ |  |  |  |
-| southcentralus     | ✅ |  | ✅ |  |
-| southeastasia      | ✅ | ✅ | ✅ |  |
-| swedencentral      | ✅ | ✅ |  | ✅ |
-| switzerlandnorth   | ✅ |  |  |  |
-| switzerlandwest    | ✅ | ✅ |  |  |
-| uaenorth           | ✅ |  |  |  |
-| uksouth            | ✅ | ✅ |  |  |
-| westcentralus      | ✅ | ✅ | ✅ |  |
-| westeurope         | ✅ | ✅ | ✅ |  |
-| westus             | ✅ | ✅ | ✅ |  |
-| westus2            | ✅ | ✅ | ✅ |  |
-| westus3            | ✅ | ✅ |  |  |
+| **Region** | **Pronunciation assessment** | **Speaker recognition** | **Voice assistants** | 
+|-----|-----|-----|
+| australiaeast      | ✅ | ✅ |  |
+| brazilsouth        | ✅ |  |  |
+| canadacentral      | ✅ | ✅ | ✅ |
+| centralindia       | ✅ | ✅ |  |
+| centralus          | ✅ | ✅ |  |
+| eastasia           | ✅ | ✅ | ✅ |
+| eastus             | ✅ | ✅ | ✅ |
+| eastus2            | ✅ | ✅ | ✅ |
+| francecentral      | ✅ | ✅ |  |
+| germanywestcentral | ✅ | ✅ |  |
+| japaneast          | ✅ | ✅ |  |
+| japanwest          | ✅ | ✅ |  |
+| koreacentral       | ✅ | ✅ |  |
+| northcentralus     | ✅ |  |  |
+| northeurope        | ✅ | ✅ | ✅ |
+| norwayeast         | ✅ | ✅ |  |
+| qatarcentral       | ✅ | ✅ |  |
+| southafricanorth   | ✅ |  |  |
+| southcentralus     | ✅ |  | ✅ |
+| southeastasia      | ✅ | ✅ | ✅ |
+| swedencentral      | ✅ | ✅ |  |
+| switzerlandnorth   | ✅ |  |  |
+| switzerlandwest    | ✅ | ✅ |  |
+| uaenorth           | ✅ |  |  |
+| uksouth            | ✅ | ✅ |  |
+| westcentralus      | ✅ | ✅ | ✅ |
+| westeurope         | ✅ | ✅ | ✅ |
+| westus             | ✅ | ✅ | ✅ |
+| westus2            | ✅ | ✅ | ✅ |
+| westus3            | ✅ | ✅ |  |
 
 > [!NOTE]
 > The [Speech SDK](speech-sdk.md) supports voice assistant capabilities through Direct Line Speech.