资讯 社区 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

图片翻译

接口描述

基于业界领先的深度学习技术及翻译技术,提供多场景、多语种、高精度的整图识别+翻译服务。您只需传入图片,即可识别图片中的文字并进行翻译。

请求说明

请求示例

HTTP 方法:POST 请求URL:https://aip.baidubce.com/file/2.0/mt/pictrans/v1

URL参数:

接口类型 描述
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header如下:

参数
Content-Type multipart/form-data

Body中放置请求参数,参数详情如下:

请求参数

字段名 类型 是否必填 描述
image FILES Y 请求翻译的图片数据
from TEXT Y 源语种方向
to TEXT Y 译文语种方向
v INT Y 固定值:3
paste INT N 图片贴合类型:0 - 关闭文字贴合 1 - 返回整图贴合 2 - 返回块区贴合

注:

1)图片类型使用image/jpeg、image/png,注意均为小写。图片大小不超过4M,最短边至少30px,最长边最大4096px,长宽比3:1以内。

2)image使用FILE协议图片上传Content-Type=mutipart/form-data。

返回参数

参数 描述 备注 类型
error_code 返回错误码 0 成功 详情查看错误码列表 int
error_msg 错误信息 success
data 返回数据 数据结构类似app拍照翻译,去掉一些返回参数 object
from 源语种方向 支持语种方向见下方 string
to 目标语种方向 支持语种方向见下方 string
content 分段翻译内容 包含每一段识别内容详情及定位信息 array
sumSrc 未分段翻译原文 多段之间,请用\n拼接 string
sumDst 未分段翻译译文 多段之间,请用\n拼接 string
pasteImg 图片贴合 (整屏贴合) paste=1有效,base64格式 string

content数据结构

参数 描述 备注
src 识别原文
dst 翻译译文
rect 原文擦除矩形位置 格式:"rect":"0 0 321 199"矩形的位置信息,依次顺序left, top, wide, high (以图片左上角顶点为坐标原点)
points 译文贴合矩形位置 (坐标0点为左上角),坐标顺序左上,右上,右下,左下
lineCount 合并行数 表示该分段信息是原文的多少行合并在一起
pasteImg 分段贴合图片 paste=2有效,base64格式

支持语种方向

语言 标识
自动检测 auto(目标语言不可设置为auto)
英语 en
中文 zh
日语 jp
韩语 kor
葡萄牙语 pt
法语 fra
德语 de
意大利语 it
西班牙 spa
俄语 ru
荷兰语 nl
马来语 may
丹麦语 dan
瑞典语 swe
印尼语 id
波兰语 pl
罗马尼亚语 rom
土耳其语 tr
希腊语 el
匈牙利语 hu

错误码列表

接口流控及鉴权错误码

错误码 错误信息 描述 解决方法
1 Unknown error 未知错误 请重试
2 Service temporarily unavailable 服务处理超时 请重试
4 Open api request limit reached 集群超限额 请重试
6 no permission to access data 没有接口权限 请确认您调用的接口已经被赋权。企业认证生效时间为1小时左右,使用需要企业认证的服务,请等待生效后重试
18 Open api qps request limit reached QPS超限额 请降低您的调用频率
19 Open api total request limit reached 请求总量超限额 请检查当前可用字符/次数包额度
100 Invalid parameter 请求参数不合法 请检查请求参数是否正确,可能的原因是token拉取失败,无效的access token参数等”
110 Access token invalid or no longer valid Access Token失效 token有效期为30天,注意需要定期更换,也可以每次请求都拉取新token
111 Access token expired Access token过期 token有效期为30天,注意需要定期更换,也可以每次请求都拉取新token

通用及业务错误码

