Skip to content

Commit 500834f

Browse files
Merge pull request #247079 from alexeyo26/alexeyo/byos-batch-fix
[Azure AI Svcs] Speech. BYOS. Fix for batch transcription.
2 parents 44b0789 + 80e1e1a commit 500834f

File tree

1 file changed

+14
-4
lines changed

1 file changed

+14
-4
lines changed

articles/ai-services/speech-service/bring-your-own-storage-speech-resource-speech-to-text.md

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ BYOS-associated Storage account stores the following data:
4242

4343
**Custom Speech**
4444
- Source files of datasets for model training and testing (optional)
45-
- All data and metadata related to Custom models hosted by the BYOS-enabled Speech resource
45+
- All data and metadata related to Custom models hosted by the BYOS-enabled Speech resource (including copies of datasets for model training and testing)
4646

4747
## Batch transcription
4848

@@ -57,7 +57,16 @@ Perform these steps to execute Batch transcription with BYOS-enabled Speech reso
5757
>
5858
> If you use `destinationContainerUrl` parameter, it will work, but provide significantly less security for your data, because of ad hoc SAS usage. See details [here](batch-transcription-create.md#destination-container-url).
5959
60-
1. When transcription is complete, get transcription results according to [this guide](batch-transcription-get.md) or directly in the `TranscriptionData` folder of `customspeech-artifacts` Blob container in the BYOS-associated Storage account.
60+
1. When transcription is complete, get transcription results according to [this guide](batch-transcription-get.md). Consider using `sasValidityInSeconds` parameter (see the following section).
61+
62+
Speech service uses `customspeech-artifacts` Blob container in the BYOS-associated Storage account for storing intermediate and final transcription results.
63+
64+
> [!CAUTION]
65+
> Speech service relies on pre-defined Blob container paths and file names for Batch transcription module to correctly function. Don't move, rename or in any way alter the contents of `customspeech-artifacts` container.
66+
>
67+
> Failure to do so very likely will result in hard to debug 4xx and 5xx Service errors.
68+
>
69+
> Use standard tools to interact with Batch transcription. See details in [Batch transcription section](batch-transcription.md).
6170
6271
### Get Batch transcription results via REST API
6372

@@ -122,14 +131,15 @@ There's nothing specific about how you use Custom Speech with BYOS-enabled Speec
122131

123132
- `customspeech-models` - Location of Custom Speech models
124133
- `customspeech-artifacts` - Location of all other Custom Speech related data
125-
- Custom Speech data is located in all subfolders of the container, except for `TranscriptionData`. This subfolder contains Batch transcription results.
134+
135+
Note that the Blob container structure is provided for your information only and subject to change without a notice.
126136

127137
> [!CAUTION]
128138
> Speech service relies on pre-defined Blob container paths and file names for Custom Speech module to correctly function. Don't move, rename or in any way alter the contents of `customspeech-models` container and Custom Speech related folders of `customspeech-artifacts` container.
129139
>
130140
> Failure to do so very likely will result in hard to debug errors and may lead to the necessity of custom model retraining.
131141
>
132-
> Use standard tools, like REST API and Speech Studio to interact with the Custom Speech related data. See detail in [Custom Speech section](custom-speech-overview.md).
142+
> Use standard tools, like REST API and Speech Studio to interact with the Custom Speech related data. See details in [Custom Speech section](custom-speech-overview.md).
133143
134144
### Use of REST API with Custom Speech
135145

0 commit comments

Comments
 (0)