Text

Translate Text

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.

Headers

api-subscription-keystringRequired

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:
enable_preprocessingbooleanOptionalDefaults to false

This will enable custom preprocessing of the input text which can result in better translations. Recommendation- You can switch on whenever there is some complex text with difficult vocabulary and sentences, for which you want simple translations that people can understand.

output_scriptenumOptional

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
translated_textstring
Translated text result in the requested target language.
source_language_codestring
Detected or provided source language of the input text.
request_idstring or null

Errors