Translation | Sarvam API Docs

Translation converts text from one language to another while preserving its meaning. For Example: ‘मैं ऑफिस जा रहा हूँ’ translates to ‘I am going to the office’ in English, where the script and language change, but the original meaning remains the same.

Available languages:

bn-IN: Bengali
en-IN: English
gu-IN: Gujarati
hi-IN: Hindi
kn-IN: Kannada
ml-IN: Malayalam
mr-IN: Marathi
od-IN: Odia
pa-IN: Punjabi
ta-IN: Tamil
te-IN: Telugu

Newly added languages:

as-IN: Assamese
brx-IN: Bodo
doi-IN: Dogri
kok-IN: Konkani
ks-IN: Kashmiri
mai-IN: Maithili
mni-IN: Manipuri (Meiteilon)
ne-IN: Nepali
sa-IN: Sanskrit
sat-IN: Santali
sd-IN: Sindhi
ur-IN: Urdu

For hands-on practice, you can explore the notebook tutorial on Translate API Tutorial.

**Translation** converts text from one language to another while preserving its meaning. For Example: **'मैं ऑफिस जा रहा हूँ'** translates to **'I am going to the office'** in English, where the script and language change, but the original meaning remains the same. Available languages: - **`bn-IN`**: Bengali - **`en-IN`**: English - **`gu-IN`**: Gujarati - **`hi-IN`**: Hindi - **`kn-IN`**: Kannada - **`ml-IN`**: Malayalam - **`mr-IN`**: Marathi - **`od-IN`**: Odia - **`pa-IN`**: Punjabi - **`ta-IN`**: Tamil - **`te-IN`**: Telugu ### Newly added languages: - **`as-IN`**: Assamese - **`brx-IN`**: Bodo - **`doi-IN`**: Dogri - **`kok-IN`**: Konkani - **`ks-IN`**: Kashmiri - **`mai-IN`**: Maithili - **`mni-IN`**: Manipuri (Meiteilon) - **`ne-IN`**: Nepali - **`sa-IN`**: Sanskrit - **`sat-IN`**: Santali - **`sd-IN`**: Sindhi - **`ur-IN`**: Urdu For hands-on practice, you can explore the notebook tutorial on [Translate API Tutorial](https://github.com/sarvamai/sarvam-ai-cookbook/blob/main/notebooks/translate/Translate_API_Tutorial.ipynb).

Authentication

api-subscription-keystring

API Key authentication via header

Request

This endpoint expects an object.

inputstringRequired<=2000 characters

The text you want to translate is the input text that will be processed by the translation model. The maximum is 1000 characters for Mayura:v1 and 2000 characters for Sarvam-Translate:v1.

source_language_codeenumRequired

Source language code for translation input.

mayura:v1 Languages: Bengali, English, Gujarati, Hindi, Kannada, Malayalam, Marathi, Odia, Punjabi, Tamil, Telugu

sarvam-translate:v1 Languages: All mayura:v1 languages and Assamese, Bodo, Dogri, Konkani, Kashmiri, Maithili, Manipuri, Nepali, Sanskrit, Santali, Sindhi, Urdu

Note: mayura:v1 supports automatic language detection using ‘auto’ as the source language code.

Source language code for translation input. **mayura:v1 Languages:** Bengali, English, Gujarati, Hindi, Kannada, Malayalam, Marathi, Odia, Punjabi, Tamil, Telugu **sarvam-translate:v1 Languages:** All mayura:v1 languages and Assamese, Bodo, Dogri, Konkani, Kashmiri, Maithili, Manipuri, Nepali, Sanskrit, Santali, Sindhi, Urdu **Note:** mayura:v1 supports automatic language detection using 'auto' as the source language code.

target_language_codeenumRequired

The language code of the translated text. This specifies the target language for translation.

mayura:v1 Languages: Bengali, English, Gujarati, Hindi, Kannada, Malayalam, Marathi, Odia, Punjabi, Tamil, Telugu

sarvam-translate:v1 Languages: All mayura:v1 and Assamese, Bodo, Dogri, Konkani, Kashmiri, Maithili, Manipuri, Nepali, Sanskrit, Santali, Sindhi, Urdu

The language code of the translated text. This specifies the target language for translation. **mayura:v1 Languages:** Bengali, English, Gujarati, Hindi, Kannada, Malayalam, Marathi, Odia, Punjabi, Tamil, Telugu **sarvam-translate:v1 Languages:** All mayura:v1 and Assamese, Bodo, Dogri, Konkani, Kashmiri, Maithili, Manipuri, Nepali, Sanskrit, Santali, Sindhi, Urdu

