Skip to content

Commit dc89eba

Browse files
author
oliver scholz
authored
Moved Swagger auto generation Tip
Moved the Swagger autogeneration tip from speech-sdk.md to here after a chat with @chrisbasoglu
1 parent 76d2429 commit dc89eba

File tree

1 file changed

+10
-2
lines changed

1 file changed

+10
-2
lines changed

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

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -300,8 +300,16 @@ The transcription service can handle large number of submitted transcriptions. Y
300300

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

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.
303+
> [!TIP]
304+
> You can use the [Swagger Editor](https://editor.swagger.io/) 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.
305+
> For example, to generate a Batch transcription client library.
306+
> 1. Copy the example URL below:
307+
> ```http
308+
> https://westus.cris.ai/docs/v2.0/swagger
309+
> ```
310+
> 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>
311+
> 1. Select **File** > **Import URL** and paste the URL
312+
> 1. Select **Generate Client** and choose your desired programming language
305313
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

0 commit comments

Comments
 (0)