Merge pull request #218695 from eric-urban/eur/ssml-silence

batch synthesis preview

Author: v-dirichards

articles/cognitive-services/.openpublishing.redirection.cognitive-services.json

@@ -4990,6 +4990,11 @@
             "redirect_url": "/azure/cognitive-services/speech-service/migrate-v3-0-to-v3-1",
             "redirect_document_id": true
         },
+        {
+            "source_path_from_root": "/articles/cognitive-services/speech-service/long-audio-api.md",
+            "redirect_url": "/azure/cognitive-services/speech-service/batch-synthesis",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/cognitive-services/text-analytics/concepts/data-limits.md",
             "redirect_url": "/azure/cognitive-services/language-service/overview",

articles/cognitive-services/Speech-Service/batch-synthesis.md

@@ -100,7 +100,6 @@ curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-
 }'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions"
 ```
 
-
 You should receive a response body in the following format:
 
 ```json
@@ -166,7 +165,7 @@ Here are some property options that you can use to configure a transcription whe
 |`model`|You can set the `model` property to use a specific base model or [Custom Speech](how-to-custom-speech-train-model.md) model. If you don't specify the `model`, the default base model for the locale is used. For more information, see [Using custom models](#using-custom-models).|
 |`profanityFilterMode`|Specifies how to handle profanity in recognition results. Accepted values are `None` to disable profanity filtering, `Masked` to replace profanity with asterisks, `Removed` to remove all profanity from the result, or `Tags` to add profanity tags. The default value is `Masked`. |
 |`punctuationMode`|Specifies how to handle punctuation in recognition results. Accepted values are `None` to disable punctuation, `Dictated` to imply explicit (spoken) punctuation, `Automatic` to let the decoder deal with punctuation, or `DictatedAndAutomatic` to use dictated and automatic punctuation. The default value is  `DictatedAndAutomatic`.|
