Batch - Initiate Job | Sarvam API Docs

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.

Authentication

api-subscription-keystring

API Key authentication via header

Request

This endpoint expects an object.

job_parametersobjectRequired

Job Parameters for the bulk job

callbackobject or nullOptional

Parameters for callback URL

Response

Successful Response

job_idstring

Job UUID.

storage_container_typeenum

Storage Container Type

Allowed values:

job_parametersobject

job_stateenum

Allowed values:

Errors

400

Bad Request Error

403

Forbidden Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error

$	curl -X POST https://api.sarvam.ai/speech-to-text/job/v1 \
>	-H "api-subscription-key: <apiSubscriptionKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"job_parameters": {}
>	}'

1	{
2	"job_id": "3f9a8b2e-7c4d-4a1e-9f3b-2d5e6f7a8b9c",
3	"storage_container_type": "Azure",
4	"job_parameters": {},
5	"job_state": "Accepted"
6	}

$	curl -X POST https://api.sarvam.ai/speech-to-text/job/v1 \
>	-H "api-subscription-key: <apiSubscriptionKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"job_parameters": {}
>	}'

1	{
2	"job_id": "3f9a8b2e-7c4d-4a1e-9f3b-2d5e6f7a8b9c",
3	"storage_container_type": "Azure",
4	"job_parameters": {},
5	"job_state": "Accepted"
6	}