跳到主要内容

文本翻译

融云即使通讯（IM）服务端 API 提供文本翻译功能，可将文本内容翻译成指定的目标语言。

通过本接口，您可将文本内容翻译成指定目标语言，支持多种语言之间的互译, 支持的翻译语言详见翻译语言代码列表。

开通服务​

使用智能文本翻译功能前，请在融云控制台，开通智能文本翻译功能。

如未开通服务，Server API 将返回 28400 错误。注意，在未开通服务时，如果连续请求导致 API 请求频率超过限制，Server API 会返回 HTTP 429 Too Many Requests 错误（错误码为 1008）。

请求方法​

POST： https://数据中心域名/v3/translate.json

频率限制：每秒钟限 10 次

签名规则：所有服务端 API 请求均需要进行规则校验，详见 API 请求签名。

正文参数​

HTTP 请求正文数据格式为 application/json，支持以下参数：

参数类型必传说明
textString是需要翻译的文本内容，长度不超过 1000 个字符。
sourceLanguageString否源语言的语言代码，默认不传为 auto。注：当粤语为源语言时, 不支持使用 auto 作为语言代码。
targetLanguageString是目标语言的语言代码，默认为 zh。

请求示例​

HTTP
POST /v3/translate.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/json
X-Request-ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXX (最大长度 36)

{
    "text": "你好世界",
    "targetLanguage": "en",
    "sourceLanguage": "auto"
}

响应结果​

HTTP 响应正文包含具有以下结构的 JSON 对象：

返回值类型是否必须说明
codeNumber是返回码，200 为正常
translatedString否翻译后的文本内容

响应结果示例​

JSON
{
    "code": 200,
    "translated": "Hello world."
}