错误码 错误信息 描述 解决方法
0 Success 成功
52001 TIMEOUT 请求超时 重试
52002 SYSTEM ERROR 系统错误 重试
54000 PARAM_FROM_TO_OR_Q_EMPTY 必填参数为空或固定参数有误 检查参数是否误传
54003 Invalid Access Limit 访问频率受限 请降低您的访问频率
54005 Long query overflow, retry later 长query请求频繁 请降低长query的发送频率,3s后再试
58001 INVALID_TO_PARAM 译文语言方向不支持,或译文语言字段有误 请检查译文语言是否在语言列表里
69001 picture fail 上传图片数据有误 检查图片是否有问题
69002 picture recognition time out 图片识别超时 重试
69003 picture recognition fail 内容识别失败 更换图片重试
69004 picture recognition empty 识别内容为空 更换图片重试
69005 picture size limit 4M 图片大小超限(超过4M) 更换图片重试
69006 picture px error 图片尺寸不符合标准(最短边至少30px,最长边最大4096px) 更换图片重试
69007 picture format error 图片格式不支持 更换图片重试
69012 Invalid param paste type 文字贴合参数异常 请检查参数 paste,枚举示例:0-关闭文字贴合 1-返回整图贴合 2-返回块区贴合

使用案例

如下是一张照片:

WechatIMG25.jpeg

返回格式

{
    "error_code":"0",
    "error_msg":"success",
    "data":{
        "from":"zh",
        "to":"en",
        "content":[
            {
                "src":"这是一个测试 ",
                "dst":"This is a test.",
                "rect":"79 23 246 43",
                "lineCount":1,
                "pasteImg":"xxx",
                "points":[{"x":254,"y":280},{"x":506,"y":278},{"x":506,"y":303},{"x":254,"y":305}]
            },
            {
                "src":"这是一个例子 ",
                "dst":"This is an example.",
                "rect":"79 122 201 37",
                "lineCount":1,
                "pasteImg":"xxx",
                "points":[{"x":254,"y":280},{"x":506,"y":278},{"x":506,"y":303},{"x":254,"y":305}]
            }
        ],
        "sumSrc":"这是一个测试 这是一个例子 ",
        "sumDst":"This is a test. This is an example."
        "pasteImg":"xxx"
    }
}

请求代码示例

提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。

提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。

<?php
/**
 * Send post request.
 *
 * @param string $url request url
 * @param string $imgPath 本地图片地址
 * @param string $from 翻译源语种
 * @param string $to 翻译目标语种
 * @param int $paste 贴合类型 0-不贴合 1-整图贴合 2-块区贴合
 * @return mixed
 */
function sendPostRequest(string $url, string $imgPath, string $from, string $to, int $paste = 0)
{
    $header = ['Content-Type' => 'multipart/form-data'];
    $formData = [
        'from' => $from,
        'to' => $to,
        'v' => 3,
        'paste' => $paste,
        'image' => '@' . realpath($imgPath) . ';type=image/jpeg',
    ];
    if (class_exists('CURLFile')) {
        $formData['image'] = new CURLFile(realpath($imgPath));
    }
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $formData);
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    $res = curl_exec($ch);
    curl_close($ch);
    
    return $res;
}

$token = '[调用鉴权接口获取的token]';// example: xxx
$url = 'https://aip.baidubce.com/file/2.0/mt/pictrans/v1?access_token=' . $token;
$imgPath = '本地文件绝对路径'; // example: /xx/xx.jpg
$from = '源语种方向'; // example: zh
$to = '目标语种方向'; // example: en
$paste = 1; //图片贴合类型
$res = sendPostRequest($url, $imgPath, $from, $to, $paste);
var_dump($res);
curl -i -k 'https://aip.baidubce.com/file/2.0/mt/pictrans/v1?access_token=[调用鉴权接口获取的token]'
#   python ocr_translate.py <image>
# ```
# You may install `requests` to run this code: pip install requests
# Please refer to `https://api.fanyi.baidu.com/doc/26` for complete api document

import requests
import random
import json
import os
import sys
from hashlib import md5


file_name = '【图片路径】'

url = 'https://aip.baidubce.com/file/2.0/mt/pictrans/v1?access_token=【access_token】'

from_lang = 'zh'
to_lang = 'en'

