Merge pull request #269646 from MicrosoftDocs/main

3/20/2024 AM Publish

Author: Taojunshen

articles/ai-services/computer-vision/includes/how-to-guides/analyze-image-40-rest.md

@@ -74,7 +74,7 @@ You can also do image analysis with a custom trained model. To create and train
 
 To use a custom model, don't use the features query parameter. Instead, set the `model-name` parameter to the name of your model as shown here. Replace `MyCustomModelName` with your custom model name.
 
-`https://<endpoint>/computervision/imageanalysis:analyze?api-version=2024-02-01&model-name=MyCustomModelName`
+`https://<endpoint>/computervision/imageanalysis:analyze?api-version=2023-02-01&model-name=MyCustomModelName`
 
 
 ### Specify languages

articles/ai-services/speech-service/batch-synthesis-properties.md

@@ -31,7 +31,7 @@ Batch synthesis properties are described in the following table.
 |`description`|The description of the batch synthesis.<br/><br/>This property is optional.|
 |`displayName`|The name of the batch synthesis. Choose a name that you can refer to later. The display name doesn't have to be unique.<br/><br/>This property is required.|
 |`id`|The batch synthesis job ID.<br/><br/>This property is read-only.|
-|`inputs`|The plain text or SSML to be synthesized.<br/><br/>When the `textType` is set to `"PlainText"`, provide plain text as shown here: `"inputs": [{"text": "The rainbow has seven colors."}]`. When the `textType` is set to `"SSML"`, provide text in the [Speech Synthesis Markup Language (SSML)](speech-synthesis-markup.md) as shown here: `"inputs": [{"text": "<speak version='\''1.0'\'' xml:lang='\''en-US'\''><voice xml:lang='\''en-US'\'' xml:gender='\''Female'\'' name='\''en-US-AvaNeural'\''>The rainbow has seven colors.</voice></speak>"}]`.<br/><br/>Include up to 1,000 text objects if you want multiple audio output files. Here's example input text that should be synthesized to two audio output files: `"inputs": [{"text": "synthesize this to a file"},{"text": "synthesize this to another file"}]`. However, if the `properties.concatenateResult` property is set to `true`, then each synthesized result is written to the same audio output file.<br/><br/>You don't need separate text inputs for new paragraphs. Within any of the (up to 1,000) text inputs, you can specify new paragraphs using the "\r\n" (newline) string. Here's example input text with two paragraphs that should be synthesized to the same audio output file: `"inputs": [{"text": "synthesize this to a file\r\nsynthesize this to another paragraph in the same file"}]`<br/><br/>There are no paragraph limits, but the maximum JSON payload size (including all text inputs and other properties) is 500 kilobytes.<br/><br/>This property is required when you create a new batch synthesis job. This property isn't included in the response when you get the synthesis job.|
+|`inputs`|The plain text or SSML to be synthesized.<br/><br/>When the `textType` is set to `"PlainText"`, provide plain text as shown here: `"inputs": [{"text": "The rainbow has seven colors."}]`. When the `textType` is set to `"SSML"`, provide text in the [Speech Synthesis Markup Language (SSML)](speech-synthesis-markup.md) as shown here: `"inputs": [{"text": "<speak version='\''1.0'\'' xml:lang='\''en-US'\''><voice xml:lang='\''en-US'\'' xml:gender='\''Female'\'' name='\''en-US-AvaMultilingualNeural'\''>The rainbow has seven colors.</voice></speak>"}]`.<br/><br/>Include up to 1,000 text objects if you want multiple audio output files. Here's example input text that should be synthesized to two audio output files: `"inputs": [{"text": "synthesize this to a file"},{"text": "synthesize this to another file"}]`. However, if the `properties.concatenateResult` property is set to `true`, then each synthesized result is written to the same audio output file.<br/><br/>You don't need separate text inputs for new paragraphs. Within any of the (up to 1,000) text inputs, you can specify new paragraphs using the "\r\n" (newline) string. Here's example input text with two paragraphs that should be synthesized to the same audio output file: `"inputs": [{"text": "synthesize this to a file\r\nsynthesize this to another paragraph in the same file"}]`<br/><br/>There are no paragraph limits, but the maximum JSON payload size (including all text inputs and other properties) is 500 kilobytes.<br/><br/>This property is required when you create a new batch synthesis job. This property isn't included in the response when you get the synthesis job.|
 |`lastActionDateTime`|The most recent date and time when the `status` property value changed.<br/><br/>This property is read-only.|
 |`outputs.result`|The location of the batch synthesis result files with audio output and logs.<br/><br/>This property is read-only.|
 |`properties`|A defined set of optional batch synthesis configuration settings.|

