Merge pull request #7109 from goergenj/voicelive-customization-ga

Voicelive customization ga

Author: v-dirichards

articles/ai-services/speech-service/includes/quickstarts/voice-live-agents/python.md

@@ -1,10 +1,10 @@
 ---
 manager: nitinme
-author: PatrickFarley
-ms.author: pafarley
+author: goergenj
+ms.author: jagoerge
 ms.service: azure-ai-openai
 ms.topic: include
-ms.date: 7/31/2025
+ms.date: 9/26/2025
 ---
 
 In this article, you learn how to use Azure AI Speech voice live with [Azure AI Foundry Agent Service](/azure/ai-foundry/agents/overview) using Python code. 
@@ -165,7 +165,7 @@ client = AsyncAzureVoiceLive(
         endpoint = os.environ.get("AZURE_VOICE_LIVE_ENDPOINT") or "<https://your-endpoint.azure.com/>"
         agent_id = os.environ.get("AI_FOUNDRY_AGENT_ID") or "<your-agent-id>"
         project_name = os.environ.get("AI_FOUNDRY_PROJECT_NAME") or "<your-project-name>"
-        api_version = os.environ.get("AZURE_VOICE_LIVE_API_VERSION") or "2025-05-01-preview"
+        api_version = os.environ.get("AZURE_VOICE_LIVE_API_VERSION") or "2025-10-01"
         api_key = os.environ.get("AZURE_VOICE_LIVE_API_KEY") or "<your-api-key>"
     
         # For the recommended keyless authentication, get and
@@ -669,7 +669,7 @@ The `voicelive.log` file contains information about the connection to the Voice
 
 ```text
 2025-07-29 09:43:32,574:websockets.client:DEBUG:= connection is CONNECTING
-2025-07-29 09:43:32,825:websockets.client:DEBUG:> GET /voice-live/realtime?api-version=2025-05-01-preview&agent-project-name=contoso-proj-agentic&agent-id=<your-agent-id>&agent-access-token=<your-token>&debug=on HTTP/1.1
+2025-07-29 09:43:32,825:websockets.client:DEBUG:> GET /voice-live/realtime?api-version=2025-10-01&agent-project-name=contoso-proj-agentic&agent-id=<your-agent-id>&agent-access-token=<your-token>&debug=on HTTP/1.1
 2025-07-29 09:43:32,825:websockets.client:DEBUG:> Host: your-ai-foundry-resource.cognitiveservices.azure.com
 2025-07-29 09:43:32,825:websockets.client:DEBUG:> Upgrade: websocket
 2025-07-29 09:43:32,825:websockets.client:DEBUG:> Connection: Upgrade
@@ -864,7 +864,7 @@ def main() -> None:
     endpoint = os.environ.get("AZURE_VOICE_LIVE_ENDPOINT") or "<https://your-endpoint.azure.com/>"
     agent_id = os.environ.get("AI_FOUNDRY_AGENT_ID") or "<your-agent-id>"
     agent_connection_string = os.environ.get("AI_FOUNDRY_AGENT_CONNECTION_STRING") or "<your-agent-connection-string>"
-    api_version = os.environ.get("AZURE_VOICE_LIVE_API_VERSION") or "2025-05-01-preview"
+    api_version = os.environ.get("AZURE_VOICE_LIVE_API_VERSION") or "2025-10-01"
     api_key = os.environ.get("AZURE_VOICE_LIVE_API_KEY") or "<your-api-key>"
 
     # For the recommended keyless authentication, get and

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

@@ -1,9 +1,9 @@
 ---
-author: PatrickFarley 
-ms.author: pafarley 
+author: goergenj 
+ms.author: jagoerge
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 7/31/2025
+ms.date: 9/26/2025
 ---
 
 Create a new file named `.env` in the folder where you want to run the code. 
@@ -14,7 +14,7 @@ In the `.env` file, add the following environment variables for authentication:
 AZURE_VOICE_LIVE_ENDPOINT=<your_endpoint>
 AI_FOUNDRY_PROJECT_NAME=<your_project_name>
 AI_FOUNDRY_AGENT_ID=<your_agent_id>
-AZURE_VOICE_LIVE_API_VERSION=2025-05-01-preview
+AZURE_VOICE_LIVE_API_VERSION=2025-10-01
 AZURE_VOICE_LIVE_API_KEY=<your_api_key> # Only required if using API key authentication
 ```
 
@@ -27,7 +27,7 @@ Replace the default values with your actual project name, agent ID, API version,
 | `AZURE_VOICE_LIVE_ENDPOINT` | This value can be found in the **Keys and Endpoint** section when examining your resource from the Azure portal. |
 | `AI_FOUNDRY_PROJECT_NAME` | The name of your Azure AI Foundry project. |
 | `AI_FOUNDRY_AGENT_ID` | The ID of your Azure AI Foundry agent. |
-| `AZURE_VOICE_LIVE_API_VERSION`| The API version you want to use. For example, `2025-05-01-preview`. |
+| `AZURE_VOICE_LIVE_API_VERSION`| The API version you want to use. For example, `2025-10-01`. |
 
 Learn more about [keyless authentication](/azure/ai-services/authentication) and [setting environment variables](/azure/ai-services/cognitive-services-environment-variables).
 
@@ -38,7 +38,7 @@ Learn more about [keyless authentication](/azure/ai-services/authentication) and
 | `AZURE_VOICE_LIVE_ENDPOINT` | This value can be found in the **Keys and Endpoint** section when examining your resource from the Azure portal. |
 | `AI_FOUNDRY_PROJECT_NAME` | The name of your Azure AI Foundry project. |
 | `AI_FOUNDRY_AGENT_ID` | The ID of your Azure AI Foundry agent. |
-| `AZURE_VOICE_LIVE_API_VERSION`| The API version you want to use. For example, `2025-05-01-preview`. |
+| `AZURE_VOICE_LIVE_API_VERSION`| The API version you want to use. For example, `2025-10-01`. |
 | `AZURE_VOICE_LIVE_API_KEY` | This value can be found in the **Keys and Endpoint** section when examining your resource from the Azure portal. You can use either `KEY1` or `KEY2`.|
 
 Learn more about [finding API keys](/azure/ai-services/cognitive-services-environment-variables) and [setting environment variables](/azure/ai-services/cognitive-services-environment-variables).

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

@@ -602,14 +602,14 @@ The sample code in this quickstart uses either Microsoft Entra ID or an API key
             "--model",
             help="VoiceLive model to use",
             type=str,
-            default=os.environ.get("VOICE_LIVE_MODEL", "gpt-4o-realtime-preview"),
+            default=os.environ.get("VOICE_LIVE_MODEL", "gpt-realtime"),
         )
 
         parser.add_argument(
             "--voice",
             help="Voice to use for the assistant",
             type=str,
-            default=os.environ.get("VOICE_LIVE_VOICE", "en-US-AvaNeural"),
+            default=os.environ.get("VOICE_LIVE_VOICE", "en-US-Ava:DragonHDLatestNeural"),
             help="Voice to use for the assistant. E.g. alloy, echo, fable, en-US-AvaNeural, en-US-GuyNeural",
         )
 

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