-|`timeToLive`|A duration after the transcription job is created, when the transcription results will be automatically deleted. For example, specify `PT12H` for 12 hours. As an alternative, you can call [DeleteTranscription](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-0/operations/DeleteTranscription) regularly after you retrieve the transcription results.|
+|`timeToLive`|A duration after the transcription job is created, when the transcription results will be automatically deleted. The value is an ISO 8601 encoded duration. For example, specify `PT12H` for 12 hours. As an alternative, you can call [DeleteTranscription](https://eastus.dev.cognitive.microsoft.com/docs/services/speech-to-text-api-v3-0/operations/DeleteTranscription) regularly after you retrieve the transcription results.|
 |`wordLevelTimestampsEnabled`|Specifies if word level timestamps should be included in the output. The default value is `false`.|
 
 

articles/cognitive-services/Speech-Service/batch-transcription-create.md

@@ -345,20 +345,20 @@ Depending in part on the request parameters set when you created the transcripti
 |`confidence`|The confidence value for the recognition.|
 |`display`|The display form of the recognized text. Added punctuation and capitalization are included.|
 |`displayPhraseElements`|A list of results with display text for each word of the phrase. The `displayFormWordLevelTimestampsEnabled` request property must be set to `true`, otherwise this property is not present.<br/><br/>**Note**: This property is only available with speech-to-text REST API version 3.1.|
-|`duration`|The audio duration, ISO 8601 encoded duration.|
+|`duration`|The audio duration. The value is an ISO 8601 encoded duration.|
 |`durationInTicks`|The audio duration in ticks (1 tick is 100 nanoseconds).|
 |`itn`|The inverse text normalized (ITN) form of the recognized text. Abbreviations such as "Doctor Smith" to "Dr Smith", phone numbers, and other transformations are applied.|
 |`lexical`|The actual words recognized.|
 |`locale`|The locale identified from the input the audio. The `languageIdentification` request property must be set to `true`, otherwise this property is not present.<br/><br/>**Note**: This property is only available with speech-to-text REST API version 3.1.|
 |`maskedITN`|The ITN form with profanity masking applied.|
 |`nBest`|A list of possible transcriptions for the current phrase with confidences.|
-|`offset`|The offset in audio of this phrase, ISO 8601 encoded duration.|
+|`offset`|The offset in audio of this phrase. The value is an ISO 8601 encoded duration.|
 |`offsetInTicks`|The offset in audio of this phrase in ticks (1 tick is 100 nanoseconds).|
 |`recognitionStatus`|The recognition state. For example: "Success" or "Failure".|
 |`recognizedPhrases`|The list of results for each phrase.|
 |`source`|The URL that was provided as the input audio source. The source corresponds to the `contentUrls` or `contentContainerUrl` request property. The `source` property is the only way to confirm the audio input for a transcription.|
 |`speaker`|The identified speaker. The `diarization` and `diarizationEnabled` request properties must be set, otherwise this property is not present.|
-|`timestamp`|The creation time of the transcription, ISO 8601 encoded timestamp, combined date and time.|
+|`timestamp`|The creation date and time of the transcription. The value is an ISO 8601 encoded timestamp.|
 |`words`|A list of results with lexical text for each word of the phrase. The `wordLevelTimestampsEnabled` request property must be set to `true`, otherwise this property is not present.|
 
 

articles/cognitive-services/Speech-Service/batch-transcription-get.md

@@ -215,5 +215,5 @@ If you want to allow a user to grant access to other users, you need to assign t
 
 ## Next steps
 
-* [Long Audio API](./long-audio-api.md)
-
+- [Speech Synthesis Markup Language (SSML)](speech-synthesis-markup.md)
+- [Batch synthesis](batch-synthesis.md)

articles/cognitive-services/Speech-Service/how-to-audio-content-creation.md

@@ -227,4 +227,3 @@ Navigate to the project where you copied the model to [deploy the model copy](ho
 - [Deploy and use your voice model](how-to-deploy-and-use-endpoint.md)
 - [How to record voice samples](record-custom-voice-samples.md)
 - [Text-to-Speech API reference](rest-text-to-speech.md)
-- [Long Audio API](long-audio-api.md)

articles/cognitive-services/Speech-Service/how-to-custom-voice-create-voice.md

@@ -318,4 +318,4 @@ The HTTP status code for each response indicates success or common errors.
 
 - [How to record voice samples](record-custom-voice-samples.md)
 - [Text-to-Speech API reference](rest-text-to-speech.md)
-- [Long Audio API](long-audio-api.md)
+- [Batch synthesis](batch-synthesis.md)

articles/cognitive-services/Speech-Service/how-to-deploy-and-use-endpoint.md

@@ -139,7 +139,7 @@ Now that you've completed the quickstart, here are some additional consideration
 
 This quickstart uses the `SpeakTextAsync` operation to synthesize a short block of text that you enter. You can also get text from files as described in these guides:
 - For information about speech synthesis from a file and finer control over voice styles, prosody, and other settings, see [How to synthesize speech](~/articles/cognitive-services/speech-service/how-to-speech-synthesis.md) and [Improve synthesis with Speech Synthesis Markup Language (SSML)](~/articles/cognitive-services/speech-service/speech-synthesis-markup.md).
-- For information about batch synthesis, see [Synthesize long-form text to speech](~/articles/cognitive-services/speech-service/long-audio-api.md). 
+- For information about synthesizing long-form text to speech, see [batch synthesis](~/articles/cognitive-services/speech-service/batch-synthesis.md). 
 
 ## Clean up resources
 

articles/cognitive-services/Speech-Service/includes/quickstarts/text-to-speech-basics/cpp.md

@@ -129,7 +129,7 @@ Now that you've completed the quickstart, here are some additional consideration
 
 This quickstart uses the `SpeakTextAsync` operation to synthesize a short block of text that you enter. You can also get text from files as described in these guides:
 - For information about speech synthesis from a file and finer control over voice styles, prosody, and other settings, see [How to synthesize speech](~/articles/cognitive-services/speech-service/how-to-speech-synthesis.md) and [Improve synthesis with Speech Synthesis Markup Language (SSML)](~/articles/cognitive-services/speech-service/speech-synthesis-markup.md).
-- For information about batch synthesis, see [Synthesize long-form text to speech](~/articles/cognitive-services/speech-service/long-audio-api.md). 
+- For information about synthesizing long-form text to speech, see [batch synthesis](~/articles/cognitive-services/speech-service/batch-synthesis.md). 
 
 ## Clean up resources
 

articles/cognitive-services/Speech-Service/includes/quickstarts/text-to-speech-basics/csharp.md

@@ -155,7 +155,7 @@ Now that you've completed the quickstart, here are some additional consideration
 
 This quickstart uses the `SpeakTextAsync` operation to synthesize a short block of text that you enter. You can also get text from files as described in these guides:
 - For information about speech synthesis from a file and finer control over voice styles, prosody, and other settings, see [How to synthesize speech](~/articles/cognitive-services/speech-service/how-to-speech-synthesis.md) and [Improve synthesis with Speech Synthesis Markup Language (SSML)](~/articles/cognitive-services/speech-service/speech-synthesis-markup.md).
-- For information about batch synthesis, see [Synthesize long-form text to speech](~/articles/cognitive-services/speech-service/long-audio-api.md). 
+- For information about synthesizing long-form text to speech, see [batch synthesis](~/articles/cognitive-services/speech-service/batch-synthesis.md). 
 
 ## Clean up resources