articles/ai-services/speech-service/how-to-audio-content-creation.md

@@ -129,7 +129,7 @@ You can get your content into the Audio Content Creation tool in either of two w
 
         ```xml
         <speak xmlns="http://www.w3.org/2001/10/synthesis" xmlns:mstts="http://www.w3.org/2001/mstts" version="1.0" xml:lang="en-US">
-            <voice name="en-US-AvaNeural">
+            <voice name="en-US-AvaMultilingualNeural">
             Welcome to use Audio Content Creation <break time="10ms" />to customize audio output for your products.
             </voice>
         </speak>

articles/ai-services/speech-service/includes/how-to/speech-synthesis/cpp.md

@@ -22,7 +22,7 @@ void synthesizeSpeech()
     auto speechConfig = SpeechConfig::FromSubscription("YourSpeechKey", "YourSpeechRegion");
     // Set either the `SpeechSynthesisVoiceName` or `SpeechSynthesisLanguage`.
     speechConfig->SetSpeechSynthesisLanguage("en-US"); 
-    speechConfig->SetSpeechSynthesisVoiceName("en-US-AvaNeural");
+    speechConfig->SetSpeechSynthesisVoiceName("en-US-AvaMultilingualNeural");
 }
 ```
 
@@ -157,7 +157,7 @@ To start using SSML for customization, make a minor change that switches the voi
 
    ```xml
    <speak version="1.0" xmlns="https://www.w3.org/2001/10/synthesis" xml:lang="en-US">
-     <voice name="en-US-AvaNeural">
+     <voice name="en-US-AvaMultilingualNeural">
        When you're on the freeway, it's a good idea to use a GPS.
      </voice>
    </speak>
@@ -188,7 +188,7 @@ To start using SSML for customization, make a minor change that switches the voi
    ```
 
 > [!NOTE]
-> To change the voice without using SSML, you can set the property on `SpeechConfig` by using `SpeechConfig.SetSpeechSynthesisVoiceName("en-US-ChristopherNeural")`.
+> To change the voice without using SSML, you can set the property on `SpeechConfig` by using `SpeechConfig.SetSpeechSynthesisVoiceName("en-US-AndrewMultilingualNeural")`.
 
 ## Subscribe to synthesizer events
 
@@ -227,7 +227,7 @@ int main()
     speechConfig->SetProperty(PropertyId::SpeechServiceResponse_RequestSentenceBoundary, "true");
 
     const auto ssml = R"(<speak version='1.0' xml:lang='en-US' xmlns='http://www.w3.org/2001/10/synthesis' xmlns:mstts='http://www.w3.org/2001/mstts'>
-        <voice name = 'en-US-AvaNeural'>
+        <voice name = 'en-US-AvaMultilingualNeural'>
             <mstts:viseme type = 'redlips_front' />
             The rainbow has seven colors : <bookmark mark = 'colors_list_begin' />Red, orange, yellow, green, blue, indigo, and violet.<bookmark mark = 'colors_list_end' />.
         </voice>

articles/ai-services/speech-service/includes/how-to/speech-synthesis/csharp.md

@@ -23,7 +23,7 @@ static async Task SynthesizeAudioAsync()
     var speechConfig = SpeechConfig.FromSubscription("YourSpeechKey", "YourSpeechRegion");
     // Set either the `SpeechSynthesisVoiceName` or `SpeechSynthesisLanguage`.
     speechConfig.SpeechSynthesisLanguage = "en-US"; 
