Skip to content

Commit a75590d

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into designresiliency
2 parents 2babf6d + 541624b commit a75590d

File tree

353 files changed

+3103
-8386
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

353 files changed

+3103
-8386
lines changed

.openpublishing.redirection.json

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3918,6 +3918,11 @@
39183918
"source_path_from_root": "/articles/storage/common/storage-account-move.md",
39193919
"redirect_url": "/azure/operational-excellence/relocation-storage-account",
39203920
"redirect_document_id": false
3921+
},
3922+
{
3923+
"source_path_from_root": "/articles/defender-for-iot/organizations/update-legacy-ot-software.md",
3924+
"redirect_url": "/azure/defender-for-iot/organizations/update-ot-software?tabs=portal",
3925+
"redirect_document_id": false
39213926
}
39223927
]
3923-
}
3928+
}

articles/ai-services/openai/includes/chat-markup-language.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ keywords: ChatGPT
1414
## Working with the Chat models
1515

1616
> [!IMPORTANT]
17-
> Using GPT-35-Turbo models with the completion endpoint remains in preview. Due to the potential for changes to the underlying ChatML syntax, we strongly recommend using the Chat Completion API/endpoint. The Chat Completion API is the recommended method of interacting with the GPT-35-Turbo models. The Chat Completion API is also the only way to access the GPT-4 models.
17+
> Using GPT-35-Turbo models with the completion endpoint as described in this article remains in preview and is only possible with gpt-35-turbo verision (0301). We strongly recommend using the GA Chat Completion API/endpoint. The Chat Completion API is the recommended method of interacting with the GPT-35-Turbo models. The Chat Completion API is also the only way to access the GPT-4 models.
1818
1919
The following code snippet shows the most basic way to use the GPT-35-Turbo models with ChatML. If this is your first time using these models programmatically we recommend starting with our [GPT-35-Turbo & GPT-4 Quickstart](../chatgpt-quickstart.md).
2020

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

Lines changed: 41 additions & 43 deletions
Large diffs are not rendered by default.

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

Lines changed: 150 additions & 181 deletions
Large diffs are not rendered by default.

articles/ai-services/speech-service/migrate-to-batch-synthesis.md

Lines changed: 36 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -14,30 +14,36 @@ ms.custom: devx-track-csharp
1414

1515
# Migrate code from Long Audio API to Batch synthesis API
1616

17-
The [Batch synthesis API](batch-synthesis.md) (Preview) provides asynchronous synthesis of long-form text to speech. This article describes the benefits of upgrading from Long Audio API to Batch synthesis API, and details about how to do so.
17+
The [Batch synthesis API](batch-synthesis.md) provides asynchronous synthesis of long-form text to speech. This article describes the benefits of upgrading from Long Audio API to Batch synthesis API, and details about how to do so.
1818

1919
> [!IMPORTANT]
20-
> [Batch synthesis API](batch-synthesis.md) is currently in public preview. Once it's generally available, the Long Audio API will be deprecated.
20+
> [Batch synthesis API](batch-synthesis.md) is generally available. the Long Audio API will be retired on April 1st, 2027.
2121
22-
## Base path
22+
## Base path and version
2323

24-
You must update the base path in your code from `/texttospeech/v3.0/longaudiosynthesis` to `/texttospeech/3.1-preview1/batchsynthesis`. For example, to list synthesis jobs for your Speech resource in the `eastus` region, use `https://eastus.customvoice.api.speech.microsoft.com/api/texttospeech/3.1-preview1/batchsynthesis` instead of `https://eastus.customvoice.api.speech.microsoft.com/api/texttospeech/v3.0/longaudiosynthesis`.
24+
Update the endpoint from `https://YourSpeechRegion.customvoice.api.speech.microsoft.com` to `https://YourSpeechRegion.api.cognitive.microsoft.com` or you can use custom domain instead: `https://{customDomainName}.cognitiveservices.azure.com/`.
25+
26+
Update the base path in your code from `/texttospeech/v3.0/longaudiosynthesis` to `/texttospeech/batchsyntheses`.
27+
28+
Update the version from base path to query string `/texttospeech/v3.0/longaudiosynthesis` to `?api-version=2024-04-01`.
29+
30+
For example, to list synthesis jobs for your Speech resource in the `eastus` region, use `https://eastus.api.cognitive.microsoft.com/texttospeech/batchsyntheses?api-version=2024-04-01` instead of `https://eastus.customvoice.api.speech.microsoft.com/api/texttospeech/v3.0/longaudiosynthesis`.
2531

