网易云信 IM 服务端支持翻译文本消息，支持不同国家的用户通过文本消息翻译实现顺畅沟通。典型使用场景为长按对方发送的文本消息，进行翻译。

• 若需要使用文本翻译功能，需要提前登录 网易云信控制台 在 应用管理 > 产品功能 > IM 即时通讯 > 全局功能 开通 IM 翻译服务。具体计费规则，请根据服务区域参考 国内计费 或 海外计费。
• 该 API 单次调用可翻译的最大字符数默认为 5000，每小时最大调用次数默认为 100 万次。
• 暂不支持将 中英文混合消息 翻译成中文。

调用频率

单个应用默认最高调用频率请参考 频控说明。

请求信息

请求 URL

POST https://{endpoint}/im/v2/translations

请求 URL 中的 {endpoint} 代表服务地址域名，您可以根据用户服务区域选择中国大陆和海外服务地址，并支持搭建高可用主备域名机制。详情请参考 调用方式 服务地址章节。

请求头参数

请求 Header 的参数说明请参考 请求 Header。

请求体参数

参数名称	类型	是否必选	描述
operator_account_id	String	是	操作者账号 ID。
source_text	String	是	需要翻译的文本信息，最大长度 5000 字符。
source_language	String	否	输入的文本对应的语言，默认为 auto（自动识别）。
target_language	String	是	输出文本对应的语言。 示例："en"，更多支持的语言的代码请参考下文的 支持的语言。
- translator_config	Object	否	翻译相关配置。
strict	Boolean	否	是否严格按照输入的 source_language 和 target_language 进行翻译。默认为 true：是，若设置为 false，则会根据现有规则进行中译英，英译中，例如： 中译中（source_language 和 target_language 都为 zh），若 strict 为 false，则 target_language 自动变为 en。 英译英（source_language 和 target_language 都为 en），strict 为 false，则 target_language 自动变为 zh。

请求体示例

JSON{
  "operator_account_id": "user123456",
  "source_text": "文本内容",
  "source_language": "zh",
  "target_language": "en",
  "translator_config": {
    "strict": true
  }
}

响应信息

响应头参数

响应 Header 的参数说明请参考 响应 Header。

响应体参数

参数名称	类型	说明	是否必返回
code	Integer	状态码，200 表示请求成功。	是
msg	String	提示信息。请求失败时返回错误信息，请求成功时返回 "success"。	是
- data	Object	返回的 JSON 数据对象，请求失败则返回空对象。	是
translated_text	String	翻译的文本内容。	是
source_language	String	输入文本对应的语言。	是
target_language	String	输出文本对应的语言。	是

响应体示例

JSON{
  "code": 200,
  "msg": "success",
  "data": {
    "translated_text": "translated text",
    "source_language": "zh",
    "target_language": "en"
  }
}

状态码

该 API 在 HTTPS Body 中返回请求的状态码，状态码详情请参考 状态码。

支持的语言

中文

代码	中文名	英文名
zh-CHS	简体中文	Simplified Chinese
zh-CHT	繁体中文	Traditional Chinese

常见语种

代码	中文名	英文名
ar	阿拉伯语	Arabic
de	德语	German
en	英语	English
es	西班牙语	Spanish
fr	法语	French
id	印度尼西亚语	Indonesian
it	意大利语	Italian
ja	日语	Japanese
ko	韩语	Korean
pt	葡萄牙语	Portuguese
ru	俄语	Russian
th	泰语	Thai
vi	越南语	Vietnamese

非常见语种

