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

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_SUBSCRIPTION_KEY",
5	)
6	client.text.translate(
7	input="input",
8	source_language_code="auto",
9	target_language_code="bn-IN",
10	)