Skip to content

Commit b04641d

Browse files
committed
replace subscription terminology with speech resource
1 parent 8ea9235 commit b04641d

Some content is hidden

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

50 files changed

+162
-162
lines changed

articles/ai-services/speech-service/audio-processing-speech-sdk.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ var recognizer = new SpeechRecognizer(speechConfig, audioInput);
3939
### [C++](#tab/cpp)
4040

4141
```cpp
42-
auto speechConfig = SpeechConfig::FromEndpoint("YourServiceEndpoint", "YourSubscriptionKey");
42+
auto speechConfig = SpeechConfig::FromEndpoint("YourServiceEndpoint", "YourSpeechResoureKey");
4343

4444
auto audioProcessingOptions = AudioProcessingOptions::Create(AUDIO_INPUT_PROCESSING_ENABLE_DEFAULT);
4545
auto audioInput = AudioConfig::FromDefaultMicrophoneInput(audioProcessingOptions);
@@ -80,7 +80,7 @@ var recognizer = new SpeechRecognizer(speechConfig, audioInput);
8080
### [C++](#tab/cpp)
8181

8282
```cpp
83-
auto speechConfig = SpeechConfig::FromEndpoint("YourServiceEndpoint", "YourSubscriptionKey");
83+
auto speechConfig = SpeechConfig::FromEndpoint("YourServiceEndpoint", "YourSpeechResoureKey");
8484

8585
auto audioProcessingOptions = AudioProcessingOptions::Create(AUDIO_INPUT_PROCESSING_ENABLE_DEFAULT, PresetMicrophoneArrayGeometry::Linear2);
8686
auto audioInput = AudioConfig::FromMicrophoneInput("hw:0,1", audioProcessingOptions);
@@ -132,7 +132,7 @@ var recognizer = new SpeechRecognizer(speechConfig, audioInput);
132132
### [C++](#tab/cpp)
133133

134134
```cpp
135-
auto speechConfig = SpeechConfig::FromEndpoint("YourServiceEndpoint", "YourSubscriptionKey");
135+
auto speechConfig = SpeechConfig::FromEndpoint("YourServiceEndpoint", "YourSpeechResoureKey");
136136

137137
MicrophoneArrayGeometry microphoneArrayGeometry
138138
{
@@ -188,7 +188,7 @@ var recognizer = new SpeechRecognizer(speechConfig, audioInput);
188188
### [C++](#tab/cpp)
189189

190190
```cpp
191-
auto speechConfig = SpeechConfig::FromEndpoint("YourServiceEndpoint", "YourSubscriptionKey");
191+
auto speechConfig = SpeechConfig::FromEndpoint("YourServiceEndpoint", "YourSpeechResoureKey");
192192

193193
auto audioProcessingOptions = AudioProcessingOptions::Create(AUDIO_INPUT_PROCESSING_DISABLE_ECHO_CANCELLATION | AUDIO_INPUT_PROCESSING_DISABLE_NOISE_SUPPRESSION | AUDIO_INPUT_PROCESSING_ENABLE_DEFAULT);
194194
auto audioInput = AudioConfig::FromDefaultMicrophoneInput(audioProcessingOptions);
@@ -241,7 +241,7 @@ var recognizer = new SpeechRecognizer(speechConfig, audioInput);
241241
### [C++](#tab/cpp)
242242

