批量翻译

更新时间:

批量翻译文本，每次最多提交 30 条，每条原文最多 1,024 个字符。

POSThttps://translate.ilivedata.com/api/v1/batchTranslate

请求参数

请求头

以下请求头均为必需。

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 — 签名值，计算方式见下文「请求签名」

请求体

参数 类型 必需 说明
contents Array 必需 待翻译文本列表，每次最多 30 条。

contents[]

参数 类型 必需 说明
q String 必需 需要翻译的原文文本。文本为不超过 1024 个字符的 UTF-8 编码字符串
target String 必需 目标语言代码，取值见语言支持。
source String 可选 原文本的语种（下称“源语言”）。可设置为语言支持中列举的 ISO 639-1 标准的语言代码之一。未传该参数及 source 值为空或无效时，将自动进行语种检测。
profanity String 可选 敏感内容过滤功能。可选值为 censor 或 off ，分别对应开启和关闭，如未指定则默认关闭。此功能仅通过关键词屏蔽，如果您的业务对文本审核有更高要求或需定制，欢迎您接入云上曲率的多语言文本审核服务。
fromId String 可选 需要翻译的文本的发送人 ID，使用上下文翻译模型时，需要传此参数。
toId String 可选 需要翻译的文本的接收人 ID
id String 可选 用于标识翻译结果的唯一 ID

请求示例

{
  "contents": [
    {
      "q": "hello world!",
      "target": "zh-CN"
    }
  ]
}

请求签名

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

签名参数 值
HTTPMethod POST
HostHeaderInLowercase translate.ilivedata.com
HTTPRequestURI /api/v1/batchTranslate

HTTP 响应

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

响应为 JSON 数组，每个元素包含一条文本的处理结果。

响应字段

字段 类型 说明
errorCode Number 错误码，0 表示成功
errorMessage String 错误消息
translation Object 翻译结果

translation

字段 类型 说明
id String 原文唯一标识
source String 原文语种
target String 翻译目标语种
sourceText String 原文文本
targetText String 翻译结果

响应示例

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