批量翻译

更新时间:

批量翻译接口

域名： https://translate.ilivedata.com

路径： POST /api/v1/batchTranslate

描述： 主要用作批量文本的翻译。

请求头：

请求头 值 描述
Content-Type application/json;charset=UTF-8 请求体类型
Accept application/json;charset=UTF-8 接受的返回类型
X-AppId 例：1234 项目或应用的唯一标识符
X-TimeStamp 例：2024-07-01T07:59:59Z 请求的UTC时间戳。需要把时间戳按W3C标准格式化，例如: 2024-07-01T07:59:59Z.
Authorization 例：Njl86M/jY6zZaZoGhZdGO+GI/8+yGFECusGH1234567= 签名值

请求体：

参数 是否必需 类型 描述
contents 是 List 批量翻译请求内容，最多处理不超过30条

contents：

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

请求示例:

curl -X POST --location "https://translate.ilivedata.com/api/v1/batchTranslate" \
    -H "Host: translate.ilivedata.com" \
    -H "Authorization: Njl86M/jY6zZaZoGhZdGO+GI/8+yGFECusGH1234567=" \
    -H "X-AppId: 1234" \
    -H "X-TimeStamp: 2025-01-09T16:10:59Z" \
    -H "Content-Type: application/json;charset=UTF-8" \
    -d '{
        	"contents": [
        	  {
        	    "q": "hello world!",
        	    "target": "zh-CN"
        	  }
        	]
        }'

响应结果：

结果为JSON-Array格式，具体参数说明：

字段名 类型 描述
errorCode Number 错误码，0表示成功
errorMessage String 错误消息
translation 对象 翻译结果

translation结构：

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

HTTP响应示例：

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