代码	中文名	英文名
af	南非荷兰语	Afrikaans
am	阿姆哈拉语	Amharic
az	阿塞拜疆语	Azeerbaijani
be	白俄罗斯语	Belarusian
bg	保加利亚语	Bulgarian
bn	孟加拉语	Bangla
bs	波斯尼亚语	Bosnian (Latin)
ca	加泰隆语	Catalan
ceb	宿务语	Cebuano
co	科西嘉语	Corsican
cs	捷克语	Czech
cy	威尔士语	Welsh
da	丹麦语	Danish
el	希腊语	Greek
eo	世界语	Esperanto
et	爱沙尼亚语	Estonian
eu	巴斯克语	Basque
fa	波斯语	Persian
fi	芬兰语	Finnish
fj	斐济语	Fijian
fy	弗里西语	Frisian
ga	爱尔兰语	Irish
gd	苏格兰盖尔语	Scots
gl	加利西亚语	Galician
gu	古吉拉特语	Gujarati
ha	豪萨语	Hausa
haw	夏威夷语	Hawaiian
he	希伯来语	Hebrew
hi	印地语	Hindi
hr	克罗地亚语	Croatian
ht	海地克里奥尔语	Haitian
hu	匈牙利语	Hungarian
hy	亚美尼亚语	Armenian
ig	伊博语	Igbo
is	冰岛语	Icelandic
jw	爪哇语	Javanese
ka	格鲁吉亚语	Georgian
kk	哈萨克语	Kazakh
km	高棉语	Khmer
kn	卡纳达语	Kannada
ku	库尔德语	Kurdish
ky	柯尔克孜语	Kyrgyz
la	拉丁语	Latin
lb	卢森堡语	Luxembourgish
lo	老挝语	Lao
lt	立陶宛语	Lithuanian
lv	拉脱维亚语	Latvian
mg	马尔加什语	Malagasy
mi	毛利语	Maori
mk	马其顿语	Macedonian
ml	马拉雅拉姆语	Malayalam
mn	蒙古语	Mongolian
mr	马拉地语	Marathi
ms	马来语	Malay
mt	马耳他语	Maltese
mww	白苗语	Hmong
my	缅甸语	Myanmar (Burmese)
ne	尼泊尔语	Nepali
nl	荷兰语	Dutch
no	挪威语	Norwegian
ny	齐切瓦语	Nyanja (Chichewa)
otq	克雷塔罗奥托米语	Querétaro Otomi
pa	旁遮普语	Punjabi
pl	波兰语	Polish
ps	普什图语	Pashto
ro	罗马尼亚语	Romanian
sd	信德语	Sindhi
si	僧伽罗语	Sinhala (Sinhalese)
sk	斯洛伐克语	Slovak
sl	斯洛文尼亚语	Slovenian
sm	萨摩亚语	Samoan
sn	修纳语	Shona
so	索马里语	Somali
sq	阿尔巴尼亚语	Albanian
sr-Cyrl	塞尔维亚语(西里尔文)	Serbian (Cyrillic)
sr-Latn	塞尔维亚语(拉丁文)	Serbian (Latin)
st	塞索托语	Sesotho
su	巽他语	Sundanese
sv	瑞典语	Swedish
sw	斯瓦希里语	Kiswahili
ta	泰米尔语	Tamil
te	泰卢固语	Telugu
tg	塔吉克语	Tajik
tl	菲律宾语	Filipino
tlh	克林贡语	Klingon
to	汤加语	Tongan
tr	土耳其语	Turkish
ty	塔希提语	Tahitian
uk	乌克兰语	Ukrainian
ur	乌尔都语	Urdu
uz	乌兹别克语	Uzbek
xh	南非科萨语	Xhosa
yi	意第绪语	Yiddish
yo	约鲁巴语	Yoruba
yua	尤卡坦玛雅语	Yucatec
yue	粤语	Cantonese (Traditional)
zu	南非祖鲁语	Zulu

计费相关

IM 文本翻译服务根据调用的语言以及对应语言翻译的字符数计费。具体计费规则，请根据服务区域参考 国内计费 或 海外计费。

特殊说明

• 单次 API 调用如失败且返回 500 状态码（表示服务器内部错误），则不计费。
• 同一文本 5 分钟内的重复翻译不计费。

欠费说明

每月初上月累计的调用量自动清零。如欠费，文本翻译服务不关停，直至 IM 关停。