V-Blaze and V-Cloud Online Help (May 2020)

Transcribing Audio Files

The V‑Cloud API is a REST API that consists of two core methods:

  • the /transcribe endpoint enables you to POST an audio file or a zip file containing one or more audio files for transcription. The /transcribe endpoint returns an identifier known as a requestid that identifies the result and can be used for retrieval and tracking.

  • the /transcribe/result endpoint enables you to submit a requestid and retrieve a URL from which you can download a zip or JSON file that contains the transcript(s) of the file(s) that you POSTed to /transcribe. The format of your results depends on the options that you specified in the /transcribe call.

The next few sections provide reference information for and examples of using each of these methods, plus an example of setting up a simple callback server and using it with the /transcribe endpoint.

In this section:

Short for JavaScript Object Notation. Allows for information to be stored in a hierarchical fashion within a single document.

A file format for digitized audio with a RIFF header at the beginning. It is not an audio encoding, and the audio after the RIFF header can be highly compressed or not compressed at all.

The Pulse-Code Modulation audio format

Short for JavaScript Object Notation. Allows for information to be stored in a hierarchical fashion within a single document.

A transcript and associated metadata produced from an audio file, in JSON format. The Voci JSON format is documented in the VociJSON Output Format Guide.

A transcript and associated metadata produced from an audio file, in JSON format. The Voci JSON format is documented in the VociJSON Output Format Guide.

Short for JavaScript Object Notation. Allows for information to be stored in a hierarchical fashion within a single document.

Short for JavaScript Object Notation. Allows for information to be stored in a hierarchical fashion within a single document.

A transcript and associated metadata produced from an audio file, in JSON format. The Voci JSON format is documented in the VociJSON Output Format Guide.

An uninterrupted chain of spoken language by a single speaker. An utterance is a region of speech audio that ends with a period of silence that exceeds a threshold duration, or that exceeds the maximum utterance duration threshold.

Short for JavaScript Object Notation. Allows for information to be stored in a hierarchical fashion within a single document.