API 参考
圈组

文本翻译

更新时间: 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 关停。
此文档是否对你有帮助?
有帮助
去反馈
  • 注意事项
  • API 使用限制
  • URL
  • 请求参数
  • 返回参数
  • 示例
  • cURL 请求示例
  • 返回示例
  • 状态码
  • 支持的语言
  • 中文
  • 常见语种
  • 非常见语种
  • 文本翻译计费规则
  • 计费模式
  • 不计费情况说明
  • 欠费说明