2632
## Regions and endpoints
2733

28-
Batch synthesis API is available in all [Speech regions](regions.md).
34+
Batch synthesis API is available in more [Speech regions](regions.md).
2935

3036
The Long Audio API is limited to the following regions:
3137

32-
| Region | Endpoint |
33-
|--------|----------|
34-
| Australia East | `https://australiaeast.customvoice.api.speech.microsoft.com` |
35-
| East US | `https://eastus.customvoice.api.speech.microsoft.com` |
36-
| India Central | `https://centralindia.customvoice.api.speech.microsoft.com` |
38+
| Region | Endpoint |
39+
| ---------------- | ------------------------------------------------------------- |
40+
| Australia East | `https://australiaeast.customvoice.api.speech.microsoft.com` |
41+
| East US | `https://eastus.customvoice.api.speech.microsoft.com` |
42+
| India Central | `https://centralindia.customvoice.api.speech.microsoft.com` |
3743
| South Central US | `https://southcentralus.customvoice.api.speech.microsoft.com` |
38-
| Southeast Asia | `https://southeastasia.customvoice.api.speech.microsoft.com` |
39-
| UK South | `https://uksouth.customvoice.api.speech.microsoft.com` |
40-
| West Europe | `https://westeurope.customvoice.api.speech.microsoft.com` |
44+
| Southeast Asia | `https://southeastasia.customvoice.api.speech.microsoft.com` |
45+
| UK South | `https://uksouth.customvoice.api.speech.microsoft.com` |
46+
| West Europe | `https://westeurope.customvoice.api.speech.microsoft.com` |
4147

4248
## Voices list
4349

@@ -47,11 +53,12 @@ The Long Audio API is limited to the set of voices returned by a GET request to
4753

4854
## Text inputs
4955

50-
Batch synthesis text inputs are sent in a JSON payload of up to 500 kilobytes.
56+
Batch synthesis text inputs are sent in a JSON payload of up to 2 megabytes.
5157

