文本翻译

提交一条文本，在同一次请求中获取源语言、目标语言和翻译结果。

POSThttps://translate.ilivedata.com/api/v3/translate

文本使用 UTF-8 编码，每次最多 1,024 个字符。请求与响应均为 JSON，使用 Authorization 签名鉴权。

接入前，请在云上曲率官网注册账号、创建企业，并在控制台选择「实时文本翻译」服务创建应用，获取项目编号和服务密钥。如需开通更多服务，可在控制台「总览」页面操作。

请求参数

以下请求头均为必需。

Header	值	说明
`Content-Type`	`application/json; charset=UTF-8`	请求体格式
`Accept`	`application/json; charset=UTF-8`	响应格式
`X-AppId`	—	控制台「服务配置」中的项目编号
`X-TimeStamp`	—	请求发起时的 UTC 时间，采用 W3C 格式。格式示例：`2026-09-30T02:30:00Z`，实际请求需使用当前时间。
`Authorization`	—	签名值，计算方式见下文「请求签名」

q 和 target 为必填参数。未传 source，或其值为空、无效时，将自动识别源语言。

参数	类型	必需	说明
`q`	`String`	必需	待翻译的原文，使用 UTF-8 编码，最多 1,024 个字符。
`target`	`String`	必需	目标语言代码，取值见语言支持。
`source`	`String`	可选	源语言代码，取值见语言支持。未传、为空或无效时，自动识别源语言。
`suggestedSource`	`String`	可选	回退参考语种。自动语种检测失败时，可将该语种作为源语言。取值见语言支持。
`profanity`	`String`	可选	敏感内容过滤：`censor` 开启，`off` 关闭，默认关闭。仅支持关键词屏蔽；更完整的审核或定制需求可接入文本审核。
`fromId`	`String`	可选	文本发送人 ID。使用上下文翻译模型时必需。
`toId`	`String`	可选	文本接收人 ID。

{
  "q": "hello world",
  "target": "zh-CN",
  "fromId": "user1"
}

按照帮助中心的请求签名计算 Authorization，使用以下接口参数。

Content-Type: application/json;charset=UTF-8

errorCode 为 0 表示调用成功，译文位于 translation.targetText。

{
  "errorCode": 0,
  "translation": {
    "source": "en",
    "target": "zh-CN",
    "sourceText": "hello world",
    "targetText": "你好世界"
  }
}