v1

latestOpenAPI 3.0.02026-07-268285163.6 KB
Translation

Translate text

Translates text from a source to a target language. Supports plain strings, structured message objects, or arrays of both. The response preserves the original structure.

Supported language codes:

  • ace_Arab: Acehnese (Arabic script)
  • ace_Latn: Acehnese (Latin script)
  • acm_Arab: Mesopotamian Arabic (Arab script)
  • acq_Arab: Ta'izzi-Adeni Arabic (Arab script)
  • aeb_Arab: Tunisian Arabic (Arab script)
  • aeb_Latn: Tunisian Latin (Latin script)
  • afr_Latn: Afrikaans (Latin script)
  • ajp_Arab: South Levantine Arabic (Arab script)
  • aka_Latn: Akan (Latin script)
  • als_Latn: Tosk Albanian (Latin script)
  • amh_Ethi: Amharic (Ethiopic script)
  • apc_Arab: North Levantine Arabic (Arabic script)
  • arb_Arab: Modern Standard Arabic (Arabic script)
  • ars_Arab: Najdi Arabic (Arabic script)
  • ary_Arab: Moroccan Arabic (Arabic script)
  • ary_Latn: Moroccan Darija (Latin script)
  • arz_Arab: Egyptian Arabic (Arabic script)
  • asm_Beng: Assamese (Bengali script)
  • ast_Latn: Asturian (Latn script)
  • awa_Deva: Awadhi (Deva script)
  • ayr_Latn: Central Aymara (Latn script)
  • azb_Arab: South Azerbaijani (Arab script)
  • azj_Latn: North Azerbaijani (Latin script)
  • bak_Cyrl: Bashkir (Cyrillic script)
  • bam_Latn: Bambara (Latin script)
  • ban_Latn: Balinese (Latin script)
  • bel_Cyrl: Belarusian (Cyrillic script)
  • bem_Latn: Bemba (Latin script)
  • ben_Beng: Bengali (Bengali script)
  • bho_Deva: Bhojpuri (Devanagari script)
  • bjn_Arab: Banjar (Arab script)
  • bjn_Latn: Banjar (Latn script)
  • bod_Tibt: Tibetan (Tibt script)
  • bos_Latn: Bosnian (Latin script)
  • bug_Latn: Buginese (Latin script)
  • bul_Cyrl: Bulgarian (Cyrillic script)
  • cat_Latn: Catalan (Latin script)
  • ceb_Latn: Cebuano (Latin script)
  • ces_Latn: Czech (Latin script)
  • cjk_Latn: Chokwe (Latin script)
  • ckb_Arab: Central Kurdish (Arabic script)
  • crh_Latn: Crimean Tatar (Latin script)
  • cym_Latn: Welsh (Latin script)
  • dan_Latn: Danish (Latin script)
  • deu_Latn: German (Latin script)
  • dik_Latn: Southwestern Dinka (Latin script)
  • dyu_Latn: Dyula (Latin script)
  • dzo_Tibt: Dzongkha (Tibetan script)
  • ell_Grek: Greek (Greek script)
  • eng_Latn: English (Latin script)
  • epo_Latn: Esperanto (Latin script)
  • est_Latn: Estonian (Latin script)
  • eus_Latn: Basque (Latin script)
  • ewe_Latn: Ewe (Latin script)
  • fao_Latn: Faroese (Latin script)
  • fij_Latn: Fijian (Latin script)
  • fin_Latn: Finnish (Latin script)
  • fon_Latn: Fon (Latin script)
  • fra_Latn: French (Latin script)
  • fur_Latn: Friulian (Latin script)
  • fuv_Latn: Nigerian Fulfulde (Latin script)
  • gaz_Latn: West Central Oromo (Latn script)
  • gla_Latn: Scottish Gaelic (Latin script)
  • gle_Latn: Irish (Latin script)
  • glg_Latn: Galician (Latin script)
  • grn_Latn: Guarani (Latin script)
  • guj_Gujr: Gujarati (Gujarati script)
  • hat_Latn: Haitian Creole (Latin script)
  • hau_Latn: Hausa (Latin script)
  • heb_Hebr: Hebrew (Hebrew script)
  • hin_Deva: Hindi (Devanagari script)
  • hne_Deva: Chhattisgarhi (Devanagari script)
  • hrv_Latn: Croatian (Latin script)
  • hun_Latn: Hungarian (Latin script)
  • hye_Armn: Armenian (Armenian script)
  • ibo_Latn: Igbo (Latin script)
  • ilo_Latn: Iloko (Latin script)
  • ind_Latn: Indonesian (Latin script)
  • isl_Latn: Icelandic (Latin script)
  • ita_Latn: Italian (Latin script)
  • jav_Latn: Javanese (Latin script)
  • jpn_Jpan: Japanese (Japanese script)
  • kab_Latn: Kabyle (Latin script)
  • kac_Latn: Jingpho (Latin script)
  • kam_Latn: Kamba (Latin script)
  • kan_Knda: Kannada (Kannada script)
  • kas_Arab: Kashmiri (Arabic script)
  • kas_Deva: Kashmiri (Devanagari script)
  • kat_Geor: Georgian (Georgian script)
  • kaz_Cyrl: Kazakh (Cyrillic script)
  • kbp_Latn: Kabiyè (Latin script)
  • kea_Latn: Kabuverdianu (Latin script)
  • khk_Cyrl: Halh Mongolian (Cyrl script)
  • khm_Khmr: Khmer (Khmer script)
  • kik_Latn: Kikuyu (Latin script)
  • kin_Latn: Kinyarwanda (Latin script)
  • kir_Cyrl: Kyrgyz (Cyrillic script)
  • kmb_Latn: Kimbundu (Latin script)
  • kmr_Latn: Northern Kurdish (Latin script)
  • knc_Arab: Central Kanuri (Arab script)
  • knc_Latn: Central Kanuri (Latn script)
  • kon_Latn: Kongo (Latin script)
  • kor_Hang: Korean (Hangul script)
  • lao_Laoo: Lao (Lao script)
  • lij_Latn: Ligurian (Latin script)
  • lim_Latn: Limburgish (Latin script)
  • lin_Latn: Lingala (Latin script)
  • lit_Latn: Lithuanian (Latin script)
  • lmo_Latn: Lombard (Latin script)
  • ltg_Latn: Latgalian (Latin script)
  • ltz_Latn: Luxembourgish (Latn script)
  • lua_Latn: Luba-Lulua (Latn script)
  • lug_Latn: Ganda (Latin script)
  • luo_Latn: Luo (Latin script)
  • lus_Latn: Mizo (Latin script)
  • lvs_Latn: Standard Latvian (Latin script)
  • mag_Deva: Magahi (Devanagari script)
  • mai_Deva: Maithili (Devanagari script)
  • mal_Mlym: Malayalam (Malayalam script)
  • mar_Deva: Marathi (Devanagari script)
  • min_Latn: Minangkabau (Latin script)
  • mkd_Cyrl: Macedonian (Cyrillic script)
  • mlt_Latn: Maltese (Latin script)
  • mni_Beng: Meitei (Bengali script)
  • mos_Latn: Mossi (Latin script)
  • mri_Latn: Maori (Latin script)
  • mya_Mymr: Burmese (Myanmar script)
  • nld_Latn: Dutch (Latin script)
  • nno_Latn: Norwegian Nynorsk (Latin script)
  • nob_Latn: Norwegian Bokmål (Latin script)
  • npi_Deva: Nepali (Devanagari script)
  • nso_Latn: Northern Sotho (Latin script)
  • nus_Latn: Nuer (Latin script)
  • nya_Latn: Nyanja (Latin script)
  • oci_Latn: Occitan (Latin script)
  • ory_Orya: Odia (Oriya script)
  • pag_Latn: Pangasinan (Latin script)
  • pan_Guru: Punjabi (Gurmukhi script)
  • pap_Latn: Papiamento (Latin script)
  • pbt_Arab: Southern Pashto (Arabic script)
  • pes_Arab: Western Persian (Arabic script)
  • plt_Latn: Plateau Malagasy (Latin script)
  • pol_Latn: Polish (Latin script)
  • por_Latn: Portuguese (Latin script)
  • prs_Arab: Dari (Arabic script)
  • quy_Latn: Ayacucho Quechua (Latin script)
  • ron_Latn: Romanian (Latin script)
  • run_Latn: Rundi (Latin script)
  • rus_Cyrl: Russian (Cyrillic script)
  • sag_Latn: Sango (Latin script)
  • san_Deva: Sanskrit (Devanagari script)
  • sat_Beng: Santali (Beng script)
  • scn_Latn: Sicilian (Latin script)
  • shn_Mymr: Shan (Myanmar script)
  • sin_Sinh: Sinhala (Sinhala script)
  • slk_Latn: Slovak (Latin script)
  • slv_Latn: Slovenian (Latin script)
  • smo_Latn: Samoan (Latin script)
  • sna_Latn: Shona (Latin script)
  • snd_Arab: Sindhi (Arabic script)
  • som_Latn: Somali (Latin script)
  • sot_Latn: Southern Sotho (Latin script)
  • spa_Latn: Spanish (Latin script)
  • srd_Latn: Sardinian (Latin script)
  • srp_Cyrl: Serbian (Cyrillic script)
  • ssw_Latn: Swati (Latin script)
  • sun_Latn: Sundanese (Latin script)
  • swe_Latn: Swedish (Latin script)
  • swh_Latn: Swahili (Latin script)
  • szl_Latn: Silesian (Latin script)
  • tam_Taml: Tamil (Tamil script)
  • taq_Latn: Tamasheq (Latin script)
  • taq_Tfng: Tamasheq (Tifinagh script)
  • tat_Cyrl: Tatar (Cyrillic script)
  • tel_Telu: Telugu (Telugu script)
  • tgk_Cyrl: Tajik (Cyrillic script)
  • tgl_Latn: Tagalog (Latin script)
  • tha_Thai: Thai (Thai script)
  • tir_Ethi: Tigrinya (Ethiopic script)
  • tpi_Latn: Tok Pisin (Latin script)
  • tsn_Latn: Tswana (Latin script)
  • tso_Latn: Tsonga (Latin script)
  • tuk_Latn: Turkmen (Latin script)
  • tum_Latn: Tumbuka (Latin script)
  • tur_Latn: Turkish (Latin script)
  • twi_Latn: Twi (Latin script)
  • tzm_Tfng: Central Atlas Tamazight (Tifinagh script)
  • uig_Arab: Uyghur (Arabic script)
  • ukr_Cyrl: Ukrainian (Cyrillic script)
  • umb_Latn: Umbundu (Latin script)
  • urd_Arab: Urdu (Arabic script)
  • uzn_Latn: Northern Uzbek (Latin script)
  • vec_Latn: Venetian (Latin script)
  • vie_Latn: Vietnamese (Latin script)
  • war_Latn: Waray (Latin script)
  • wol_Latn: Wolof (Latin script)
  • xho_Latn: Xhosa (Latin script)
  • ydd_Hebr: Eastern Yiddish (Hebrew script)
  • yor_Latn: Yoruba (Latin script)
  • yue_Hant: Cantonese (Traditional Chinese script)
  • zho_Hans: Chinese (Simplified script)
  • zho_Hant: Chinese (Traditional script)
  • zsm_Latn: Standard Malay (Latin script)
  • zul_Latn: Zulu (Latin script)
