图文翻译

识别图片中的文字，并翻译为指定语言，返回识别文本、文字坐标和翻译结果。

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

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

请求参数

请求头

以下请求头均为必需。

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

请求体

参数	类型	必需	说明
`type`	`Number`	必需	图片传入方式：`1` 图片 URL，`2` 图片 Base64 编码。图片资源与翻译服务不在同一区域时，推荐使用 Base64，避免网络不佳导致下载缓慢或失败。
`image`	`String`	必需	图片内容：`type=1` 时为 URL，`type=2` 时为 Base64 编码。支持 JPG、PNG、BMP、GIF、WebP、TIFF、HEIC，图片大小上限为 10 MB。
`target`	`String`	必需	目标语言代码，取值见语言支持。

请求示例

{
  "type": 2,
  "target": "zh-CN",
  "image": "图片文件的 Base64 编码"
}

请求签名

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

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

HTTP 响应

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

errorCode 表示接口调用结果；code 表示图片处理状态：0 成功、1 下载失败、2 格式错误、3 其他。

响应字段

字段	类型	说明
`errorCode`	`Number`	错误码，`0` 表示成功
`errorMessage`	`String`	错误消息
`code`	`Number`	状态码，定义为：0:检测成功，1:图片下载失败，2:图片格式错误，3:其他
`taskId`	`String`	翻译任务唯一标识
`ocr`	`String[]`	识别出的图文列表
`ocrDetail`	`OcrDetail[]`	识别出的文字详细信息，包含文本内容和坐标。
`translateResult`	`TranslateResult[]`	翻译结果

`ocrDetail[]`

字段	类型	说明
`text`	`String`	文本内容
`coordinate`	`Number[][]`	文本对应的一组坐标, 分别是矩形文本框四个顶点的相对坐标, 范围在(0,1)

`translateResult[]`

字段	类型	说明
`source`	`String`	图文语种
`target`	`String`	翻译目标语种
`sourceText`	`String`	图文内容
`targetText`	`String`	翻译结果

响应示例

{
  "errorCode": 0,
  "code": 0,
  "ocr": [
    "MICHAEL"
  ],
  "ocrDetail": [
    {
      "coordinate": [
        [
          0.8256130790190735,
          0.9365079365079365
        ],
        [
          0.9346049046321526,
          0.9365079365079365
        ],
        [
          0.9346049046321526,
          0.981859410430839
        ],
        [
          0.8256130790190735,
          0.981859410430839
        ]
      ],
      "text": "MICHAEL"
    }
  ],
  "taskId": "Tencent-ap_867488e27ab14c138180479992ab114b_1719829148272",
  "translateResult": [
    {
      "source": "en",
      "target": "zh-CN",
      "sourceText": "MICHAEL",
      "targetText": "迈克尔"
    }
  ]
}