Skip to content

Commit 89f0287

Browse files
authored
Merge pull request #110263 from oscholz/patch-13
Moved Swagger auto generation Tip
2 parents f3f92e7 + 2f2f610 commit 89f0287

File tree

1 file changed

+11
-3
lines changed

1 file changed

+11
-3
lines changed

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

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,17 @@ Batch transcription jobs are scheduled on a best effort basis. Currently there i
3838

3939
Next to the easy-to-use API, you don't need to deploy custom endpoints, and you don't have any concurrency requirements to observe.
4040

41+
> [!TIP]
42+
> You can use the Swagger Editor to automatically generate client libraries for the batch transcription REST API. Thus Batch transcription can be used from nearly any programming language or environment that supports REST.<br>
43+
> For example, to generate a Batch transcription client library.
44+
> 1. Copy the example URL below:
45+
> ```http
46+
> https://westus.cris.ai/docs/v2.0/swagger
47+
> ```
48+
> 1. Navigate to the <a href="https://editor.swagger.io/" target="_blank">**Swagger Editor** <span class="docon docon-navigate-external x-hidden-focus"></span></a>
49+
> 1. Select **File** > **Import URL** and paste the URL
50+
> 1. Select **Generate Client** and choose your desired programming language
51+
4152
## Prerequisites
4253
4354
### Subscription Key
@@ -300,9 +311,6 @@ The transcription service can handle large number of submitted transcriptions. Y
300311

301312
Complete samples are available in the [GitHub sample repository](https://aka.ms/csspeech/samples) inside the `samples/batch` subdirectory.
302313

303-
> [!NOTE]
304-
> Batch transcription functionality is exposed via the REST API described above. Thus Batch transcription can be used from nearly any programming language or environment that supports REST. The examples below and samples in GitHub are merely representative and **do not** connote limits on where the API can be used.
305-
306314
You have to customize the sample code with your subscription information, the service region, the SAS URI pointing to the audio file to transcribe, and model IDs in case you want to use a custom acoustic or language model.
307315

308316
[!code-csharp[Configuration variables for batch transcription](~/samples-cognitive-services-speech-sdk/samples/batch/csharp/program.cs#batchdefinition)]

0 commit comments

Comments
 (0)