Speech to Text

Speech to Text

Real-Time Speech to Text API

This API transcribes speech to text in multiple Indian languages and English. Supports real-time transcription for interactive applications.

Available Options:

  • Real-Time API (Current Endpoint): For quick responses under 30 seconds with immediate results
  • Batch API: For longer audio files, requires following a notebook script - View Notebook
    • Supports diarization (speaker identification)

Note:

  • Pricing differs for Real-Time and Batch APIs
  • Diarization is only available in Batch API with separate pricing
  • Please refer to dashboard.sarvam.ai for detailed pricing information

Headers

api-subscription-keystringRequired

Request

This endpoint expects a multipart form containing a file.
filefileRequired

The audio file to transcribe. Supported formats are WAV (.wav) and MP3 (.mp3). The API works best with audio files sampled at 16kHz. If the audio contains multiple channels, they will be merged into a single channel.

modelenumOptional

Specifies the model to use for speech-to-text conversion. Note:- Default model is saarika:v2

Allowed values:
language_codeenumOptional

Specifies the language of the input audio. This parameter is required to ensure accurate transcription. For the saarika:v1 model, this parameter is mandatory. For the saarika:v2 model, it is optional. unknown: Use this when the language is not known; the API will detect it automatically. Note:- that the saarika:v1 model does not support unknown language code.

Response

Successful Response

transcriptstring

The transcribed text from the provided audio file.

request_idstringOptional
timestampsobjectOptional

Contains timestamps for the transcribed text. This field is included only if with_timestamps is set to true

diarized_transcriptobjectOptional

Diarized transcript of the provided speech

language_codestringOptional

This will return the BCP-47 code of language spoken in the input. If multiple languages are detected, this will return language code of most predominant spoken language. If no language is detected, this will be null

Errors