# Build request
payload = {'from': from_lang, 'to': to_lang, 'v': '3', 'paste': '1'}
image = {'image': (os.path.basename(file_name), open(file_name, 'rb'), "multipart/form-data")}

# Send request
response = requests.post(url, params = payload, files = image)
result = response.json()

# Show response
print(json.dumps(result, indent = 4, ensure_ascii = False))
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

import java.io.File;


class Demo {
    /**
    unirest下载地址https://mvnrepository.com/artifact/com.mashape.unirest/unirest-java
    */
    public static String pictrans() {
        // 请求url
        String url = "https://aip.baidubce.com/file/2.0/mt/pictrans/v1";
        try {
            String param = "{\"id\": \"kR7z8nOMLV7prmE194Po\"}";
            // 注意这里仅为了简化编码每一次请求都去获取access_token,线上环境access_token有过期时间, 客户端可自行缓存,过期后重新获取。
            String accessToken = "";
            Unirest.setTimeouts(0, 0);
            HttpResponse<String> response = Unirest.post("https://aip.baidubce.com/file/2.0/mt/pictrans/v1?access_token=" + accessToken)
                    .field("image", new File("/Users/xxxx/Downloads/033102.jpeg"))
                    .field("from", "zh")
                    .field("to", "cht")
                    .field("v", "3")
                    .asString();
            String result = response.getBody();
            System.out.println(result);
            return result;
        } catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }
    public static void main(String[] args) {
        pictrans();
    }
}
#include <iostream>
#include <curl/curl.h>

// libcurl库下载链接:https://curl.haxx.se/download.html
// jsoncpp库下载链接:https://github.com/open-source-parsers/jsoncpp/
const static std::string request_url = "https://aip.baidubce.com/file/2.0/mt/pictrans/v1";

int pictrans(std::string &json_result, const std::string &access_token) {
    std::string url = request_url + "?access_token=" + access_token;
    CURL *curl = NULL;
    CURLcode result_code;
    int is_success;
    curl = curl_easy_init();
    if (curl) {
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
        curl_easy_setopt(curl, CURLOPT_URL, url.data());
        curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
        curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
        struct curl_slist *headers = NULL;
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_mime *mime;
        curl_mimepart *part;
        mime = curl_mime_init(curl);
        part = curl_mime_addpart(mime);
        curl_mime_name(part, "image");
        curl_mime_filedata(part, "/Users/xxx/demo.jpeg");
        part = curl_mime_addpart(mime);
        curl_mime_name(part, "from");
        curl_mime_data(part, "zh", CURL_ZERO_TERMINATED);
        part = curl_mime_addpart(mime);
        curl_mime_name(part, "to");
        curl_mime_data(part, "en", CURL_ZERO_TERMINATED);
        part = curl_mime_addpart(mime);
        curl_mime_name(part, "v");
        curl_mime_data(part, "3", CURL_ZERO_TERMINATED);
        curl_easy_setopt(curl, CURLOPT_MIMEPOST, mime);
        json_result = curl_easy_perform(curl);
        curl_mime_free(mime);
        curl_easy_cleanup(curl);
        is_success = 0;
    } else {
        fprintf(stderr, "curl_easy_init() failed.");
        is_success = 1;
    }
    return is_success;
}
using System;
using System.IO;
using System.Net;
using System.Text;
using System.Web;
using RestSharp;

namespace com.baidu.ai
{
    public class Demo
    {
        public static string pictrans()
        {
            string token = "[调用鉴权接口获取的token]";
            string host = "https://aip.baidubce.com/file/2.0/mt/pictrans/v1?access_token=" + token;
            var client = new RestClient(host);
            client.Timeout = -1;
            var request = new RestRequest(Method.POST);
            request.AddFile("image", "/Users/xxx/demo.jpeg");
            request.AddParameter("from", "zh");
            request.AddParameter("to", "en");
            request.AddParameter("v", "3");
            IRestResponse response = client.Execute(request);
            string result = response.Content;
            Console.WriteLine(result);
            return result;
        }
    }
}
上一篇
文档翻译
下一篇
语音翻译