​
How Does API Work?

The process to transcribe an audio file:

  • Post the request by:
    • Enter the valid REV-APPNAME, REV-APP-ID, and REV-API-KEY.
    • Define the Language Code and domain.
    • Upload the audio file to transcribe.
    • Define the audio format, if required.
  • The API will return the text in the requested Indian language.

​
cURL for Integration

​
Step 1 : Upload the Audio File

​
Request : Transcribing Audio

curl --location --request POST 'https://revapi.reverieinc.com/' \
--header 'src_lang: hi' \
--header 'domain: generic' \
--header 'REV-API-KEY: <YOUR API KEY>' \
--header 'REV-APPNAME: stt_file' \
--header 'REV-APP-ID: <YOUR API-ID>' \
--form 'audio_file=@"<File Path>"

​
Request: Transcribing Audio other than Default Format

curl --location --request POST 'https://revapi.reverieinc.com/' \
--header 'src_lang: hi' \
--header 'domain: generic' \
--header 'REV-API-KEY: <YOUR API KEY>' \
--header 'REV-APPNAME: stt_file' \
--header 'REV-APP-ID: <YOUR API-ID>' \
--header 'format: mp3'
--form 'audio_file=@"<File Path>"'

​
Response: Success

{
    "id": "ddf4ebda44af4fdf95118af9a6f14d46fce12ed85347471d",
    "success": true,
    "final": true,
    "text": "नाइनटी एट पॉइंट थ्री एफएम पर प्ले करिए",
    "cause": "EOF received",
    "confidence": 0.891,
    "display_text": "98.3 एफएम पर प्ले करिए"
}

​
Response: Error Message

{
    "id": "03e4f260551345e6832bf62ba273e0096fd303e72f94453f",
    "success": false,
    "text": "",
    "final": true,
    "confidence": 1.0,
    "cause": "no file given",
    "display_text": ""  }

​
API References

​
HTTP Request URL

URL ElementsSample URL
https://(hostname)https://revapi.reverieinc.com/

​
Headers

​
REV-API-KEY
string
required

API key shared by the Reverie team

​
REV-APP-ID
string
required

APP ID shared by the Reverie team

​
REV-APPNAME
string
required

Value if this string should always be stt_file

​
src_lang
string
required
  • Specify the language code.
  • Example: hi
  • Refer to section Language Codes for valid language code.
​
domain
string
required
  • This field identifies your use case type and set of the terminology defined for transcription.
  • e.g. for general audio is ‘generic’
  • It is only required for the first API i.e Upload File API.
​
format
string
  • Mention the audio sample rate and file format of the uploaded file.
  • Refer to section Supported Audio Formats for valid audio format code.
  • It is only required for the first API i.e Upload File API
  • Note:
    • By default, the format = 16k_int16. (WAV, Signed 16 bit, 16,000 or 16K Hz).
    • It is an optional parameter.

​
Query Parameter

​
audio_file
file
required
  • An audio file for which the transcript is desired.

​
Response

​
id
string
  • A unique Identity number auto-assigned by the API for each request, to be used to fetch job status and transcripts.
​
success
boolean
  • Provides true or false based on the nature of the response returned by the API.
​
final
boolean
  • Provides whether the response is the final response returned by the API.
​
text
string
  • Provides the trascripted response returned by the API for the audio file.
​
cause
string
  • Reason for obtaining the final output, generally due to End Of File (EOF) received.
​
confidence
float
  • Provides the confidence on the scale of 0 - 1 for the output.
​
display_text
string
  • Provides the display text for the final output based on some post processing.