Merge pull request #284122 from cdpark/refresh-ai-speech

Stacyrch140 · web-flow · commit ac5af70ea5f3 · 2024-08-13T12:58:01.000-04:00
Feature 294024: Q&amp;M: AI Services freshness for 180d target - Get started text-to-speech
diff --git a/articles/ai-services/speech-service/get-started-text-to-speech.md b/articles/ai-services/speech-service/get-started-text-to-speech.md
@@ -1,12 +1,12 @@
 ---
 title: "Text to speech quickstart - Speech service"
 titleSuffix: Azure AI services
-description: In this quickstart, you create an app that converts text to speech. Learn about supported audio formats and custom configuration options.
+description: Learn how to create an app that converts text to speech, and explore supported audio formats and custom configuration options.
 author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: quickstart
-ms.date: 01/29/2024
+ms.date: 08/07/2024
 ms.author: eur
 ms.devlang: cpp
 # ms.devlang: cpp, csharp, golang, java, javascript, objective-c, python
diff --git a/articles/ai-services/speech-service/includes/common/azure-prerequisites-clu.md b/articles/ai-services/speech-service/includes/common/azure-prerequisites-clu.md
@@ -1,14 +1,14 @@
 ---
 author: eric-urban
 ms.service: azure-ai-speech
-ms.date: 02/17/2023
+ms.date: 08/07/2024
 ms.topic: include
 ms.author: eur
 ---
 
 > [!div class="checklist"]
-> * Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
-> * [Create a Language resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextAnalytics) in the Azure portal. 
-> * Get the Language resource key and endpoint. After your Language resource is deployed, select **Go to resource** to view and manage keys. 
+> * An Azure subscription. You can [create one for free](https://azure.microsoft.com/free/cognitive-services).
+> * [Create a Language resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextAnalytics) in the Azure portal.
+> * Get the Language resource key and endpoint. After your Language resource is deployed, select **Go to resource** to view and manage keys.
 > * [Create a Speech resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices) in the Azure portal.
-> * Get the Speech resource key and region. After your Speech resource is deployed, select **Go to resource** to view and manage keys. 
+> * Get the Speech resource key and region. After your Speech resource is deployed, select **Go to resource** to view and manage keys.
diff --git a/articles/ai-services/speech-service/includes/common/azure-prerequisites.md b/articles/ai-services/speech-service/includes/common/azure-prerequisites.md
@@ -1,12 +1,12 @@
 ---
 author: eric-urban
 ms.service: azure-ai-speech
-ms.date: 08/24/2023
+ms.date: 08/07/2024
 ms.topic: include
 ms.author: eur
 ---
 
 > [!div class="checklist"]
-> - Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services).
-> - <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices"  title="Create a Speech resource"  target="_blank">Create a Speech resource</a> in the Azure portal.
-> - Your Speech resource key and region. After your Speech resource is deployed, select **Go to resource** to view and manage keys. 
+> - An Azure subscription. You can [create one for free](https://azure.microsoft.com/free/cognitive-services).
+> - [Create a Speech resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices) in the Azure portal.
+> - Get the Speech resource key and region. After your Speech resource is deployed, select **Go to resource** to view and manage keys.
diff --git a/articles/ai-services/speech-service/includes/common/cpp.md b/articles/ai-services/speech-service/includes/common/cpp.md
@@ -6,4 +6,4 @@ ms.topic: include
 ms.author: eur
 ---
 
-[Reference documentation](/cpp/cognitive-services/speech/) | [Package (NuGet)](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) | [Additional Samples on GitHub](https://aka.ms/speech/github-cpp)
+[Reference documentation](/cpp/cognitive-services/speech/) | [Package (NuGet)](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) | [Additional samples on GitHub](https://aka.ms/speech/github-cpp)
diff --git a/articles/ai-services/speech-service/includes/common/csharp.md b/articles/ai-services/speech-service/includes/common/csharp.md
@@ -6,4 +6,4 @@ ms.topic: include
 ms.author: eur
 ---
 
-[Reference documentation](/dotnet/api/microsoft.cognitiveservices.speech) | [Package (NuGet)](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) | [Additional Samples on GitHub](https://aka.ms/speech/github-csharp)
+[Reference documentation](/dotnet/api/microsoft.cognitiveservices.speech) | [Package (NuGet)](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) | [Additional samples on GitHub](https://aka.ms/speech/github-csharp)
diff --git a/articles/ai-services/speech-service/includes/common/environment-variables.md b/articles/ai-services/speech-service/includes/common/environment-variables.md
@@ -6,12 +6,12 @@ ms.date: 08/24/2023
 ms.author: eur
 ---
 
-Your application must be authenticated to access Azure AI services resources. For production, use a secure way of storing and accessing your credentials. For example, after you get a key for your Speech resource, write it to a new environment variable on the local machine that runs the application.
+You need to authenticate your application to access Azure AI services. For production, use a secure way to store and access your credentials. For example, after you get a key for your Speech resource, write it to a new environment variable on the local machine that runs the application.
 
 > [!TIP]
 > Don't include the key directly in your code, and never post it publicly. See [Azure AI services security](../../../security-features.md) for more authentication options such as [Azure Key Vault](../../../use-key-vault.md).
 
-To set the environment variable for your Speech resource key, open a console window, and follow the instructions for your operating system and development environment.
+To set the environment variables for your Speech resource key and region, open a console window, and follow the instructions for your operating system and development environment.
 
 - To set the `SPEECH_KEY` environment variable, replace *your-key* with one of the keys for your resource.
 - To set the `SPEECH_REGION` environment variable, replace *your-region* with one of the regions for your resource.
@@ -26,7 +26,7 @@ setx SPEECH_REGION your-region
 > [!NOTE]
 > If you only need to access the environment variables in the current console, you can set the environment variable with `set` instead of `setx`.
 
-After you add the environment variables, you might need to restart any programs that need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before you run the example.
+After you add the environment variables, you might need to restart any programs that need to read the environment variables, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before you run the example.
 
 #### [Linux](#tab/linux)
 
diff --git a/articles/ai-services/speech-service/includes/common/go.md b/articles/ai-services/speech-service/includes/common/go.md
@@ -6,4 +6,4 @@ ms.topic: include
 ms.author: eur
 ---
 
-[Reference documentation](https://aka.ms/csspeech/goref) | [Package (Go)](https://pkg.go.dev/github.com/Microsoft/cognitive-services-speech-sdk-go) | [Additional Samples on GitHub](https://github.com/microsoft/cognitive-services-speech-sdk-go/tree/master/samples/)
+[Reference documentation](https://aka.ms/csspeech/goref) | [Package (Go)](https://pkg.go.dev/github.com/Microsoft/cognitive-services-speech-sdk-go) | [Additional samples on GitHub](https://github.com/microsoft/cognitive-services-speech-sdk-go/tree/master/samples/)
diff --git a/articles/ai-services/speech-service/includes/common/java.md b/articles/ai-services/speech-service/includes/common/java.md
@@ -6,4 +6,4 @@ ms.topic: include
 ms.author: eur
 ---
 
-[Reference documentation](/java/api/com.microsoft.cognitiveservices.speech) | [Additional Samples on GitHub](https://aka.ms/speech/github-java)
+[Reference documentation](/java/api/com.microsoft.cognitiveservices.speech) | [Additional samples on GitHub](https://aka.ms/speech/github-java)
diff --git a/articles/ai-services/speech-service/includes/common/javascript.md b/articles/ai-services/speech-service/includes/common/javascript.md
@@ -6,4 +6,4 @@ ms.topic: include
 ms.author: eur
 ---
 
-[Reference documentation](/javascript/api/microsoft-cognitiveservices-speech-sdk/) | [Package (npm)](https://www.npmjs.com/package/microsoft-cognitiveservices-speech-sdk) | [Additional Samples on GitHub](https://aka.ms/speech/github-javascript) | [Library source code](https://github.com/Microsoft/cognitive-services-speech-sdk-js)
+[Reference documentation](/javascript/api/microsoft-cognitiveservices-speech-sdk/) | [Package (npm)](https://www.npmjs.com/package/microsoft-cognitiveservices-speech-sdk) | [Additional samples on GitHub](https://aka.ms/speech/github-javascript) | [Library source code](https://github.com/Microsoft/cognitive-services-speech-sdk-js)
diff --git a/articles/ai-services/speech-service/includes/common/objectivec.md b/articles/ai-services/speech-service/includes/common/objectivec.md
@@ -6,4 +6,4 @@ ms.topic: include
 ms.author: eur
 ---
 
-[Reference documentation](/objectivec/cognitive-services/speech/) | [Package (Download)](https://aka.ms/csspeech/macosbinary) | [Additional Samples on GitHub](https://aka.ms/speech/github-objective-c)
+[Reference documentation](/objectivec/cognitive-services/speech/) | [Package (download)](https://aka.ms/csspeech/macosbinary) | [Additional samples on GitHub](https://aka.ms/speech/github-objective-c)
diff --git a/articles/ai-services/speech-service/includes/common/python.md b/articles/ai-services/speech-service/includes/common/python.md
@@ -6,4 +6,4 @@ ms.topic: include
 ms.author: eur
 ---
 
-[Reference documentation](/python/api/azure-cognitiveservices-speech/) | [Package (PyPi)](https://pypi.org/project/azure-cognitiveservices-speech/) | [Additional Samples on GitHub](https://aka.ms/speech/github-python)
+[Reference documentation](/python/api/azure-cognitiveservices-speech/) | [Package (PyPi)](https://pypi.org/project/azure-cognitiveservices-speech/) | [Additional samples on GitHub](https://aka.ms/speech/github-python)
diff --git a/articles/ai-services/speech-service/includes/common/rest.md b/articles/ai-services/speech-service/includes/common/rest.md
@@ -6,4 +6,4 @@ ms.topic: include
 ms.author: eur
 ---
 
-[Speech to text REST API reference](../../rest-speech-to-text.md) | [Speech to text REST API for short audio reference](../../rest-speech-to-text-short.md) | [Additional Samples on GitHub](https://github.com/Azure-Samples/cognitive-services-speech-sdk)
+[Speech to text REST API reference](../../rest-speech-to-text.md) | [Speech to text REST API for short audio reference](../../rest-speech-to-text-short.md) | [Additional samples on GitHub](https://github.com/Azure-Samples/cognitive-services-speech-sdk)
diff --git a/articles/ai-services/speech-service/includes/common/swift.md b/articles/ai-services/speech-service/includes/common/swift.md
@@ -6,4 +6,4 @@ ms.topic: include
 ms.author: eur
 ---
 
-[Reference documentation](/objectivec/cognitive-services/speech/) | [Package (Download)](https://aka.ms/csspeech/macosbinary) | [Additional Samples on GitHub](https://aka.ms/speech/github-objective-c)
+[Reference documentation](/objectivec/cognitive-services/speech/) | [Package (download)](https://aka.ms/csspeech/macosbinary) | [Additional samples on GitHub](https://aka.ms/speech/github-objective-c)
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/cli.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/cli.md
@@ -16,19 +16,19 @@ ms.author: eur
 
 [!INCLUDE [SPX Setup](../../spx-setup-quick.md)]
 
-## Synthesize to speaker output
+## Send speech to speaker
 
-Run the following command for speech synthesis to the default speaker output. You can modify the voice and the text to be synthesized.
+Run the following command to output speech synthesis to the default speaker. You can modify the voice and the text to be synthesized.
 
 ```console
 spx synthesize --text "I'm excited to try text to speech" --voice "en-US-AvaMultilingualNeural"
 ```
 
 If you don't set a voice name, the default voice for `en-US` speaks.
 
-All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is "I'm excited to try text to speech" and you set `--voice "es-ES-ElviraNeural"`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
+All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is *I'm excited to try text to speech* and you set `--voice "es-ES-ElviraNeural"`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
 
-Run this command for information about more speech synthesis options such as file input and output:
+Run this command for information about more speech synthesis options, such as file input and output:
 
 ```console
 spx help synthesize
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/cpp.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/cpp.md
@@ -16,13 +16,13 @@ ms.author: eur
 
 ## Set up the environment
 
-The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) that implements .NET Standard 2.0. Install the Speech SDK later in this guide. For any requirements, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-cpp).
+The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) that implements .NET Standard 2.0. Install the Speech SDK later in this guide. For detailed installation instructions, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-cpp).
 
 ### Set environment variables
 
 [!INCLUDE [Environment variables](../../common/environment-variables.md)]
 
-## Synthesize to speaker output
+## Create the application
 
 Follow these steps to create a console application and install the Speech SDK.
 
@@ -114,7 +114,7 @@ Follow these steps to create a console application and install the Speech SDK.
 
 1. To change the speech synthesis language, replace `en-US-AvaMultilingualNeural` with another [supported voice](~/articles/ai-services/speech-service/language-support.md#prebuilt-neural-voices).
 
-   All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is "I'm excited to try text to speech" and you set `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
+   All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is *I'm excited to try text to speech* and you set `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
 
 1. [Build and run your new console application](/cpp/build/vscpp-step-2-build) to start speech synthesis to the default speaker.
 
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/csharp.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/csharp.md
@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 2/1/2024
+ms.date: 8/07/2024
 ms.author: eur
 ---
 
@@ -16,13 +16,13 @@ ms.author: eur
 
 ## Set up the environment
 
-The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) that implements .NET Standard 2.0. Install the Speech SDK later in this guide. For any requirements, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-csharp).
+The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) that implements .NET Standard 2.0. Install the Speech SDK later in this guide by using the console. For detailed installation instructions, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-csharp).
 
 ### Set environment variables
 
 [!INCLUDE [Environment variables](../../common/environment-variables.md)]
 
-## Synthesize to speaker output
+## Create the application
 
 Follow these steps to create a console application and install the Speech SDK.
 
@@ -103,7 +103,7 @@ Follow these steps to create a console application and install the Speech SDK.
 
 1. To change the speech synthesis language, replace `en-US-AvaMultilingualNeural` with another [supported voice](~/articles/ai-services/speech-service/language-support.md#prebuilt-neural-voices).
 
-   All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is "I'm excited to try text to speech" and you set `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
+   All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is *I'm excited to try text to speech* and you set `es-ES-ElviraNeural` as the language, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
 
 1. Run your new console application to start speech synthesis to the default speaker.
 
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/go.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/go.md
@@ -16,13 +16,13 @@ ms.author: eur
 
 ## Set up the environment
 
-Install the Speech SDK for Go. For requirements and instructions, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-go).
+Install the Speech SDK for the Go language. For detailed installation instructions, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-go).
 
 ### Set environment variables
 
 [!INCLUDE [Environment variables](../../common/environment-variables.md)]
 
-## Synthesize to speaker output
+## Create the application
 
 Follow these steps to create a Go module.
 
@@ -136,7 +136,7 @@ Follow these steps to create a Go module.
 
 1. To change the speech synthesis language, replace `en-US-AvaMultilingualNeural` with another [supported voice](~/articles/ai-services/speech-service/language-support.md#prebuilt-neural-voices).
 
-   All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is "I'm excited to try text to speech" and you set `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
+   All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is *I'm excited to try text to speech* and you set `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
 
 1. Run the following commands to create a *go.mod* file that links to components hosted on GitHub:
 
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/intro.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/intro.md
@@ -6,7 +6,7 @@ ms.date: 2/1/2024
 ms.author: eur
 ---
 
-In this quickstart, you run an application that does text to speech synthesis.
+With Azure AI Speech, you can run an application that synthesizes a human-like voice to read text. You can change the voice, enter text to be spoken, and listen to the output on your computer's speaker.
 
 > [!TIP]
 > You can try text to speech in the [Speech Studio Voice Gallery](https://aka.ms/speechstudio/voicegallery) without signing up or writing any code.
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/java.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/java.md
@@ -60,7 +60,7 @@ To set up your environment, [install the Speech SDK](~/articles/ai-services/spee
 
 [!INCLUDE [Environment variables](../../common/environment-variables.md)]
 
-## Synthesize to speaker output
+## Create the application
 
 Follow these steps to create a console application for speech recognition.
 
@@ -117,9 +117,9 @@ Follow these steps to create a console application for speech recognition.
 
 1. To change the speech synthesis language, replace `en-US-AvaMultilingualNeural` with another [supported voice](~/articles/ai-services/speech-service/language-support.md#prebuilt-neural-voices).
 
-   All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is "I'm excited to try text to speech" and you set `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
+   All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is *I'm excited to try text to speech* and you set `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
 
-1. Run your console application to start speech synthesis to the default speaker.
+1. Run your console application to output speech synthesis to the default speaker.
 
    ```console
    javac SpeechSynthesis.java -cp ".;target\dependency\*"
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/javascript.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/javascript.md
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/objectivec.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/objectivec.md
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/python.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/python.md
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/rest.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/rest.md
diff --git a/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/swift.md b/articles/ai-services/speech-service/includes/quickstarts/text-to-speech-basics/swift.md
