图片翻译 API 简介

概念解释

图片翻译：基于文字识别与文本翻译技术，结合组段和渲染技术，满足用户翻译图片文字的需求，提升输入效率。

说明

Hi，您好，欢迎使用有道智云图片翻译API接口服务。

如果您想快速体验服务，建议您前往图片翻译体验中心 或者在体验中心右下侧找到小程序二维码，扫描进行体验。

本文档主要针对需要集成HTTP API的技术开发工程师，详细描述图片翻译能力相关的技术内容。

如果您有与我们商务合作的需求，可以通过以下方式联系我们：

商务邮箱： AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

客服QQ：1906538062

智云翻译技术交流QQ 1群: 652880659

智云翻译技术交流QQ 2群: 669384425

智云翻译技术交流QQ 3群: 807539209

智云翻译技术交流QQ 4群: 936752411

联系邮箱： zhiyun@corp.youdao.com

温馨提示：

• 本文档主要针对开发人员，接入测试前需要获取应用ID和应用密钥；如果您还没有，请按照新手指南获取。
• 平台向每个账户赠送50元的体验金，供用户集成前测试所用，具体资费规则详见 图片翻译服务报价 。

接口说明

图片翻译API接口提供有道的图片文字识别翻译服务。您只需要通过调用图片翻译API，传入图片的Base64编码，指定源语言与目标语言，通过POST请求方式，就可以识别图片中的文字并进行翻译。

图片翻译 API HTTPS地址：

https://openapi.youdao.com/ocrtransapi

协议须知

调用方在集成文本翻译API时，请遵循以下规则。

接口调用参数

调用API需要向接口发送以下字段来访问服务。

签名生成方法如下： signType=v3； sign=sha256(应用ID+input+salt+curtime+应用密钥)； 其中，input的计算方式为：input=q前10个字符 + q长度 + q后10个字符（当q长度大于20）或 input=q字符串（当q长度小于等于20）；

注意:

1. 请先将需要识别的图片转换为 Base64 编码。
2. 在发送HTTP请求之前需要对各字段做 URL encode。
3. 在生成签名拼接 应用ID+q+salt+应用密钥 字符串时，q 不需要做 URL encode，在生成签名之后，发送 HTTP 请求之前才需要对要发送的 q 做URL encode。
4. 签名和请求有疑问，可以参考文档最后的常用语言demo。

输出结果

返回的结果是json格式，具体说明如下：

注：resRegions是一个json列表，表示图中多个区域对应的翻译结果，每个json中有6个参数：boundingBox、linesCount、lineheight、context、linespace、tranContent。

示例

发送请求，调用接口：

{
    "type":"1",
    "q":"BASE64",    //要翻译的图片BASE 64编码
    "from":"en",
    "to":"zh-CHS",
    "appKey":"test",
    "salt":"1995882C5064805BC30A39829B779D7B",
    "sign":"f9976efca9dd9e280d4c6637230da5d94c2df6e520605db5a5a4d1d91ba45761",
    "signType":"v3",
    "docType":"json"
}

返回结果：

{
    "orientation": "Up",
    "lanFrom": "en",
    "textAngle": "0.0",
    "errorCode": "0",
    "lanTo": "zh-CHS",
    "resRegions": [{
        "boundingBox": "134,0,1066,249",
        "linesCount": 7,
        "lineheight": 28,
        "context": " There are two ways to cope with the problem in government. One (dis cussed in the preceding chapter) is to supply the service or product in a marketlike environment. Shift the burden of evaluation off the shoulders of professional evaluators and onto the shoulders of clients and customers, and let the latter vote with their feet. The \"client\" in these cases can be individual citizens or government agencies; what is important is that the client be able to choose from among rival suppliers.",
        "linespace": 7,
        "tranContent": "有两种方法可以解决政府的问题。一个(在前一章中讨论的)是在一个市场环境中提供服务或产品。将评估的负担从专业评估人员的肩膀上转移到客户和客户的肩上，让后者用脚投票。这些案件的“委托人”可以是公民个人或政府机构;重要的是客户可以从竞争对手那里选择。"
        }, {
        "boundingBox": "116,253,1100,354",
        "linesCount": 10,
        "lineheight": 28,
        "context": " But some public services cannot be supplied, or arc never going to be sup plied, by a market. We can imagine allowing parents to choose among schools but we cannot imagine letting them choose (at least for most purposes) among police departments or armies. In that case one should adopt the second way of evaluating a public service: carry out a demonstration project or conduct a field experiment. (I will use the two ideas interchangeably, though some schol ars distinguish between them.7) An experiment is a planned alteration in a state of affairs designed to measure the effect of the intervention. It involves asking the question, \"If I change X, what will happen to Y, having first made certain that everything else stays the same?\" It sounds easy, but it is not.",
        "linespace": 5,
        "tranContent": "但是一些公共服务不能提供，或者不能被市场所垄断。我们可以想象允许父母在学校里选择，但我们无法想象让他们在警察部门或军队中选择(至少是在大多数情况下)。在这种情况下，应该采用第二种评价公共服务的方法:进行示范项目或进行现场试验。(我将把这两种观点交替使用，尽管有些学校将两者区分开来。)实验是一种计划中的改变，旨在衡量干预的效果。它涉及到问这个问题，“如果我改变X, Y会发生什么，首先确定其他一切都保持不变?”这听起来很容易，但事实并非如此。"
        }, {
        "boundingBox": "101,609,1141,152",
        "linesCount": 4,
        "lineheight": 28,
        "context": " A good experiment (bad ones are worse than no experiment at all) requires that one do the following: First, identify a course of action to be test ed; call it the treatment. A \"treatment\" can be a police tactic, a school cur riculum, or a welfare program. Second, decide what impact the treatment is",
        "linespace": 5,
        "tranContent": "一个好的实验(坏的实验比没有实验更糟糕)需要一个人做以下的事情:首先，确定要测试的行动过程;叫它治疗。“治疗”可以是警察的策略，也可以是学校里的，或者是福利项目。其次，确定治疗的影响。"
    }]
}

支持语言

下表为各语言对应代码：

**注意：**若列表语言出现不支持的问题，请参考产品定价列表语种互译的限制

服务配置

错误代码列表

常用语言 Demo

Java 示例

图片翻译 Java demo

Python3 示例

图片翻译 python3 demo

C#示例

图片翻译 C# demo

PHP1 示例

图片翻译 php demo

go 示例

图片翻译 go demo