post/translate

Request body

src_lang'ace_Arab' | 'ace_Latn' | 'acm_Arab' | 'acq_Arab' | 'aeb_Arab' | 'aeb_Latn' | 'afr_Latn' | 'ajp_Arab' | 'aka_Latn' | 'als_Latn' | 'amh_Ethi' | 'apc_Arab' | 'arb_Arab' | 'ars_Arab' | 'ary_Arab' | 'ary_Latn' | 'arz_Arab' | 'asm_Beng' | 'ast_Latn' | 'awa_Deva' | 'ayr_Latn' | 'azb_Arab' | 'azj_Latn' | 'bak_Cyrl' | 'bam_Latn' | 'ban_Latn' | 'bel_Cyrl' | 'bem_Latn' | 'ben_Beng' | 'bho_Deva' | 'bjn_Arab' | 'bjn_Latn' | 'bod_Tibt' | 'bos_Latn' | 'bug_Latn' | 'bul_Cyrl' | 'cat_Latn' | 'ceb_Latn' | 'ces_Latn' | 'cjk_Latn' | 'ckb_Arab' | 'crh_Latn' | 'cym_Latn' | 'dan_Latn' | 'deu_Latn' | 'dik_Latn' | 'dyu_Latn' | 'dzo_Tibt' | 'ell_Grek' | 'eng_Latn' | 'epo_Latn' | 'est_Latn' | 'eus_Latn' | 'ewe_Latn' | 'fao_Latn' | 'fij_Latn' | 'fin_Latn' | 'fon_Latn' | 'fra_Latn' | 'fur_Latn' | 'fuv_Latn' | 'gaz_Latn' | 'gla_Latn' | 'gle_Latn' | 'glg_Latn' | 'grn_Latn' | 'guj_Gujr' | 'hat_Latn' | 'hau_Latn' | 'heb_Hebr' | 'hin_Deva' | 'hne_Deva' | 'hrv_Latn' | 'hun_Latn' | 'hye_Armn' | 'ibo_Latn' | 'ilo_Latn' | 'ind_Latn' | 'isl_Latn' | 'ita_Latn' | 'jav_Latn' | 'jpn_Jpan' | 'kab_Latn' | 'kac_Latn' | 'kam_Latn' | 'kan_Knda' | 'kas_Arab' | 'kas_Deva' | 'kat_Geor' | 'kaz_Cyrl' | 'kbp_Latn' | 'kea_Latn' | 'khk_Cyrl' | 'khm_Khmr' | 'kik_Latn' | 'kin_Latn' | 'kir_Cyrl' | 'kmb_Latn' | 'kmr_Latn' | 'knc_Arab' | 'knc_Latn' | 'kon_Latn' | 'kor_Hang' | 'lao_Laoo' | 'lij_Latn' | 'lim_Latn' | 'lin_Latn' | 'lit_Latn' | 'lmo_Latn' | 'ltg_Latn' | 'ltz_Latn' | 'lua_Latn' | 'lug_Latn' | 'luo_Latn' | 'lus_Latn' | 'lvs_Latn' | 'mag_Deva' | 'mai_Deva' | 'mal_Mlym' | 'mar_Deva' | 'min_Latn' | 'mkd_Cyrl' | 'mlt_Latn' | 'mni_Beng' | 'mos_Latn' | 'mri_Latn' | 'mya_Mymr' | 'nld_Latn' | 'nno_Latn' | 'nob_Latn' | 'npi_Deva' | 'nso_Latn' | 'nus_Latn' | 'nya_Latn' | 'oci_Latn' | 'ory_Orya' | 'pag_Latn' | 'pan_Guru' | 'pap_Latn' | 'pbt_Arab' | 'pes_Arab' | 'plt_Latn' | 'pol_Latn' | 'por_Latn' | 'prs_Arab' | 'quy_Latn' | 'ron_Latn' | 'run_Latn' | 'rus_Cyrl' | 'sag_Latn' | 'san_Deva' | 'sat_Beng' | 'scn_Latn' | 'shn_Mymr' | 'sin_Sinh' | 'slk_Latn' | 'slv_Latn' | 'smo_Latn' | 'sna_Latn' | 'snd_Arab' | 'som_Latn' | 'sot_Latn' | 'spa_Latn' | 'srd_Latn' | 'srp_Cyrl' | 'ssw_Latn' | 'sun_Latn' | 'swe_Latn' | 'swh_Latn' | 'szl_Latn' | 'tam_Taml' | 'taq_Latn' | 'taq_Tfng' | 'tat_Cyrl' | 'tel_Telu' | 'tgk_Cyrl' | 'tgl_Latn' | 'tha_Thai' | 'tir_Ethi' | 'tpi_Latn' | 'tsn_Latn' | 'tso_Latn' | 'tuk_Latn' | 'tum_Latn' | 'tur_Latn' | 'twi_Latn' | 'tzm_Tfng' | 'uig_Arab' | 'ukr_Cyrl' | 'umb_Latn' | 'urd_Arab' | 'uzn_Latn' | 'vec_Latn' | 'vie_Latn' | 'war_Latn' | 'wol_Latn' | 'xho_Latn' | 'ydd_Hebr' | 'yor_Latn' | 'yue_Hant' | 'zho_Hans' | 'zho_Hant' | 'zsm_Latn' | 'zul_Latn' required

