文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>API 中心>媒体处理>其他接口>文本翻译

文本翻译

最近更新时间：2025-12-12 15:14:52

我的收藏

本页目录：

1. 接口描述

接口请求域名： mps.tencentcloudapi.com 。

文本翻译

默认接口请求频率限制：5次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：TextTranslation。
Version 是 String 公共参数，本接口取值：2019-06-12。
Region 是 String 公共参数，详见产品支持的 地域列表，本接口仅支持其中的: ap-singapore 。
SourceText 是 String 待翻译的文本，文本统一使用utf-8格式编码，非utf-8格式编码字符会翻译失败，请传入有效文本，html标记等非常规翻译文本可能会翻译失败。单次请求的文本长度需要低于1000字符。
示例值：hello
Source 是 String 源语言，支持：
"auto": "自动识别（识别为一种语言）",
"ab": "阿布哈兹语",
"ace": "亚齐语",
"ach": "阿乔利语",
"af": "南非荷兰语",
"ak": "契维语（阿坎语）",
"am": "Amharic",
"ar": "阿拉伯语",
"as": "阿萨姆语",
"ay": "艾马拉语",
"az": "阿塞拜疆语",
"ba": "巴什基尔语",
"ban": "巴厘语",
"bbc": "巴塔克托巴语",
"bem": "Bemba",
"bew": "Betawi",
"bg": "保加利亚语",
"bho": "博杰普尔语",
"bik": "Bikol",
"bm": "班巴拉语",
"bn": "孟加拉语",
"br": "布列塔尼语",
"bs": "波斯尼亚语",
"btx": "巴塔克卡罗语",
"bts": "巴塔克西马隆贡语",
"bua": "布里亚特语",
"ca": "加泰罗尼亚语",
"ceb": "宿务语",
"cgg": "Kiga",
"chm": "草原马里语",
"ckb": "库尔德语（索拉尼语）",
"cnh": "哈卡钦语",
"co": "科西嘉语",
"crh": "克里米亚鞑靼语",
"crs": "塞舌尔克里奥尔语",
"cs": "捷克语",
"cv": "楚瓦什语",
"cy": "威尔士语",
"da": "丹麦语",
"de": "德语",
"din": "Dinka",
"doi": "多格来语",
"dov": "敦贝语",
"dv": "第维埃语",
"dz": "宗卡语",
"ee": "Ewe",
"el": "希腊语",
"en": "英语",
"eo": "世界语",
"es": "西班牙语",
"et": "爱沙尼亚语",
"eu": "巴斯克语",
"fa": "波斯语",
"ff": "富拉语",
"fi": "芬兰语",
"fil": "菲律宾语（塔加拉语）",
"fj": "斐济语",
"fr": "法语",
"fr-CA": "法语（加拿大）",
"fr-FR": "法语（法国）",
"fy": "弗里斯兰语",
"ga": "爱尔兰语",
"gaa": "加 (Ga) 语",
"gd": "苏格兰盖尔语",
"gl": "加利西亚语",
"gn": "瓜拉尼语",
"gom": "贡根语",
"gu": "古吉拉特语",
"gv": "马恩岛语",
"ha": "Hausa",
"haw": "夏威夷语",
"he": "希伯来语",
"hi": "印地语",
"hil": "希利盖农语",
"hmn": "苗语",
"hr": "克罗地亚语",
"hrx": "洪斯吕克语",
"ht": "海地克里奥尔语",
"hu": "匈牙利语",
"hy": "亚美尼亚语",
"id": "印度尼西亚语",
"ig": "Igbo",
"ilo": "伊洛果语",
"is": "冰岛语",
"it": "意大利语",
"iw": "希伯来语",
"ja": "日语",
"jv": "爪哇语",
"jw": "爪哇语",
"ka": "格鲁吉亚语",
"kk": "哈萨克语",
"km": "高棉语",
"kn": "卡纳达语",
"ko": "韩语",
"kri": "Krio",
"ku": "库尔德语（库尔曼吉语）",
"ktu": "吉土巴语",
"ky": "吉尔吉斯语",
"la": "拉丁语",
"lb": "卢森堡语",
"lg": "干达语（卢干达语）",
"li": "林堡语",
"lij": "利古里亚语",
"lmo": "伦巴第语",
"ln": "林加拉语",
"lo": "老挝语",
"lt": "立陶宛语",
"ltg": "拉特加莱语",
"luo": "Luo",
"lus": "米佐语",
"lv": "拉脱维亚语",
"mai": "迈蒂利语",
"mak": "马卡萨",
"mg": "马尔加什语",
"mi": "毛利语",
"min": "米南语",
"mk": "马其顿语",
"ml": "马拉雅拉姆语",
"mn": "蒙古语",
"mr": "马拉地语",
"ms": "马来语",
"mt": "马耳他语",
"my": "缅甸语",
"ne": "尼泊尔语",
"new": "尼泊尔语（尼瓦尔语）",
"nl": "荷兰语",
"no": "挪威语",
"nr": "恩德贝莱语（南部）",
"nso": "北索托语（塞佩蒂语）",
"nus": "努尔语",
"ny": "齐切瓦语（尼扬贾语）",
"oc": "奥克斯坦语",
"om": "Oromo",
"or": "奥里亚语（奥里亚）",
"pa": "旁遮普语",
"pag": "邦阿西楠语",
"pam": "邦板牙语",
"pap": "Papiamento",
"pl": "波兰语",
"ps": "Pashto",
"pt": "葡萄牙语",
"pt-BR": "葡萄牙语（巴西）",
"pt-PT": "葡萄牙语（葡萄牙）",
"qu": "克丘亚语",
"ro": "罗马尼亚语",
"rom": "罗姆语",
"rn": "Rundi",
"ru": "俄语",
"rw": "卢旺达语",
"sa": "梵语",
"scn": "西西里语",
"sd": "信德语",
"sg": "Sango",
"shn": "掸语",
"si": "僧伽罗语",
"sk": "斯洛伐克语",
"sl": "斯洛文尼亚语",
"sm": "萨摩亚语",
"sn": "修纳语",
"so": "索马里语",
"sq": "阿尔巴尼亚语",
"sr": "塞尔维亚语",
"ss": "斯瓦特语",
"st": "塞索托语",
"su": "巽他语",
"sv": "瑞典语",
"sw": "斯瓦希里语",
"szl": "西里西亚语",
"ta": "泰米尔语",
"te": "泰卢固语",
"tet": "德顿语",
"tg": "塔吉克语",
"th": "泰语",
"ti": "提格里尼亚语",
"tk": "土库曼语",
"tl": "菲律宾语（塔加拉语）",
"tn": "茨瓦纳语",
"tr": "土耳其语",
"ts": "聪加语",
"tt": "鞑靼语",
"ug": "维吾尔语",
"uk": "乌克兰语",
"ur": "乌尔都语",
"uz": "乌兹别克语",
"vi": "越南语",
"xh": "科萨语",
"yi": "意第绪语",
"yo": "约鲁巴语",
"yua": "尤卡坦玛雅语",
"yue": "粤语",
"zh": "简体中文",
"zh-TW": "中文（繁体）",
"zu": "祖鲁语"
示例值：en
Target 是 String 目标语言，支持：
"ab": "阿布哈兹语",
"ace": "亚齐语",
"ach": "阿乔利语",
"af": "南非荷兰语",
"ak": "契维语（阿坎语）",
"am": "Amharic",
"ar": "阿拉伯语",
"as": "阿萨姆语",
"ay": "艾马拉语",
"az": "阿塞拜疆语",
"ba": "巴什基尔语",
"ban": "巴厘语",
"bbc": "巴塔克托巴语",
"bem": "Bemba",
"bew": "Betawi",
"bg": "保加利亚语",
"bho": "博杰普尔语",
"bik": "Bikol",
"bm": "班巴拉语",
"bn": "孟加拉语",
"br": "布列塔尼语",
"bs": "波斯尼亚语",
"btx": "巴塔克卡罗语",
"bts": "巴塔克西马隆贡语",
"bua": "布里亚特语",
"ca": "加泰罗尼亚语",
"ceb": "宿务语",
"cgg": "Kiga",
"chm": "草原马里语",
"ckb": "库尔德语（索拉尼语）",
"cnh": "哈卡钦语",
"co": "科西嘉语",
"crh": "克里米亚鞑靼语",
"crs": "塞舌尔克里奥尔语",
"cs": "捷克语",
"cv": "楚瓦什语",
"cy": "威尔士语",
"da": "丹麦语",
"de": "德语",
"din": "Dinka",
"doi": "多格来语",
"dov": "敦贝语",
"dv": "第维埃语",
"dz": "宗卡语",
"ee": "Ewe",
"el": "希腊语",
"en": "英语",
"eo": "世界语",
"es": "西班牙语",
"et": "爱沙尼亚语",
"eu": "巴斯克语",
"fa": "波斯语",
"ff": "富拉语",
"fi": "芬兰语",
"fil": "菲律宾语（塔加拉语）",
"fj": "斐济语",
"fr": "法语",
"fr-CA": "法语（加拿大）",
"fr-FR": "法语（法国）",
"fy": "弗里斯兰语",
"ga": "爱尔兰语",
"gaa": "加 (Ga) 语",
"gd": "苏格兰盖尔语",
"gl": "加利西亚语",
"gn": "瓜拉尼语",
"gom": "贡根语",
"gu": "古吉拉特语",
"gv": "马恩岛语",
"ha": "Hausa",
"haw": "夏威夷语",
"he": "希伯来语",
"hi": "印地语",
"hil": "希利盖农语",
"hmn": "苗语",
"hr": "克罗地亚语",
"hrx": "洪斯吕克语",
"ht": "海地克里奥尔语",
"hu": "匈牙利语",
"hy": "亚美尼亚语",
"id": "印度尼西亚语",
"ig": "Igbo",
"ilo": "伊洛果语",
"is": "冰岛语",
"it": "意大利语",
"iw": "希伯来语",
"ja": "日语",
"jv": "爪哇语",
"jw": "爪哇语",
"ka": "格鲁吉亚语",
"kk": "哈萨克语",
"km": "高棉语",
"kn": "卡纳达语",
"ko": "韩语",
"kri": "Krio",
"ku": "库尔德语（库尔曼吉语）",
"ktu": "吉土巴语",
"ky": "吉尔吉斯语",
"la": "拉丁语",
"lb": "卢森堡语",
"lg": "干达语（卢干达语）",
"li": "林堡语",
"lij": "利古里亚语",
"lmo": "伦巴第语",
"ln": "林加拉语",
"lo": "老挝语",
"lt": "立陶宛语",
"ltg": "拉特加莱语",
"luo": "Luo",
"lus": "米佐语",
"lv": "拉脱维亚语",
"mai": "迈蒂利语",
"mak": "马卡萨",
"mg": "马尔加什语",
"mi": "毛利语",
"min": "米南语",
"mk": "马其顿语",
"ml": "马拉雅拉姆语",
"mn": "蒙古语",
"mr": "马拉地语",
"ms": "马来语",
"mt": "马耳他语",
"my": "缅甸语",
"ne": "尼泊尔语",
"new": "尼泊尔语（尼瓦尔语）",
"nl": "荷兰语",
"no": "挪威语",
"nr": "恩德贝莱语（南部）",
"nso": "北索托语（塞佩蒂语）",
"nus": "努尔语",
"ny": "齐切瓦语（尼扬贾语）",
"oc": "奥克斯坦语",
"om": "Oromo",
"or": "奥里亚语（奥里亚）",
"pa": "旁遮普语",
"pag": "邦阿西楠语",
"pam": "邦板牙语",
"pap": "Papiamento",
"pl": "波兰语",
"ps": "Pashto",
"pt": "葡萄牙语",
"pt-BR": "葡萄牙语（巴西）",
"pt-PT": "葡萄牙语（葡萄牙）",
"qu": "克丘亚语",
"ro": "罗马尼亚语",
"rom": "罗姆语",
"rn": "Rundi",
"ru": "俄语",
"rw": "卢旺达语",
"sa": "梵语",
"scn": "西西里语",
"sd": "信德语",
"sg": "Sango",
"shn": "掸语",
"si": "僧伽罗语",
"sk": "斯洛伐克语",
"sl": "斯洛文尼亚语",
"sm": "萨摩亚语",
"sn": "修纳语",
"so": "索马里语",
"sq": "阿尔巴尼亚语",
"sr": "塞尔维亚语",
"ss": "斯瓦特语",
"st": "塞索托语",
"su": "巽他语",
"sv": "瑞典语",
"sw": "斯瓦希里语",
"szl": "西里西亚语",
"ta": "泰米尔语",
"te": "泰卢固语",
"tet": "德顿语",
"tg": "塔吉克语",
"th": "泰语",
"ti": "提格里尼亚语",
"tk": "土库曼语",
"tl": "菲律宾语（塔加拉语）",
"tn": "茨瓦纳语",
"tr": "土耳其语",
"ts": "聪加语",
"tt": "鞑靼语",
"ug": "维吾尔语",
"uk": "乌克兰语",
"ur": "乌尔都语",
"uz": "乌兹别克语",
"vi": "越南语",
"xh": "科萨语",
"yi": "意第绪语",
"yo": "约鲁巴语",
"yua": "尤卡坦玛雅语",
"yue": "粤语",
"zh": "简体中文",
"zh-TW": "中文（繁体）",
"zu": "祖鲁语"
示例值：zh
UserExtPara 否 String 用户拓展参数
示例值：用户扩展字段

3. 输出参数

参数名称 类型 描述
TargetText String 翻译后的文本
示例值：你好
Source String 源语言，详见入参Source
示例值：en
Target String 目标语言，详见入参Target
示例值：zh
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 文本翻译请求示例

输入示例

POST / HTTP/1.1
Host: mps.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: TextTranslation
<公共请求参数>

{
    "SourceText": "hello",
    "Source": "zh",
    "Target": "en"
}

输出示例

{
    "Response": {
        "RequestId": "6411c585-ee14-4a53-8642-dea0f16e161d",
        "Source": "zh",
        "Target": "en",
        "TargetText": "hello"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。

错误码 描述
InvalidParameterValue.SourceLanguage SourceLanguage参数错误
InvalidParameterValue.SourceText SourceText参数错误
InvalidParameterValue.TextContent TextContent参数值错误
InvalidParameterValue.TranslateDstLanguage 参数值错误：翻译目标语言
ResourceNotFound.UserUnregister 用户未注册。
UnsupportedOperation.TextTooLong 单次请求text超过长度限制
中国站
目录