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

注意事项

• 文本翻译为增值功能，需开通后才能使用。如需开通，可通过网易云信官网首页提供的联系方式咨询商务经理。具体计费规则请参考下文的 文本翻译计费规则。
• 该 API 单次调用可翻译的最大字符数默认为 5,000，每小时最大调用次数默认为 100 万次。
• 暂不支持将 中英文混合消息 翻译成中文。

API 使用限制

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

URL

POST http://api.yunxinapi.com/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.yunxinapi.com/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 关停。