文本翻译
更新时间: 2024/07/25 09:20:43
网易云信 IM 服务端提供翻译文本消息内容的 API,支持不同国家的用户通过文本消息翻译实现顺畅沟通。典型使用场景为长按对方发送的文本消息进行翻译。
注意事项
- 文本翻译为增值功能,需开通后才能使用。如需开通,可通过网易云信官网首页提供的联系方式咨询商务经理。具体计费规则请参考下文的 文本翻译计费规则。
- 该 API 单次调用可翻译的最大字符数默认为 5,000,每小时最大调用次数默认为 100 万次。
- 暂不支持将 中英文混合消息 翻译成中文。
API 使用限制
单个应用默认最高调用频率请参考 频控说明。
URL
POST http://api.netease.im/nimserver/translator/textMsg.action HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=utf-8
请求参数
-
POST 请求中 Headers 的设置请参考 API 调用方式。
-
POST 请求中 Body 的设置如下:
参数 类型 是否必传 说明 accid String 是 用户的 网易云信 IM 账号。 text String 是 需要翻译的文本,最大长度 5,000 字符。 to String 是 目标语言,不支持设置为 auto(自动识别)。
示例:"en",更多支持的语言的代码请参考下文的 支持的语言。from String 否 源语言,不传默认为 auto,即自动识别源语言。
示例:"zh-CHS",更多支持的语言的代码请参考下文的 支持的语言。
返回参数
参数 | 类型 | 示例 | 说明 |
---|---|---|---|
translation | String | Hello | 翻译结果。 |
language | String | la2en | 源语言和目标语言,由 "2" 分割,"2" 前面是源语言,后面是目标语言。 |
timestamp | Number | 1658233825185 | 翻译完成的时间。 |
示例
cURL 请求示例
cURLcurl -X POST -H "AppKey: fe416640c8e8a72734219e184*****" -H "Nonce: 12345" -H "CurTime: 1658214270" -H "CheckSum:******" -H "Content-Type: application/x-www-form-urlencoded" -d 'accid=ygy1&text=您好&to=en' 'http://api.netease.im/nimserver/translator/textMsg.action'
返回示例
JSON{
"code": 200,
"data": {
"translation": "Hello",
"language": "la2en",
"timestamp": 1658233825185
}
}
状态码
该 API 在 HTTPS Body 中返回请求的状态码,状态码详情请参考 状态码。
支持的语言
中文
英文名 | 中文名 | 代码 |
---|---|---|
Simplified Chinese | 简体中文 | zh-CHS |
Traditional Chinese | 繁体中文 | zh-CHT |
常见语种
英文名 | 中文名 | 代码 |
---|---|---|
Vietnamese | 越南语 | vi |
English | 英语 | en |
Indonesian | 印度尼西亚语 | id |
Italian | 意大利语 | it |
Spanish | 西班牙语 | es |
Japanese | 日语 | ja |
Portuguese | 葡萄牙语 | pt |
Korean | 韩语 | ko |
French | 法语 | fr |
Russian | 俄语 | ru |
German | 德语 | de |
Arabic | 阿拉伯语 | ar |
Thai | 泰语 | th |
非常见语种
英文名 | 中文名 | 代码 |
---|---|---|
Afrikaans | 南非荷兰语 | af |
Bosnian (Latin) | 波斯尼亚语 | bs |
Bulgarian | 保加利亚语 | bg |
Cantonese (Traditional) | 粤语 | yue |
Catalan | 加泰隆语 | ca |
Croatian | 克罗地亚语 | hr |
Czech | 捷克语 | cs |
Danish | 丹麦语 | da |
Dutch | 荷兰语 | nl |
Estonian | 爱沙尼亚语 | et |
Fijian | 斐济语 | fj |
Finnish | 芬兰语 | fi |
Greek | 希腊语 | el |
Haitian | 海地克里奥尔语 | ht |
Hebrew | 希伯来语 | he |
Hindi | 印地语 | hi |
Hmong | 白苗语 | mww |
Hungarian | 匈牙利语 | hu |
Kiswahili | 斯瓦希里语 | sw |
Klingon | 克林贡语 | tlh |
Latvian | 拉脱维亚语 | lv |
Lithuanian | 立陶宛语 | lt |
Malay | 马来语 | ms |
Maltese | 马耳他语 | mt |
Norwegian | 挪威语 | no |
Persian | 波斯语 | fa |
Polish | 波兰语 | pl |
Querétaro Otomi | 克雷塔罗奥托米语 | otq |
Romanian | 罗马尼亚语 | ro |
Serbian (Cyrillic) | 塞尔维亚语(西里尔文) | sr-Cyrl |
Serbian (Latin) | 塞尔维亚语(拉丁文) | sr-Latn |
Slovak | 斯洛伐克语 | sk |
Slovenian | 斯洛文尼亚语 | sl |
Swedish | 瑞典语 | sv |
Tahitian | 塔希提语 | ty |
Tongan | 汤加语 | to |
Turkish | 土耳其语 | tr |
Ukrainian | 乌克兰语 | uk |
Urdu | 乌尔都语 | ur |
Welsh | 威尔士语 | cy |
Yucatec | 尤卡坦玛雅语 | yua |
Albanian | 阿尔巴尼亚语 | sq |
Amharic | 阿姆哈拉语 | am |
Armenian | 亚美尼亚语 | hy |
Azeerbaijani | 阿塞拜疆语 | az |
Bangla | 孟加拉语 | bn |
Basque | 巴斯克语 | eu |
Belarusian | 白俄罗斯语 | be |
Cebuano | 宿务语 | ceb |
Corsican | 科西嘉语 | co |
Esperanto | 世界语 | eo |
Filipino | 菲律宾语 | tl |
Frisian | 弗里西语 | fy |
Galician | 加利西亚语 | gl |
Georgian | 格鲁吉亚语 | ka |
Gujarati | 古吉拉特语 | gu |
Hausa | 豪萨语 | ha |
Hawaiian | 夏威夷语 | haw |
Icelandic | 冰岛语 | is |
Igbo | 伊博语 | ig |
Irish | 爱尔兰语 | ga |
Javanese | 爪哇语 | jw |
Kannada | 卡纳达语 | kn |
Kazakh | 哈萨克语 | kk |
Khmer | 高棉语 | km |
Kurdish | 库尔德语 | ku |
Kyrgyz | 柯尔克孜语 | ky |
Lao | 老挝语 | lo |
Latin | 拉丁语 | la |
Luxembourgish | 卢森堡语 | lb |
Macedonian | 马其顿语 | mk |
Malagasy | 马尔加什语 | mg |
Malayalam | 马拉雅拉姆语 | ml |
Maori | 毛利语 | mi |
Marathi | 马拉地语 | mr |
Mongolian | 蒙古语 | mn |
Myanmar (Burmese) | 缅甸语 | my |
Nepali | 尼泊尔语 | ne |
Nyanja (Chichewa) | 齐切瓦语 | ny |
Pashto | 普什图语 | ps |
Punjabi | 旁遮普语 | pa |
Samoan | 萨摩亚语 | sm |
Scots | 苏格兰盖尔语 | gd |
Sesotho | 塞索托语 | st |
Shona | 修纳语 | sn |
Sindhi | 信德语 | sd |
Sinhala (Sinhalese) | 僧伽罗语 | si |
Somali | 索马里语 | so |
Sundanese | 巽他语 | su |
Tajik | 塔吉克语 | tg |
Tamil | 泰米尔语 | ta |
Telugu | 泰卢固语 | te |
Uzbek | 乌兹别克语 | uz |
Xhosa | 南非科萨语 | xh |
Yiddish | 意第绪语 | yi |
Yoruba | 约鲁巴语 | yo |
Zulu | 南非祖鲁语 | zu |
文本翻译计费规则
IM 文本翻译服务根据调用的语言以及对应语言翻译的字符数计费。
计费模式
- 无功能费,单个应用,每月可免费翻译 50 万字符。
- 如超过免费限额,则按照增值费用进行计费:
- 中文与常见语种互译:200 元 / 500 万字符
- 中文与非常见语种互译:400 元 /500 万字符
- 非常见语种之间互译:400 元 /500 万字符
不计费情况说明
- 单次 API 调用如失败且返回
500
状态码(表示服务器内部错误),则不计费。 - 同一文本 5 分钟内的重复翻译不计费。
欠费说明
- 每月初上月累计的调用量自动清零。如欠费,文本翻译服务不关停,直至 IM 关停。
此文档是否对你有帮助?