243243
```cpp
244-
auto speechConfig = SpeechConfig::FromEndpoint("YourServiceEndpoint", "YourSubscriptionKey");
244+
auto speechConfig = SpeechConfig::FromEndpoint("YourServiceEndpoint", "YourSpeechResoureKey");
245245

246246
MicrophoneArrayGeometry microphoneArrayGeometry
247247
{

articles/ai-services/speech-service/batch-transcription-create.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -41,12 +41,12 @@ For more information, see [Request configuration options](#request-configuration
4141

4242
Make an HTTP POST request that uses the URI as shown in the following [Transcriptions_Create](/rest/api/speechtotext/transcriptions/create) example.
4343

44-
- Replace `YourSubscriptionKey` with your Speech resource key.
44+
- Replace `YourSpeechResoureKey` with your Speech resource key.
4545
- Replace `YourServiceRegion` with your Speech resource region.
4646
- Set the request body properties as previously described.
4747

4848
```azurecli-interactive
49-
curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
49+
curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSpeechResoureKey" -H "Content-Type: application/json" -d '{
5050
"contentUrls": [
5151
"https://crbn.us/hello.wav",
5252
"https://crbn.us/whatstheweatherlike.wav"
@@ -215,7 +215,7 @@ Optionally, you can modify the previous [create transcription example](#create-a
215215
::: zone pivot="rest-api"
216216

217217
```azurecli-interactive
218-
curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
218+
curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSpeechResoureKey" -H "Content-Type: application/json" -d '{
219219
"contentUrls": [
220220
"https://crbn.us/hello.wav",
221221
"https://crbn.us/whatstheweatherlike.wav"
@@ -263,16 +263,16 @@ To use a Whisper model for batch transcription, you need to set the `model` prop
263263
::: zone pivot="rest-api"
264264
You can make a [Models_ListBaseModels](/rest/api/speechtotext/models/list-base-models) request to get available base models for all locales.
265265

266-
Make an HTTP GET request as shown in the following example for the `eastus` region. Replace `YourSubscriptionKey` with your Speech resource key. Replace `eastus` if you're using a different region.
266+
Make an HTTP GET request as shown in the following example for the `eastus` region. Replace `YourSpeechResoureKey` with your Speech resource key. Replace `eastus` if you're using a different region.
267267

268268
```azurecli-interactive
269-
curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
269+
curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base" -H "Ocp-Apim-Subscription-Key: YourSpeechResoureKey"
270270
```
271271

272272
By default, only the 100 oldest base models are returned. Use the `skip` and `top` query parameters to page through the results. For example, the following request returns the next 100 base models after the first 100.
273273

274274
```azurecli-interactive
275-
curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base?skip=100&top=100" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
275+
curl -v -X GET "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base?skip=100&top=100" -H "Ocp-Apim-Subscription-Key: YourSpeechResoureKey"
276276
```
277277

278278
::: zone-end
@@ -323,10 +323,10 @@ The `displayName` property of a Whisper model contains "Whisper" as shown in thi
323323

324324
::: zone pivot="rest-api"
325325

326-
You set the full model URI as shown in this example for the `eastus` region. Replace `YourSubscriptionKey` with your Speech resource key. Replace `eastus` if you're using a different region.
326+
You set the full model URI as shown in this example for the `eastus` region. Replace `YourSpeechResoureKey` with your Speech resource key. Replace `eastus` if you're using a different region.
327327

328328
```azurecli-interactive
329-
curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
329+
curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSpeechResoureKey" -H "Content-Type: application/json" -d '{
330330
"contentUrls": [
331331
"https://crbn.us/hello.wav",
332332
"https://crbn.us/whatstheweatherlike.wav"

articles/ai-services/speech-service/batch-transcription-get.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -25,10 +25,10 @@ To get the status of the transcription job, call the [Transcriptions_Get](/rest/
2525
> [!IMPORTANT]
2626
> Batch transcription jobs are scheduled on a best-effort basis. At peak hours, it may take up to 30 minutes or longer for a transcription job to start processing. Most of the time during the execution the transcription status will be `Running`. This is because the job is assigned the `Running` status the moment it moves to the batch transcription backend system. When the base model is used, this assignment happens almost immediately; it's slightly slower for custom models. Thus, the amount of time a transcription job spends in the `Running` state doesn't correspond to the actual transcription time but also includes waiting time in the internal queues.
2727
28-
Make an HTTP GET request using the URI as shown in the following example. Replace `YourTranscriptionId` with your transcription ID, replace `YourSubscriptionKey` with your Speech resource key, and replace `YourServiceRegion` with your Speech resource region.
28+
Make an HTTP GET request using the URI as shown in the following example. Replace `YourTranscriptionId` with your transcription ID, replace `YourSpeechResoureKey` with your Speech resource key, and replace `YourServiceRegion` with your Speech resource region.
2929

3030
```azurecli-interactive
31-
curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/YourTranscriptionId" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
31+
curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/YourTranscriptionId" -H "Ocp-Apim-Subscription-Key: YourSpeechResoureKey"
3232
```
3333

3434
You should receive a response body in the following format:
@@ -136,10 +136,10 @@ spx help batch transcription
136136

137137
The [Transcriptions_ListFiles](/rest/api/speechtotext/transcriptions/list-files) operation returns a list of result files for a transcription. A [transcription report](#transcription-report-file) file is provided for each submitted batch transcription job. In addition, one [transcription](#transcription-result-file) file (the end result) is provided for each successfully transcribed audio file.
138138

139-
Make an HTTP GET request using the "files" URI from the previous response body. Replace `YourTranscriptionId` with your transcription ID, replace `YourSubscriptionKey` with your Speech resource key, and replace `YourServiceRegion` with your Speech resource region.
139+
Make an HTTP GET request using the "files" URI from the previous response body. Replace `YourTranscriptionId` with your transcription ID, replace `YourSpeechResoureKey` with your Speech resource key, and replace `YourServiceRegion` with your Speech resource region.
140140

141141
```azurecli-interactive
142-
curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/YourTranscriptionId/files" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
142+
curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/YourTranscriptionId/files" -H "Ocp-Apim-Subscription-Key: YourSpeechResoureKey"
143143
```
144144

145145
You should receive a response body in the following format:

articles/ai-services/speech-service/fast-transcription-create.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -47,17 +47,17 @@ Make a multipart/form-data POST request to the `transcriptions` endpoint with th
4747

4848
The following example shows how to transcribe an audio file with a specified locale. If you know the locale of the audio file, you can specify it to improve transcription accuracy and minimize the latency.
4949

50-
- Replace `YourSubscriptionKey` with your Speech resource key.
50+
- Replace `YourSpeechResoureKey` with your Speech resource key.
5151
- Replace `YourServiceRegion` with your Speech resource region.
5252
- Replace `YourAudioFile` with the path to your audio file.
5353

5454
> [!IMPORTANT]
55-
> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
55+
> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSpeechResoureKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
5656
5757
```azurecli-interactive
5858
curl --location 'https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15' \
5959
--header 'Content-Type: multipart/form-data' \
60-
--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey' \
60+
--header 'Ocp-Apim-Subscription-Key: YourSpeechResoureKey' \
6161
--form 'audio=@"YourAudioFile"' \
6262
--form 'definition="{
6363
"locales":["en-US"]}"'
@@ -301,17 +301,17 @@ The following example shows how to transcribe an audio file with language identi
301301
> [!NOTE]
302302
> The language identification in fast transcription is designed to identify one main language locale per audio file. If you need to transcribe multi-lingual contents in the audio, please consider [multi-lingual transcription (preview)](?tabs=multilingual-transcription-on).
303303
304-
- Replace `YourSubscriptionKey` with your Speech resource key.
304+
- Replace `YourSpeechResoureKey` with your Speech resource key.
305305
- Replace `YourServiceRegion` with your Speech resource region.
306306
- Replace `YourAudioFile` with the path to your audio file.
307307

308308
> [!IMPORTANT]
309-
> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
309+
> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSpeechResoureKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
310310
311311
```azurecli-interactive
312312
curl --location 'https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15' \
313313
--header 'Content-Type: multipart/form-data' \
314-
--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey' \
314+
--header 'Ocp-Apim-Subscription-Key: YourSpeechResoureKey' \
315315
--form 'audio=@"YourAudioFile"' \
316316
--form 'definition="{
317317
"locales":["en-US","ja-JP"]}"'
@@ -590,17 +590,17 @@ Make a multipart/form-data POST request to the `transcriptions` endpoint with th
590590

591591
The following example shows how to transcribe an audio file with the latest multi-lingual speech transcription model. If your audio contains multi-lingual contents that you want to transcribe continuously and accurately, you can use the latest multi-lingual speech transcription model without specifying the locale codes.
592592

593-
- Replace `YourSubscriptionKey` with your Speech resource key.
593+
- Replace `YourSpeechResoureKey` with your Speech resource key.
594594
- Replace `YourServiceRegion` with your Speech resource region.
595595
- Replace `YourAudioFile` with the path to your audio file.
596596

597597
> [!IMPORTANT]
598-
> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
598+
> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSpeechResoureKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
599599
600600
```azurecli-interactive
601601
curl --location 'https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15' \
602602
--header 'Content-Type: multipart/form-data' \
603-
--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey' \
603+
--header 'Ocp-Apim-Subscription-Key: YourSpeechResoureKey' \
604604
--form 'audio=@"YourAudioFile"' \
605605
--form 'definition="{
606606
"locales":[]}"'
@@ -1205,17 +1205,17 @@ Make a multipart/form-data POST request to the `transcriptions` endpoint with th
12051205

12061206
The following example shows how to transcribe an audio file with diarization enabled. Diarization distinguishes between different speakers in the conversation. The Speech service provides information about which speaker was speaking a particular part of the transcribed speech.
12071207

1208-
- Replace `YourSubscriptionKey` with your Speech resource key.
1208+
- Replace `YourSpeechResoureKey` with your Speech resource key.
12091209
- Replace `YourServiceRegion` with your Speech resource region.
12101210
- Replace `YourAudioFile` with the path to your audio file.
12111211

12121212
> [!IMPORTANT]
1213-
> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
1213+
> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSpeechResoureKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
12141214
12151215
```azurecli-interactive
12161216
curl --location 'https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15' \
12171217
--header 'Content-Type: multipart/form-data' \
1218-
--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey' \
1218+
--header 'Ocp-Apim-Subscription-Key: YourSpeechResoureKey' \
12191219
--form 'audio=@"YourAudioFile"' \
12201220
--form 'definition="{
12211221
"locales":["en-US"],
@@ -1477,17 +1477,17 @@ Make a multipart/form-data POST request to the `transcriptions` endpoint with th
14771477

14781478
The following example shows how to transcribe an audio file that has one or two channels. Multi-channel transcriptions are useful for audio files with multiple channels, such as audio files with multiple speakers or audio files with background noise. By default, the fast transcription API merges all input channels into a single channel and then performs the transcription. If this isn't desirable, channels can be transcribed independently without merging.
14791479

1480-
- Replace `YourSubscriptionKey` with your Speech resource key.
1480+
- Replace `YourSpeechResoureKey` with your Speech resource key.
14811481
- Replace `YourServiceRegion` with your Speech resource region.
14821482
- Replace `YourAudioFile` with the path to your audio file.
14831483

14841484
> [!IMPORTANT]
1485-
> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
1485+
> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSpeechResoureKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
14861486
14871487
```azurecli-interactive
14881488
curl --location 'https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15' \
14891489
--header 'Content-Type: multipart/form-data' \
1490-
--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey' \
1490+
--header 'Ocp-Apim-Subscription-Key: YourSpeechResoureKey' \
14911491
--form 'audio=@"YourAudioFile"' \
14921492
--form 'definition="{
14931493
"locales":["en-US"],

0 commit comments

Comments
 (0)