Speech To Text | Sarvam API Docs

Speech to Text API

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

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

## Speech to Text API This API transcribes speech to text in multiple Indian languages and English. Supports transcription for interactive applications. ### Available Options: - **REST API** (Current Endpoint): For quick responses under 30 seconds with immediate results - **Batch API**: For longer audio files, [Follow This Documentation](https://docs.sarvam.ai/api-reference-docs/api-guides-tutorials/speech-to-text/batch-api) - 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](https://docs.sarvam.ai/api-reference-docs/getting-started/pricing) for detailed pricing information

Authentication

api-subscription-keystring

API Key authentication via header

Request

This endpoint expects a multipart form containing a file.

filefileRequired

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. 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.5

Allowed values:

language_codeenumOptional

Specifies the language of the input audio. For the saarika:v2.5 model, it is optional. unknown: Use this when the language is not known; the API will detect it automatically.

input_audio_codecenumOptional

Input Audio codec/format of the input file. PCM files are supported only at 16kHz sample rate.

Response

Successful Response

request_idstring or null

transcriptstring

The transcribed text from the provided audio file.

timestampsobject or null

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

diarized_transcriptobject or null

Diarized transcript of the provided speech

language_codestring or null

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

1	from sarvamai import SarvamAI
2
3	client = SarvamAI(
4	api_subscription_key="YOUR_API_SUBSCRIPTION_KEY",
5	)
6	client.speech_to_text.transcribe()

1	{
2	"request_id": "foo",
3	"transcript": "नमस्ते, आप कैसे हैं?",
4	"timestamps": {
5	"words": [
6	"foo"
7	],
8	"start_time_seconds": [
9	42
10	],
11	"end_time_seconds": [
12	42
13	]
14	},
15	"diarized_transcript": {
16	"entries": [
17	{
18	"transcript": "foo",
19	"start_time_seconds": 42,
20	"end_time_seconds": 42,
21	"speaker_id": "foo"
22	}
23	]
24	},
25	"language_code": "foo"
26	}

Speech to Text API

Available Options:

Note:

Authentication

Request

Response

Errors

Speech to Text API

Available Options:

Note: