speechToText

Speech To Text Translate

Speech to Text Translation API

This API automatically detects the input language, transcribes the speech, and translates the text to English.

Available Options:

  • REST API (Current Endpoint): For quick responses under 30 seconds with immediate results
  • Batch API: For longer audio files Follow this documentation
    • Supports diarization (speaker identification)

Note:

  • Pricing differs for REST and Batch APIs
  • Diarization is only available in Batch API with separate pricing
  • Please refer to here for detailed pricing information
post/speech-to-text-translate

Request

Headers

api-subscription-keystring required

Request body multipart/form-data

filestring binary required

The audio file to transcribe. Supported formats include WAV, MP3, AAC, AIFF, OGG, OPUS, FLAC, MP4/M4A, AMR, WMA, WebM, and PCM formats. The API automatically detects most codec formats, but for PCM files (pcm_s16le, pcm_l16, pcm_raw), you must specify the input_audio_codec parameter. PCM files are supported only at 16kHz sample rate. Works best at 16kHz. Multiple channels will be merged.

promptstring nullable

Conversation context can be passed as a prompt to boost model accuracy. However, the current system is at an experimentation stage and doesn't match the prompt performance of large language models.

model'saaras:v2.5'

Model to be used for speech to text translation.

  • saaras:v2.5 (default): Translation model that translates audio from any spoken Indic language to English.
    • Example: Hindi audio → English text output

For the latest model (saaras:v3), use the /speech-to-text endpoint with mode="translate".

input_audio_codec'wav' | 'x-wav' | 'wave' | 'mp3' | 'mpeg' | 'mpeg3' | 'x-mp3' | 'x-mpeg-3' | 'aac' | 'x-aac' | 'aiff' | 'x-aiff' | 'ogg' | 'opus' | 'flac' | 'x-flac' | 'mp4' | 'x-m4a' | 'amr' | 'x-ms-wma' | 'webm' | 'pcm_s16le' | 'pcm_l16' | 'pcm_raw'

Audio codec/format of the input file. Our API automatically detects all codec formats, but for PCM files specifically (pcm_s16le, pcm_l16, pcm_raw), you must pass this parameter. PCM files are supported only at 16kHz sample rate.

Response

Successful Response

request_idstring nullable required
transcriptstring required

Transcript of the provided speech

language_code'hi-IN' | 'bn-IN' | 'kn-IN' | 'ml-IN' | 'mr-IN' | 'od-IN' | 'pa-IN' | 'ta-IN' | 'te-IN' | 'gu-IN' | 'en-IN' | 'as-IN' | 'ur-IN' | 'ne-IN' | 'kok-IN' | 'ks-IN' | 'sd-IN' | 'sa-IN' | 'sat-IN' | 'mni-IN' | 'brx-IN' | 'mai-IN' | 'doi-IN' required

Languages supported for Speech-to-Text-Translate (detected source language).

saaras:v2.5 supports (11 languages): hi-IN, bn-IN, kn-IN, ml-IN, mr-IN, od-IN, pa-IN, ta-IN, te-IN, gu-IN, en-IN

For additional languages (as-IN, ur-IN, ne-IN, kok-IN, ks-IN, sd-IN, sa-IN, sat-IN, mni-IN, brx-IN, mai-IN, doi-IN), use saaras:v3 via the /speech-to-text endpoint with mode="translate".

language_probabilitynumber double nullable

Float value (0.0 to 1.0) indicating the probability of the detected language being correct. Higher values indicate higher confidence.

When it returns a value:

  • When language_code is not provided in the request
  • When language_code is set to unknown

When it returns null:

  • When a specific language_code is provided (language detection is skipped)

The parameter is always present in the response.

Changes

No recorded changes to this operation across all 2 revisions of this API.