服务端 API商业版

翻译文本

将文本翻译为指定语言，并返回译文和检测到的源语言。此接口仅在 OpenIM 商业版中提供。请先在接入准备中配置 API 地址和有效 Token。

HTTP 请求

POST {API_ADDRESS}/third/translate_text

请求示例

curl --request POST "${API_ADDRESS}/third/translate_text" \
  --header "Content-Type: application/json; charset=utf-8" \
  --header "operationID: ${OPERATION_ID}" \
  --header "token: ${TOKEN}" \
  --data-raw '{
  "content": "示例内容",
  "sourceLanguageCode": "zh-CN",
  "targetLanguageCode": "zh-CN"
}'

商业版：此接口需要部署对应的商业版服务。接口是否可用以及具体权限以客户交付版本为准。

请求体

{
  "content": "示例内容",
  "sourceLanguageCode": "zh-CN",
  "targetLanguageCode": "zh-CN"
}

参数名	是否必填	类型	说明
content	是	string	文本内容，具体格式由当前接口和内容类型决定。
sourceLanguageCode	是	string	源语言 BCP 47 标签；为空时自动检测。
targetLanguageCode	是	string	目标语言 BCP 47 标签。

响应

请求被 OpenIM 正常处理时通常返回 200 OK。业务是否成功以响应体中的 errCode 为准。

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "translatedText": "示例内容",
    "detectedLanguageCode": "zh-CN"
  }
}

响应参数

参数名	类型	说明
errCode	int	业务错误码，`0` 表示成功。
errMsg	string	错误简要信息，成功时通常为空。
errDlt	string	错误详细信息，成功时通常为空。
data.translatedText	string	翻译后的文本。
data.detectedLanguageCode	string	检测到的源语言 BCP 47 标签。

错误

错误响应使用 Platform API 通用结构，处理方式见错误码。

权限和限制

仅在 OpenIM 商业版中提供。
调用方必须校验操作用户和目标资源的业务权限。
请求数组和分页大小应遵循客户交付版本的服务端限制。

HTTP 请求

请求示例

请求体

响应

响应参数

错误

权限和限制

相关页面