@@ -1,9 +1,9 @@
 ---
-author: PatrickFarley 
-ms.author: pafarley 
+author: goergenj 
+ms.author: jagoerge 
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 7/31/2025
+ms.date: 9/26/2025
 ---
 
 Create a new file named `.env` in the folder where you want to run the code. 
@@ -13,7 +13,7 @@ In the `.env` file, add the following environment variables for authentication:
 ```plaintext
 AZURE_VOICE_LIVE_ENDPOINT=<your_endpoint>
 VOICE_LIVE_MODEL=<your_model>
-AZURE_VOICE_LIVE_API_VERSION=2025-05-01-preview
+AZURE_VOICE_LIVE_API_VERSION=2025-10-01
 AZURE_VOICE_LIVE_API_KEY=<your_api_key> # Only required if using API key authentication
 ```
 
@@ -25,7 +25,7 @@ Replace the default values with your actual endpoint, model, API version, and AP
 |--------------------------|-------------|
 | `AZURE_VOICE_LIVE_ENDPOINT` | This value can be found in the **Keys and Endpoint** section when examining your resource from the Azure portal. |
 | `AZURE_VOICE_LIVE_MODEL` | The model you want to use. For example, `gpt-4o` or `gpt-4o-mini-realtime-preview`. For more information about models availability, see the [Voice Live API overview documentation](../../../voice-live.md). |
-| `AZURE_VOICE_LIVE_API_VERSION`| The API version you want to use. For example, `2025-05-01-preview`. |
+| `AZURE_VOICE_LIVE_API_VERSION`| The API version you want to use. For example, `2025-10-01`. |
 
 Learn more about [keyless authentication](/azure/ai-services/authentication) and [setting environment variables](/azure/ai-services/cognitive-services-environment-variables).
 
@@ -35,7 +35,7 @@ Learn more about [keyless authentication](/azure/ai-services/authentication) and
 |--------------------------|-------------|
 | `AZURE_VOICE_LIVE_ENDPOINT` | This value can be found in the **Keys and Endpoint** section when examining your resource from the Azure portal. |
 | `AZURE_VOICE_LIVE_MODEL` | The model you want to use. For example, `gpt-4o` or `gpt-4o-mini-realtime-preview`. For more information about models availability, see the [Voice Live API overview documentation](../../../voice-live.md). |
