V-Blaze and V-Cloud Online Help

V‑Cloud Transcription with Node.js
POST https://vcloud.vocitec.com/transcribe

Request

Description

Response:

{"requestid":"700e7496-4fce-4963-aa7b-b3b26600f813"}
var axios = require('axios');
var FormData = require('form-data');
var fs = require('fs');

var data = new FormData();
data.append('token', 'yourTokenHere');  1
data.append('file', fs.createReadStream('yourFileHere'), contentType: 'audio/x-wav');  2
data.append('output', 'text'); 3

var options = {
  method: 'POST',
  url: 'https://vcloud.vocitec.com/transcribe',
  headers: {
    ...data.getHeaders()
  },
  data: data
};

axios(options)
.then(function (response) {
  console.log(JSON.stringify(response.data));  4
})
.catch(function (error) {
  console.log(error);
});

1

Replace the generic token value with a valid authorization token.

2

Replace the generic filename value with the directory path and filename of the audio to transcribe.

3

Define transcription parameters by appending them to the data variable. The syntax for transcription parameters is 'parameter-name': 'parameter-value'. Refer to V‑Cloud Transcription Parameters for more information.

4

Returns a requestid for access to the results link from the /transcribe/result endpoint.

GET https://vcloud.vocitec.com/transcribe/result

Request

Description

Response:

"https://vcloud-download.s3.amazonaws.com/a7406862-9811-4c81-a896-81abd4705a4f-zip?X-Amz-Security-Token=FQ...3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20180130T193649Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=ASIAIDW6XGGVYD5XLVFA%2F20180130%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=0a2562c15863a909490e44f7968a281489bb5b5b294c5bd93d1ad5701e0fd68a"
var axios = require('axios');
var token = 'yourTokenHere';  1
var requestid = 'yourRequestIdHere';  2

var options = {
  method: 'GET',
  url: 'https://vcloud.vocitec.com/transcribe/result?token=' + token + '&requestid=' + requestid,
  headers: { }
};

axios(options)
.then(function (response) {
  console.log(JSON.stringify(response.data)); 3
})
.catch(function (error) {
  console.log(error);
});

1

Replace the generic token value with a valid authorization token.

2

Replace the generic requestid value with a requestid returned from a successful request to the /transcribe endpoint.

3

Returns a link to access completed transcripts.

Results

Request

Description

Response:

Thank you for calling Center point energy technical support. I understand you need to report a gas leak can I have your name please. My name is John. Thank you Mr. Know. What is your address or account number my address is and and Lamar and Houston Texas is there. Anyone inside the house now everyone is out of the house. I notice the strange smell when I got home and I called you. Hi, I'm sending it gas technician to your home to fix the problem. Can you give me a good number to reach you at. You can call 281-953-4507. Thank you, please be safe and wait for the technician to arrive call us back if anything changes.Thank you, bye. Good bye and thank you for calling Center point energy.
var axios = require('axios');

var options = {
  method: 'GET',
  url: 'linkToTranscriptHere'  1
};

axios(options)
.then(function (response) {
  console.log(JSON.stringify(response.data));  2
})
.catch(function (error) {
  console.log(error);
});

1

Replace the generic url value with a results link returned from the /transcribe/result endpoint.

2

Returns a complete transcript of the audio in text format.