EndpointsText Processing

Translation

**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.

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

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

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.
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.
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 है: ९८४०९५०९५०.
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