Skip to content

Commit 4f782e4

Browse files
committed
Added a table and edited content
1 parent 58cd62a commit 4f782e4

File tree

1 file changed

+17
-8
lines changed

1 file changed

+17
-8
lines changed

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

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,16 +14,25 @@ ms.author: wolfma
1414

1515
# What is batch transcription?
1616

17-
Batch transcription is ideal for transcribing a large amount of audio in storage. By using the dedicated REST API, you can point to audio files with a shared access signature (SAS) URI and asynchronously receive transcription results.
17+
Batch transcription is a set of REST API operations that enables users to transcribe a large amount of audio in storage. Users can point to audio files with a shared access signature (SAS) URI and asynchronously receive transcription results in return.
1818

19-
The API offers asynchronous speech-to-text transcription and other features. You can use REST API to expose methods to:
19+
Asynchronous speech-to-text transcription is just one of the features. You can use batch transcription REST APIs to call the following methods:
2020

21-
- Create a batch processing requests
22-
- Query the status
23-
- Download transcription results
24-
- Delete transcription information from the service
2521

26-
The detailed API is available as a [Swagger document](https://westus.cris.ai/swagger/ui/index#/Custom%20Speech%20transcriptions%3A), under the heading `Custom Speech transcriptions`.
22+
23+
| Batch Transcription Operation | Method | REST API Call |
24+
|--------------------------------------------------------------------------------|--------------|----------------------------------------------------|
25+
| Creates a new transcription. | POST | api/speechtotext/v2.0/transcriptions |
26+
| Retrieves a list of transcriptions for the authenticated subscription. | GET | api/speechtotext/v2.0/transcriptions |
27+
| Gets a list of supported locales for offline transcriptions. | GET | api/speechtotext/v2.0/transcriptions/locales |
28+
| Updates the mutable details of the transcription identified by its ID. | PATCH | api/speechtotext/v2.0/transcriptions/{id} |
29+
| Deletes the specified transcription task. | DELETE | api/speechtotext/v2.0/transcriptions/{id} |
30+
| Gets the transcription identified by the given ID. | GET | api/speechtotext/v2.0/transcriptions/{id} |
31+
32+
33+
34+
35+
You can review and test the detailed API which is available as a [Swagger document](https://westus.cris.ai/swagger/ui/index#/Custom%20Speech%20transcriptions%3A), under the heading `Custom Speech transcriptions`.
2736

2837
Batch transcription jobs are scheduled on a best effort basis. Currently there is no estimate for when a job changes into the running state. Under normal system load, it should happen within minutes. Once in the running state, the actual transcription is processed faster than the audio real time.
2938

@@ -317,4 +326,4 @@ You can find the sample in the `samples/batch` directory in the [GitHub sample r
317326

318327
## Next steps
319328

320-
* [Get your Speech trial subscription](https://azure.microsoft.com/try/cognitive-services/)
329+
- [Get your Speech trial subscription](https://azure.microsoft.com/try/cognitive-services/)

0 commit comments

Comments
 (0)