图片翻译API接入文档

POST

https://fanyi-api.baidu.com/api/trans/sdk/picture

本文档是百度翻译开放平台图片翻译API的用户指南，描述了图片翻译相关接口的说明。API接入方式对于IOS端、Android端、Web端均适用。新版本不再提供图片翻译SDK服务，已经接入的用户可下拉至本文档末尾查看SDK错误码列表。

API接入方式（IOS端、Android端、Web端均适用）

如何使用图片翻译API

使用您的百度账号登录百度翻译开放平台；

注册成为开发者，获得APPID；

进行开发者认证；

开通图片翻译API服务：开通链接；

参考技术文档和Demo编写代码。

接入方式

集成指南

请求url示例

https://fanyi-api.baidu.com/api/trans/sdk/picture?
from=zh&to=en&appid=20180905000111111&salt=1435660288&sign=bf7303b9be4191726f62c19115c9a165&cuid=APICUID&mac=mac&version=3

输入参数：
注：
1）支持jpg、jpeg、png图片格式，注意均为小写。图片大小不超过4M，最短边至少30px，最长边最大4096px，长宽比3：1以内。
2）签名规则：md5(appid+md5(image)+salt+cuid+mac+密钥)。
3）md5(image) 中的image是原始图片数据，不加任何编码，32位小写。
4）image图片上传Content-Type=multipart/form-data。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://fanyi-api.baidu.com/api/trans/sdk/picture' \
--data-urlencode 'image=' \
--data-urlencode 'from=' \
--data-urlencode 'to=' \
--data-urlencode 'appid=' \
--data-urlencode 'salt=' \
--data-urlencode 'cuid=' \
--data-urlencode 'mac=' \
--data-urlencode 'version=' \
--data-urlencode 'sign='

响应示例

{
  "error_code": "string",
  "error_msg": "string",
  "data": "string",
  "from": "string",
  "to": "string",
  "content": [
    {
      "src": "string",
      "dst": "string",
      "rect": "string",
      "lineCount": 0,
      "points": [
        "string"
      ],
      "pasteImg": "string"
    }
  ],
  "sumSrc": "string",
  "sumDst": "string",
  "pasteImg": "string"
}

请求参数

Body 参数application/x-www-form-urlencoded

image

string

请求翻译的图片数据

必需

from

string

必需

目前源语种方向，参考附录1

string

必需

译文语种方向，参考附录2

appid

string

必需

APPID，可在管理控制台查看

salt

string

随机数

必需

cuid

string

必需

固定值：APICUID

mac

string

固定值：mac

必需

version

string

固定值：3

必需

paste

string

可选

图片贴合类型：0 - 关闭文字贴合、1 - 返回整图贴合、2 - 返回块区贴合

sign

string

签名，32位小写

必需

返回响应

🟢200成功

application/json

Body

error_code

string

错误码

必需

详见错误码列表

error_msg

string

错误信息

必需

以错误码54001为例，其返回的错误信息是Invalid Sign

data

string

返回数据集合

必需

data是一个对象

from

string

源语种方向

必需

参考支持语种列表

string

目标语种方向

必需

参考支持语种列表

content

array [object {6}]

分段内容

必需

Content内部是一个数组形式，每个数据格式见下方详细说明

src

string

分段翻译的原文

必需

dst

string

分段翻译的译文

必需

rect

string

表示识别出的文字的位置

必需

坐标为左上角，依次是left、top、width、height

lineCount

integer

表示该分段信息是原文的多少行合并在一起

必需

points

array[string]

译文矩形坐标

必需

坐标为左上角，坐标顺序左上，右上，右下，左下格式： [ {"x": 254,"y": 280}, {"x": 506,"y": 278}, {"x": 506,"y": 303}, {"x": 254,"y": 305} ]

pasteImg

string

图片贴合 (分块贴合)

必需

分段贴合图片，paste=2有效，base64格式

sumSrc

string

未分段翻译原文

必需

接入举例中的“这是一个测试这是一个例子”

sumDst

string

未分段翻译译文

必需

接入举例中的“This is a test. This is an example.”

pasteImg

string

图片贴合 (整屏贴合)

必需

paste=1有效，base64格式

SDK接入方式

语种列表

图片翻译API接入文档

API接入方式（IOS端、Android端、Web端均适用）#

如何使用图片翻译API#

接入方式#

集成指南#

请求url示例#

请求参数

返回响应

API接入方式（IOS端、Android端、Web端均适用）

如何使用图片翻译API

接入方式

集成指南

请求url示例