Dubbing API

Sarvam’s Dubbing API seamlessly translates your audio and video content into every language you target. By leveraging state-of-the-art voice cloning technology, it delivers broadcast-ready dubs while preserving the original vocal identity of every speaker.

It is part of Content Agents, and is the programmatic equivalent of the Dubbing workspace in Creator Studio.

What one job gives you

A single job dubs into every target language you list, and produces every format in export_options for each of them. You never need one job per language. In the REST body the language fields are src_lang / target_langs; in the Python SDK they are source_language_code / target_language_codes.

How it works

Dubbing is asynchronous by design: you create a job, upload to it, start it, then follow it to completion rather than waiting on a single request. Every integration is the same five steps.

Runnable code for each individual call, in cURL and seven other languages, is on that call’s page in the API Reference.

Quickstart

Install the SDK with pip install sarvamai, set SARVAM_API_KEY, and point media at a local file. The client resolves the dubbing endpoint from its default environment, so your API key is the only configuration it needs.

1
import os
2
from pathlib import Path
3
from sarvamai import SarvamAI
4
5
client = SarvamAI(api_subscription_key=os.environ["SARVAM_API_KEY"])
6
7
media = Path("sample.mp4")
8
9
created = client.dubbing.create(
10
    source_language_code="en-IN",
11
    target_language_codes=["hi-IN", "ta-IN"],
12
    export_options=["video", "srt"],
13
    voice_cloning=True,
14
    num_speakers=1,
15
    job_name=media.name,
16
)
17
18
client.dubbing.upload(created.data.upload_url, media)
19
client.dubbing.start(job_id=created.data.job_id)
20
21
print(created.data.job_id)

That job is now running. See Job Lifecycle for the polling loop that carries it to downloadable files.

What you can upload

The file must be at least one second long and contain audible speech, since there has to be something to transcribe. Maximum size and duration depend on your plan:

Starter is the default, so those are the limits that apply unless your account is on a higher plan. On an Enterprise plan, check your limits with your account team. See Credits & Rate Limits for the rate limits that apply alongside these.

Pricing

Dubbing is billed per whole second of source media, multiplied by the number of target languages. On Starter, the default API rate is ₹40/min when editor_flow is false (the default).

Uploading the media

client.dubbing.upload() handles the upload for you, including the x-ms-blob-type: BlockBlob header that the underlying storage requires. It accepts a path or an open binary file, and guesses the Content-Type from the filename.

Explore