-| `AZURE_VOICE_LIVE_API_VERSION`| The API version you want to use. For example, `2025-05-01-preview`. |
+| `AZURE_VOICE_LIVE_API_VERSION`| The API version you want to use. For example, `2025-10-01`. |
 | `AZURE_VOICE_LIVE_API_KEY` | This value can be found in the **Keys and Endpoint** section when examining your resource from the Azure portal. You can use either `KEY1` or `KEY2`.|
 
 Learn more about [finding API keys](/azure/ai-services/cognitive-services-environment-variables) and [setting environment variables](/azure/ai-services/cognitive-services-environment-variables).

articles/ai-services/speech-service/includes/release-notes/release-notes-tts.md

@@ -15,9 +15,9 @@ Our new “DragonV2.1” model brings improvements to the naturalness of speech,
 ### June 2025 release
 
 #### VoiceLive API update 
-- Support more GenAI models: GPT-4.1, GPT-4.1 Mini and GPT-4.1 Nano, Phi-4 mini and Phi-4 Multimodal models are now natively supported.
+- Support more GenAI models: GPT-4.1, GPT-4.1 Mini, Phi-4 mini and Phi-4 Multimodal models are now natively supported.
 - Support more customization capabilities
-- Azure Semantic VAD is extended to support GPT-4o-Realtime and GPT-4o-Mini-Realtime.
+- Azure Semantic VAD is extended to support GPT-Realtime and GPT-4o-Mini-Realtime.
 - Availability in more regions
 
 #### Public preview of Voice Conversion feature on selected en-US voices

articles/ai-services/speech-service/regions.md

@@ -2,12 +2,12 @@
 title: Regions - Speech service
 titleSuffix: Azure AI services
 description: A list of available regions and endpoints for the Speech service, including speech to text, text to speech, and speech translation.
-author: PatrickFarley
+author: goergenj
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: conceptual
-ms.date: 7/1/2025
-ms.author: pafarley
+ms.date: 9/16/2025
+ms.author: jagoerge
 ms.custom: references_regions
 #Customer intent: As a developer, I want to learn about the available regions and endpoints for the Speech service.
 ---
@@ -174,15 +174,20 @@ The regions in these tables support most of the core features of the Speech serv
 
 # [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.  
+| **Region** | **gpt-realtime** | **gpt-4o-mini-realtime-preview** (Preview) | **gpt-4o** | **gpt-4o-mini**  | **gpt-4.1** | **gpt-4.1-mini** | **gpt-5** (Preview) | **gpt-5-mini** (Preview) | **gpt-5-nano** (Preview) | **gpt-5-chat** (Preview) | **phi4-mm-realtime** (Preview) | **phi4-mini** (Preview) |
+|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|
+| 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 | Data zone standard | Data zone standard | Global standard | Regional | Regional |
+| southeastasia       | - | - | - | - | Global standard | Global standard | - | - | - | - | Regional | Regional |
+| swedencentral       | Global standard | Global standard | Data zone standard | Data zone standard | Data zone standard | Data zone standard | Data zone standard | Data zone standard | Data zone standard | Global 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 | - | - | - | - | Regional | Regional |
+|australiaeast| - | - | Global standard | Global standard | Global standard | Global standard | - | - | - | - | - | - |
+|japaneast| - | - | Global standard | Global standard | Global standard | Global standard | - | - | - | - | Regional | Regional |
+|eastus| - | - | Data zone standard | Data zone standard | Data zone standard | Data zone standard | - | - | - | - | - | - |
+|uksouth| - | - | Global standard | Global standard | Global standard | Global standard | - | - | - | - | - | - |
+|westeurope| - | - | Data zone standard | Data zone standard | Data zone standard | Data zone standard | - | - | - | - | - | - |
+
+<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.
 
@@ -262,7 +267,7 @@ The regions in these tables support most of the core features of the Speech serv
 
 # [Scenarios](#tab/scenarios)
 
-| **Region** | **Pronunciation assessment** | **Speaker recognition** | **Voice assistants** | 
+| **Region** | **Pronunciation assessment** | **Speaker recognition** | **Voice assistants** |
 |-----|-----|-----|
 | australiaeast      | ✅ | ✅ |  |
 | brazilsouth        | ✅ |  |  |

articles/ai-services/speech-service/toc.yml

@@ -236,14 +236,16 @@ items:
   items:
     - name: Voice live overview
       href: voice-live.md
+    - name: Voice live language support
+      href: voice-live-language-support.md
     - name: Voice live with Foundry models quickstart
       href: voice-live-quickstart.md
     - name: Voice live with Foundry agents quickstart
       href: voice-live-agents-quickstart.md
     - name: How to use voice live
       href: voice-live-how-to.md
-    - name: Voice live language support
-      href: voice-live-language-support.md
+    - name: How to customize voice live input and output
+      href: voice-live-how-to-customize.md
     - name: Audio events reference
       href: /azure/ai-foundry/openai/realtime-audio-reference?context=/azure/ai-services/speech-service/context/context
 - name: Keyword recognition