Source language in NLLB format

tgt_lang'ace_Arab' | 'ace_Latn' | 'acm_Arab' | 'acq_Arab' | 'aeb_Arab' | 'aeb_Latn' | 'afr_Latn' | 'ajp_Arab' | 'aka_Latn' | 'als_Latn' | 'amh_Ethi' | 'apc_Arab' | 'arb_Arab' | 'ars_Arab' | 'ary_Arab' | 'ary_Latn' | 'arz_Arab' | 'asm_Beng' | 'ast_Latn' | 'awa_Deva' | 'ayr_Latn' | 'azb_Arab' | 'azj_Latn' | 'bak_Cyrl' | 'bam_Latn' | 'ban_Latn' | 'bel_Cyrl' | 'bem_Latn' | 'ben_Beng' | 'bho_Deva' | 'bjn_Arab' | 'bjn_Latn' | 'bod_Tibt' | 'bos_Latn' | 'bug_Latn' | 'bul_Cyrl' | 'cat_Latn' | 'ceb_Latn' | 'ces_Latn' | 'cjk_Latn' | 'ckb_Arab' | 'crh_Latn' | 'cym_Latn' | 'dan_Latn' | 'deu_Latn' | 'dik_Latn' | 'dyu_Latn' | 'dzo_Tibt' | 'ell_Grek' | 'eng_Latn' | 'epo_Latn' | 'est_Latn' | 'eus_Latn' | 'ewe_Latn' | 'fao_Latn' | 'fij_Latn' | 'fin_Latn' | 'fon_Latn' | 'fra_Latn' | 'fur_Latn' | 'fuv_Latn' | 'gaz_Latn' | 'gla_Latn' | 'gle_Latn' | 'glg_Latn' | 'grn_Latn' | 'guj_Gujr' | 'hat_Latn' | 'hau_Latn' | 'heb_Hebr' | 'hin_Deva' | 'hne_Deva' | 'hrv_Latn' | 'hun_Latn' | 'hye_Armn' | 'ibo_Latn' | 'ilo_Latn' | 'ind_Latn' | 'isl_Latn' | 'ita_Latn' | 'jav_Latn' | 'jpn_Jpan' | 'kab_Latn' | 'kac_Latn' | 'kam_Latn' | 'kan_Knda' | 'kas_Arab' | 'kas_Deva' | 'kat_Geor' | 'kaz_Cyrl' | 'kbp_Latn' | 'kea_Latn' | 'khk_Cyrl' | 'khm_Khmr' | 'kik_Latn' | 'kin_Latn' | 'kir_Cyrl' | 'kmb_Latn' | 'kmr_Latn' | 'knc_Arab' | 'knc_Latn' | 'kon_Latn' | 'kor_Hang' | 'lao_Laoo' | 'lij_Latn' | 'lim_Latn' | 'lin_Latn' | 'lit_Latn' | 'lmo_Latn' | 'ltg_Latn' | 'ltz_Latn' | 'lua_Latn' | 'lug_Latn' | 'luo_Latn' | 'lus_Latn' | 'lvs_Latn' | 'mag_Deva' | 'mai_Deva' | 'mal_Mlym' | 'mar_Deva' | 'min_Latn' | 'mkd_Cyrl' | 'mlt_Latn' | 'mni_Beng' | 'mos_Latn' | 'mri_Latn' | 'mya_Mymr' | 'nld_Latn' | 'nno_Latn' | 'nob_Latn' | 'npi_Deva' | 'nso_Latn' | 'nus_Latn' | 'nya_Latn' | 'oci_Latn' | 'ory_Orya' | 'pag_Latn' | 'pan_Guru' | 'pap_Latn' | 'pbt_Arab' | 'pes_Arab' | 'plt_Latn' | 'pol_Latn' | 'por_Latn' | 'prs_Arab' | 'quy_Latn' | 'ron_Latn' | 'run_Latn' | 'rus_Cyrl' | 'sag_Latn' | 'san_Deva' | 'sat_Beng' | 'scn_Latn' | 'shn_Mymr' | 'sin_Sinh' | 'slk_Latn' | 'slv_Latn' | 'smo_Latn' | 'sna_Latn' | 'snd_Arab' | 'som_Latn' | 'sot_Latn' | 'spa_Latn' | 'srd_Latn' | 'srp_Cyrl' | 'ssw_Latn' | 'sun_Latn' | 'swe_Latn' | 'swh_Latn' | 'szl_Latn' | 'tam_Taml' | 'taq_Latn' | 'taq_Tfng' | 'tat_Cyrl' | 'tel_Telu' | 'tgk_Cyrl' | 'tgl_Latn' | 'tha_Thai' | 'tir_Ethi' | 'tpi_Latn' | 'tsn_Latn' | 'tso_Latn' | 'tuk_Latn' | 'tum_Latn' | 'tur_Latn' | 'twi_Latn' | 'tzm_Tfng' | 'uig_Arab' | 'ukr_Cyrl' | 'umb_Latn' | 'urd_Arab' | 'uzn_Latn' | 'vec_Latn' | 'vie_Latn' | 'war_Latn' | 'wol_Latn' | 'xho_Latn' | 'ydd_Hebr' | 'yor_Latn' | 'yue_Hant' | 'zho_Hans' | 'zho_Hant' | 'zsm_Latn' | 'zul_Latn' required

Target language in NLLB format

Example request

{
  "text": "Merci pour votre message",
  "src_lang": "fra_Latn",
  "tgt_lang": "eng_Latn"
}

Response

Translation successful

{"stackTrail":"paths:/translate:post:responses:200:content:application/json:schema:properties:translation","oasType":"schema","type":"unknown","description":"Translated content with same structure as input","example":[{"id":"msg_001","text":"Hello, how can I help you?"},{"text":"Would you like to speak to an agent?","quick_replies":[{"title":"Yes"},{"title":"No"}]},{"location":{"name":"Headquarters"},"type":"location"}]}

Example response

{
  "translation": [
    {
      "id": "msg_001",
      "text": "Hello, how can I help you?"
    },
    {
      "text": "Would you like to speak to an agent?",
      "quick_replies": [
        {
          "title": "Yes"
        },
        {
          "title": "No"
        }
      ]
    },
    {
      "location": {
        "name": "Headquarters"
      },
      "type": "location"
    }
  ]
}