---
title: "Initiate Speech to Text Bulk Job V1"
method: POST
path: "/speech-to-text/job/v1"
tags: ["speechToTextJob"]
---

# Initiate Speech to Text Bulk Job V1

`POST /speech-to-text/job/v1`

Create a new speech to text bulk job and receive a job UUID and storage folder details for processing multiple audio files. Set `job_parameters.input_audio_codec` when uploads are raw PCM (`pcm_s16le`, `pcm_l16`, or `pcm_raw`); the API auto-detects other formats. PCM must be 16 kHz.

## Headers

- `api-subscription-key` string, required

## Request body

- BulkJobInitRequestV1SpeechToTextJobParameters
  - `job_parameters` SpeechToTextJobParameters, required
    - `language_code` 'unknown' | 'hi-IN' | 'bn-IN' | 'kn-IN' | 'ml-IN' | 'mr-IN' | 'od-IN' | 'pa-IN' | 'ta-IN' | 'te-IN' | 'en-IN' | 'gu-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' — Languages supported for Speech-to-Text. **saarika:v2.5 supports (12 languages):** unknown, hi-IN, bn-IN, kn-IN, ml-IN, mr-IN, od-IN, pa-IN, ta-IN, te-IN, en-IN, gu-IN **saaras:v3 supports all 23 languages** including: as-IN, ur-IN, ne-IN, kok-IN, ks-IN, sd-IN, sa-IN, sat-IN, mni-IN, brx-IN, mai-IN, doi-IN
    - `model` 'saaras:v3' | 'saarika:v2.5' — Model to be used for speech to text. - **saaras:v3** (default, recommended): State-of-the-art model with flexible output formats. Supports multiple modes via the `mode` parameter: transcribe, translate, verbatim, translit, codemix. - **saarika:v2.5** (legacy): Transcribes audio in the spoken language. Kept for backward compatibility.
    - `mode` 'transcribe' | 'translate' | 'verbatim' | 'translit' | 'codemix' — Mode of operation for saaras:v3 model. Example audio: 'मेरा फोन नंबर है 9840950950' - **transcribe** (default): Standard transcription in the original language with proper formatting and number normalization. - Output: `मेरा फोन नंबर है 9840950950` - **translate**: Translates speech from any supported Indic language to English. - Output: `My phone number is 9840950950` - **verbatim**: Exact word-for-word transcription without normalization, preserving filler words and spoken numbers as-is. - Output: `मेरा फोन नंबर है नौ आठ चार zero नौ पांच zero नौ पांच zero` - **translit**: Romanization - Transliterates speech to Latin/Roman script only. - Output: `mera phone number hai 9840950950` - **codemix**: Code-mixed text with English words in English and Indic words in native script. - Output: `मेरा phone number है 9840950950`
    - `with_timestamps` boolean — Whether to include timestamps in the response
    - `with_diarization` boolean — Enables speaker diarization, which identifies and separates different speakers in the audio. In beta mode
    - `num_speakers` integer, nullable — Number of speakers to be detected in the audio. This is used when with_diarization is true.
    - `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.
  - `callback` BulkJobCallback
    - `url` string, required — Webhook url to call upon job completion
    - `auth_token` string — Authorization token required for the callback Url

## Response `202`

Successful Response

- BulkJobInitResponse
  - `job_id` string, required — Job UUID.
  - `storage_container_type` 'Azure' | 'Local' | 'Google' | 'Azure_V1', required
  - `job_parameters` BaseJobParameters, required
  - `job_state` 'Accepted' | 'Pending' | 'Running' | 'Completed' | 'Failed', required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `422` — Unprocessable Entity
- `429` — Quota Exceeded
- `500` — Internal Server Error
- `503` — Service Overloaded

---

[API](https://skmtc.dev/sarvam/apis/endpoints.md) · [All operations](https://skmtc.dev/sarvam/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc.dev/sarvam/apis/endpoints/revisions/2b7f7955b147?raw)