-    speechConfig.SpeechSynthesisVoiceName = "en-US-AvaNeural";
+    speechConfig.SpeechSynthesisVoiceName = "en-US-AvaMultilingualNeural";
 }
 ```
 
@@ -160,7 +160,7 @@ To start using SSML for customization, you make a minor change that switches the
 
    ```xml
    <speak version="1.0" xmlns="https://www.w3.org/2001/10/synthesis" xml:lang="en-US">
-     <voice name="en-US-AvaNeural">
+     <voice name="en-US-AvaMultilingualNeural">
        When you're on the freeway, it's a good idea to use a GPS.
      </voice>
    </speak>
@@ -188,7 +188,7 @@ To start using SSML for customization, you make a minor change that switches the
    ```
 
 > [!NOTE]
-> To change the voice without using SSML, you can set the property on `SpeechConfig` by using `SpeechConfig.SpeechSynthesisVoiceName = "en-US-AvaNeural";`.
+> To change the voice without using SSML, you can set the property on `SpeechConfig` by using `SpeechConfig.SpeechSynthesisVoiceName = "en-US-AvaMultilingualNeural";`.
 
 ## Subscribe to synthesizer events
 
@@ -213,7 +213,7 @@ class Program
     {
         var speechConfig = SpeechConfig.FromSubscription(speechKey, speechRegion);
 
-        var speechSynthesisVoiceName  = "en-US-AvaNeural";  
+        var speechSynthesisVoiceName  = "en-US-AvaMultilingualNeural";  
         var ssml = @$"<speak version='1.0' xml:lang='en-US' xmlns='http://www.w3.org/2001/10/synthesis' xmlns:mstts='http://www.w3.org/2001/mstts'>
             <voice name='{speechSynthesisVoiceName}'>
                 <mstts:viseme type='redlips_front'/>

articles/ai-services/speech-service/includes/how-to/speech-synthesis/go.md

@@ -293,7 +293,7 @@ if err != nil {
 defer speechConfig.Close()
 
 speechConfig.SetSpeechSynthesisLanguage("en-US")
-speechConfig.SetSpeechSynthesisVoiceName("en-US-AvaNeural")
+speechConfig.SetSpeechSynthesisVoiceName("en-US-AvaMultilingualNeural")
 ```
 
 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 select `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent.
@@ -320,7 +320,7 @@ First, create a new XML file for the SSML configuration in your root project dir
 
 ```xml
 <speak version="1.0" xmlns="https://www.w3.org/2001/10/synthesis" xml:lang="en-US">
-  <voice name="en-US-AvaNeural">
+  <voice name="en-US-AvaMultilingualNeural">
     When you're on the freeway, it's a good idea to use a GPS.
   </voice>
 </speak>
@@ -329,7 +329,7 @@ First, create a new XML file for the SSML configuration in your root project dir
 Next, you need to change the speech synthesis request to reference your XML file. The request is mostly the same, but instead of using the `SpeakTextAsync()` function, you use `SpeakSsmlAsync()`. This function expects an XML string, so you first load your SSML configuration as a string. From this point, the result object is exactly the same as previous examples.
 
 > [!NOTE]
-> To set the voice without using SSML, you can set the property on  `SpeechConfig` by using `speechConfig.SetSpeechSynthesisVoiceName("en-US-AvaNeural")`.
+> To set the voice without using SSML, you can set the property on  `SpeechConfig` by using `speechConfig.SetSpeechSynthesisVoiceName("en-US-AvaMultilingualNeural")`.
 
 ## Subscribe to synthesizer events
 