5258
Long Audio API text inputs are uploaded from a file that meets the following requirements:
53-
* One plain text (.txt) or SSML text (.txt) file encoded as [UTF-8 with Byte Order Mark (BOM)](https://www.w3.org/International/questions/qa-utf8-bom.en#bom). Don't use compressed files such as ZIP. If you have more than one input file, you must submit multiple requests.
54-
* Contains more than 400 characters for plain text or 400 [billable characters](./text-to-speech.md#pricing-note) for SSML text, and less than 10,000 paragraphs. For plain text, each paragraph is separated by a new line. For SSML text, each SSML piece is considered a paragraph. Separate SSML pieces by different paragraphs.
59+
60+
- One plain text (.txt) or SSML text (.txt) file encoded as [UTF-8 with Byte Order Mark (BOM)](https://www.w3.org/International/questions/qa-utf8-bom.en#bom). Don't use compressed files such as ZIP. If you have more than one input file, you must submit multiple requests.
61+
- Contains more than 400 characters for plain text or 400 [billable characters](./text-to-speech.md#pricing-note) for SSML text, and less than 10,000 paragraphs. For plain text, each paragraph is separated by a new line. For SSML text, each SSML piece is considered a paragraph. Separate SSML pieces by different paragraphs.
5562

5663
With Batch synthesis API, you can use any of the [supported SSML elements](speech-synthesis-markup.md), including the `audio`, `mstts:backgroundaudio`, and `lexicon` elements. The long audio API doesn't support the `audio`, `mstts:backgroundaudio`, and `lexicon` elements.
5764

@@ -61,28 +68,28 @@ Batch synthesis API supports all [text to speech audio output formats](rest-text
6168

6269
The Long Audio API is limited to the following set of audio output formats. The sample rate for long audio voices is 24kHz, not 48kHz. Other sample rates can be obtained through upsampling or downsampling when synthesizing.
6370

64-
* riff-8khz-16bit-mono-pcm
65-
* riff-16khz-16bit-mono-pcm
66-
* riff-24khz-16bit-mono-pcm
67-
* riff-48khz-16bit-mono-pcm
68-
* audio-16khz-32kbitrate-mono-mp3
69-
* audio-16khz-64kbitrate-mono-mp3
70-
* audio-16khz-128kbitrate-mono-mp3
71-
* audio-24khz-48kbitrate-mono-mp3
72-
* audio-24khz-96kbitrate-mono-mp3
73-
* audio-24khz-160kbitrate-mono-mp3
71+
- riff-8khz-16bit-mono-pcm
72+
- riff-16khz-16bit-mono-pcm
73+
- riff-24khz-16bit-mono-pcm
74+
- riff-48khz-16bit-mono-pcm
75+
- audio-16khz-32kbitrate-mono-mp3
76+
- audio-16khz-64kbitrate-mono-mp3
77+
- audio-16khz-128kbitrate-mono-mp3
78+
- audio-24khz-48kbitrate-mono-mp3
79+
- audio-24khz-96kbitrate-mono-mp3
80+
- audio-24khz-160kbitrate-mono-mp3
7481

7582
## Getting results
7683

77-
With batch synthesis API, use the URL from the `outputs.result` property of the HTTP GET batch synthesis response. The [results](batch-synthesis.md#batch-synthesis-results) are in a ZIP file that contains the audio (such as `0001.wav`), summary, and debug details.
84+
With batch synthesis API, use the URL from the `outputs.result` property of the HTTP GET batch synthesis response. The [results](batch-synthesis.md#batch-synthesis-results) are in a ZIP file that contains the audio (such as `0001.wav`), summary, and debug details.
7885

7986
Long Audio API text inputs and results are returned via two separate content URLs as shown in the following example. The one with `"kind": "LongAudioSynthesisScript"` is the input script submitted. The other one with `"kind": "LongAudioSynthesisResult"` is the result of this request. Both ZIP files can be downloaded from the URL in their `links.contentUrl` property.
8087

8188
## Cleaning up resources
8289

83-
Batch synthesis API supports up to 200 batch synthesis jobs that don't have a status of "Succeeded" or "Failed". The Speech service keeps each synthesis history for up to 31 days, or the duration of the request `timeToLive` property, whichever comes sooner. The date and time of automatic deletion (for synthesis jobs with a status of "Succeeded" or "Failed") is equal to the `lastActionDateTime` + `timeToLive` properties.
90+
Batch synthesis API supports up to 300 batch synthesis jobs that don't have a status of "Succeeded" or "Failed". The Speech service keeps each synthesis history for up to 31 days, or the duration of the request `timeToLiveInHours` property, whichever comes sooner. The date and time of automatic deletion (for synthesis jobs with a status of "Succeeded" or "Failed") is equal to the `lastActionDateTime` + `timeToLiveInHours` properties.
8491

85-
The Long Audio API is limited to 20,000 requests for each Azure subscription account. The Speech service doesn't remove job history automatically. You must remove the previous job run history before making new requests that would otherwise exceed the limit.
92+
The Long Audio API is limited to 20,000 requests for each Azure subscription account. The Speech service doesn't remove job history automatically. You must remove the previous job run history before making new requests that would otherwise exceed the limit.
8693

8794
## Next steps
8895

0 commit comments

Comments
 (0)