speaker_genderenumOptional

Please specify the gender of the speaker for better translations.

Allowed values:

modeenumOptional

Specifies the tone or style of the translation.

Model Support:

mayura:v1: Supports formal, classic-colloquial, and modern-colloquial modes
sarvam-translate:v1: Only formal mode is supported

Default: formal

Specifies the tone or style of the translation. **Model Support:** - **mayura:v1**: Supports formal, classic-colloquial, and modern-colloquial modes - **sarvam-translate:v1**: Only formal mode is supported **Default:** formal

Allowed values:

modelenumOptional

Specifies the translation model to use.

mayura:v1: Supports 12 languages with all modes, output scripts, and automatic language detection.
sarvam-translate:v1: Supports all 22 scheduled languages of India, formal mode only.

Specifies the translation model to use. - mayura:v1: Supports 12 languages with all modes, output scripts, and automatic language detection. - sarvam-translate:v1: Supports all 22 scheduled languages of India, formal mode only.

Allowed values:

output_scriptenum or nullOptional

output_script: This is an optional parameter which controls the transliteration style applied to the output text.

Transliteration: Converting text from one script to another while preserving pronunciation.

For mayura:v1 - We support transliteration with four options:

null(default): No transliteration applied.
roman: Transliteration in Romanized script.
fully-native: Transliteration in the native script with formal style.
spoken-form-in-native: Transliteration in the native script with spoken style.

For sarvam-translate:v1 - Transliteration is not supported.

Example:

English: Your EMI of Rs. 3000 is pending. Default modern translation: आपका Rs. 3000 का EMI pending है (when null is passed).

With postprocessing enabled:

roman output: aapka Rs. 3000 ka EMI pending hai.

**output_script**: This is an optional parameter which controls the transliteration style applied to the output text. **Transliteration**: Converting text from one script to another while preserving pronunciation. For mayura:v1 - We support transliteration with four options: - **`null`**(default): No transliteration applied. - **`roman`**: Transliteration in Romanized script. - **`fully-native`**: Transliteration in the native script with formal style. - **`spoken-form-in-native`**: Transliteration in the native script with spoken style. For sarvam-translate:v1 - Transliteration is not supported. ### Example: English: Your EMI of Rs. 3000 is pending. Default modern translation: आपका Rs. 3000 का EMI pending है (when `null` is passed). With postprocessing enabled: - **roman output**: aapka Rs. 3000 ka EMI pending hai.

Allowed values:

numerals_formatenumOptional

numerals_format is an optional parameter with two options (supported for both mayura:v1 and sarvam-translate:v1):

international (default): Uses regular numerals (0-9).
native: Uses language-specific native numerals.

Example:

If international format is selected, we use regular numerals (0-9). For example: मेरा phone number है: 9840950950.
If native format is selected, we use language-specific native numerals, like: मेरा phone number है: ९८४०९५०९५०.

`numerals_format` is an optional parameter with two options (supported for both mayura:v1 and sarvam-translate:v1): - **`international`** (default): Uses regular numerals (0-9). - **`native`**: Uses language-specific native numerals. ### Example: - If `international` format is selected, we use regular numerals (0-9). For example: `मेरा phone number है: 9840950950`. - If `native` format is selected, we use language-specific native numerals, like: `मेरा phone number है: ९८४०९५०९५०`.

Allowed values:

Response

Successful Response

request_idstring or null

translated_textstring

Translated text result in the requested target language.

source_language_codestring

Detected or provided source language of the input text.

Errors

400

Bad Request Error

403

Forbidden Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

Available languages:

bn-IN: Bengali
en-IN: English
gu-IN: Gujarati
hi-IN: Hindi
kn-IN: Kannada
ml-IN: Malayalam
mr-IN: Marathi
od-IN: Odia
pa-IN: Punjabi
ta-IN: Tamil
te-IN: Telugu

Newly added languages:

as-IN: Assamese
brx-IN: Bodo
doi-IN: Dogri
kok-IN: Konkani
ks-IN: Kashmiri
mai-IN: Maithili
mni-IN: Manipuri (Meiteilon)
ne-IN: Nepali
sa-IN: Sanskrit
sat-IN: Santali
sd-IN: Sindhi
ur-IN: Urdu

For hands-on practice, you can explore the notebook tutorial on Translate API Tutorial.

1	from sarvamai import SarvamAI
2
3	client = SarvamAI(
4	api_subscription_key="YOUR_API_KEY_HERE",
5	)
6
7	client.text.translate(
8	input="मैं ऑफिस जा रहा हूँ",
9	source_language_code="hi-IN",
10	target_language_code="en-IN",
11	)