@@ -445,7 +445,7 @@ func main() {
     speechSynthesizer.VisemeReceived(visemeReceivedHandler)
     speechSynthesizer.WordBoundary(wordBoundaryHandler)
 
-    speechSynthesisVoiceName := "en-US-AvaNeural"
+    speechSynthesisVoiceName := "en-US-AvaMultilingualNeural"
 
     ssml := fmt.Sprintf(`<speak version='1.0' xml:lang='en-US' xmlns='http://www.w3.org/2001/10/synthesis' xmlns:mstts='http://www.w3.org/2001/mstts'>
             <voice name='%s'>

articles/ai-services/speech-service/includes/how-to/speech-synthesis/java.md

@@ -23,7 +23,7 @@ public static void main(String[] args) {
     SpeechConfig speechConfig = SpeechConfig.fromSubscription("YourSpeechKey", "YourSpeechRegion");
     // Set either the `SpeechSynthesisVoiceName` or `SpeechSynthesisLanguage`.
     speechConfig.setSpeechSynthesisLanguage("en-US"); 
-    speechConfig.setSpeechSynthesisVoiceName("en-US-AvaNeural");
+    speechConfig.setSpeechSynthesisVoiceName("en-US-AvaMultilingualNeural");
 }
 ```
 
@@ -160,7 +160,7 @@ To start using SSML for customization, you make a minor change that switches the
 
    ```xml
    <speak version="1.0" xmlns="https://www.w3.org/2001/10/synthesis" xml:lang="en-US">
-     <voice name="en-US-AvaNeural">
+     <voice name="en-US-AvaMultilingualNeural">
        When you're on the freeway, it's a good idea to use a GPS.
      </voice>
    </speak>
@@ -201,7 +201,7 @@ To start using SSML for customization, you make a minor change that switches the
    ```
 
 > [!NOTE]
-> To change the voice without using SSML, set the property on `SpeechConfig` by using `SpeechConfig.setSpeechSynthesisVoiceName("en-US-AvaNeural");`.
+> To change the voice without using SSML, set the property on `SpeechConfig` by using `SpeechConfig.setSpeechSynthesisVoiceName("en-US-AvaMultilingualNeural");`.
 
 ## Subscribe to synthesizer events
 
@@ -232,7 +232,7 @@ public class SpeechSynthesis {
         // Required for WordBoundary event sentences.
         speechConfig.setProperty(PropertyId.SpeechServiceResponse_RequestSentenceBoundary, "true");
 
-        String speechSynthesisVoiceName = "en-US-AvaNeural"; 
+        String speechSynthesisVoiceName = "en-US-AvaMultilingualNeural"; 
 
         String ssml = String.format("<speak version='1.0' xml:lang='en-US' xmlns='http://www.w3.org/2001/10/synthesis' xmlns:mstts='http://www.w3.org/2001/mstts'>"
             .concat(String.format("<voice name='%s'>", speechSynthesisVoiceName))

articles/ai-services/speech-service/includes/how-to/speech-synthesis/javascript.md

@@ -22,7 +22,7 @@ function synthesizeSpeech() {
     const speechConfig = sdk.SpeechConfig.fromSubscription("YourSpeechKey", "YourSpeechRegion");
     // Set either the `SpeechSynthesisVoiceName` or `SpeechSynthesisLanguage`.
     speechConfig.speechSynthesisLanguage = "en-US"; 
-    speechConfig.speechSynthesisVoiceName = "en-US-AvaNeural";
+    speechConfig.speechSynthesisVoiceName = "en-US-AvaMultilingualNeural";
 }
 
 synthesizeSpeech();
@@ -292,7 +292,7 @@ To start using SSML for customization, you make a minor change that switches the
 
    ```xml
    <speak version="1.0" xmlns="https://www.w3.org/2001/10/synthesis" xml:lang="en-US">
-     <voice name="en-US-AvaNeural">
+     <voice name="en-US-AvaMultilingualNeural">
        When you're on the freeway, it's a good idea to use a GPS.
      </voice>
    </speak>
@@ -338,7 +338,7 @@ To start using SSML for customization, you make a minor change that switches the
    ```
 
 > [!NOTE]
-> To change the voice without using SSML, you can set the property on `SpeechConfig` by using `SpeechConfig.speechSynthesisVoiceName = "en-US-AvaNeural";`.
+> To change the voice without using SSML, you can set the property on `SpeechConfig` by using `SpeechConfig.speechSynthesisVoiceName = "en-US-AvaMultilingualNeural";`.
 
 ## Subscribe to synthesizer events
 
@@ -362,7 +362,7 @@ Here's an example that shows how to subscribe to events for speech synthesis. Yo
     const speechConfig = sdk.SpeechConfig.fromSubscription(process.env.SPEECH_KEY, process.env.SPEECH_REGION);
     const audioConfig = sdk.AudioConfig.fromAudioFileOutput(audioFile);
 
-    var speechSynthesisVoiceName  = "en-US-AvaNeural";  
+    var speechSynthesisVoiceName  = "en-US-AvaMultilingualNeural";  
     var ssml = `<speak version='1.0' xml:lang='en-US' xmlns='http://www.w3.org/2001/10/synthesis' xmlns:mstts='http://www.w3.org/2001/mstts'> \r\n \
         <voice name='${speechSynthesisVoiceName}'> \r\n \
             <mstts:viseme type='redlips_front'/> \r\n \

articles/ai-services/speech-service/includes/how-to/speech-synthesis/python.md

@@ -19,7 +19,7 @@ Specify the language or voice of `SpeechConfig` to match your input text and use
 ```python
 # Set either the `SpeechSynthesisVoiceName` or `SpeechSynthesisLanguage`.
 speech_config.speech_synthesis_language = "en-US" 
-speech_config.speech_synthesis_voice_name ="en-US-AvaNeural"
+speech_config.speech_synthesis_voice_name ="en-US-AvaMultilingualNeural"
 ```
 
 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 select `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent.
@@ -129,7 +129,7 @@ To start using SSML for customization, make a minor change that switches the voi
 
    ```xml
    <speak version="1.0" xmlns="https://www.w3.org/2001/10/synthesis" xml:lang="en-US">
-     <voice name="en-US-AvaNeural">
+     <voice name="en-US-AvaMultilingualNeural">
        When you're on the freeway, it's a good idea to use a GPS.
      </voice>
    </speak>
@@ -153,7 +153,7 @@ To start using SSML for customization, make a minor change that switches the voi
    ```
 
 > [!NOTE]
-> To change the voice without using SSML, you can set the property on `SpeechConfig` by using `speech_config.speech_synthesis_voice_name = "en-US-AvaNeural"`.
+> To change the voice without using SSML, you can set the property on `SpeechConfig` by using `speech_config.speech_synthesis_voice_name = "en-US-AvaMultilingualNeural"`.
 
 ## Subscribe to synthesizer events
 
@@ -222,7 +222,7 @@ speech_synthesizer.viseme_received.connect(speech_synthesizer_viseme_received_cb
 speech_synthesizer.synthesis_word_boundary.connect(speech_synthesizer_word_boundary_cb)
 
 # The language of the voice that speaks.
-speech_synthesis_voice_name='en-US-AvaNeural'
+speech_synthesis_voice_name='en-US-AvaMultilingualNeural'
 
 ssml = """<speak version='1.0' xml:lang='en-US' xmlns='http://www.w3.org/2001/10/synthesis' xmlns:mstts='http://www.w3.org/2001/mstts'>
     <voice name='{}'>

articles/ai-services/speech-service/includes/how-to/speech-synthesis/rest.md

@@ -34,7 +34,7 @@ curl --location --request POST 'https://YOUR_RESOURCE_REGION.tts.speech.microsof
 --header 'X-Microsoft-OutputFormat: audio-16khz-128kbitrate-mono-mp3' \
 --header 'User-Agent: curl' \
 --data-raw '<speak version='\''1.0'\'' xml:lang='\''en-US'\''>
-    <voice name='\''en-US-AvaNeural'\''>
+    <voice name='\''en-US-AvaMultilingualNeural'\''>
         I am excited to try text to speech
     </voice>
 </speak>' > output.mp3