V-Blaze and V-Cloud Online Help

V‑Cloud REST API Overview

The V‑Cloud API is a collection of REST web services that can be accessed by any programming language capable of performing HTTP POST and GET calls. The endpoint for this service is available at https://vcloud.vocitec.com. Additional endpoints that isolate processing to particular regions (for example, the European Union) are available on request.

Available methods and mandatory parameters for the V‑Cloud API are discussed in Querying V‑Cloud Status and Transcribing Audio Files. V‑Cloud Transcription Parameters has a complete list of all the available V‑Cloud parameters.

Note

All audio file examples use the WAV audio file format , identified by the .wav filename extension. MP3 files are not supported by V‑Cloud unless transcode=true. Refer to Adjusting for Different Types of Input for more information on the transcode parameter.

Web Service Overview

The V‑Cloud API utilizes web services to receive requests and return results. The following image illustrates some web service interactions between your system and the V‑Cloud API.

Figure 1. V‑Cloud Architecture
V‑Cloud Architecture


To transcribe an audio file, send a POST request with a single audio file or a zip file containing multiple audio files. Each successful POST request returns a requestid to retrieve the results in a separate GET request. Alternatively, if you have a callback server set up, the results automatically post to the specified endpoint when the transcription process is complete.

Tip

The callback mechanism is the recommended way to receive transcription results. It provides the shortest turnaround time because no subsequent request is required to retrieve results.