圖片翻譯 API 簡(jiǎn)介

概念解釋

圖片翻譯：基于文字識(shí)別與文本翻譯技術(shù)，結(jié)合組段和渲染技術(shù)，滿足用戶翻譯圖片文字的需求，提升輸入效率。

說(shuō)明

Hi，您好，歡迎使用有道智云圖片翻譯API接口服務(wù)。

如果您想快速體驗(yàn)服務(wù)，建議您前往圖片翻譯體驗(yàn)中心 或者在體驗(yàn)中心右下側(cè)找到小程序二維碼，掃描進(jìn)行體驗(yàn)。

本文檔主要針對(duì)需要集成HTTP API的技術(shù)開(kāi)發(fā)工程師，詳細(xì)描述圖片翻譯能力相關(guān)的技術(shù)內(nèi)容。

如果您有與我們商務(wù)合作的需求，可以通過(guò)以下方式聯(lián)系我們：

商務(wù)郵箱： AIcloud_Business@corp.youdao.com

如果您對(duì)文檔內(nèi)容有任何疑問(wèn)，可以通過(guò)以下幾種方式聯(lián)系我們：

客服QQ：1906538062

智云翻譯技術(shù)交流QQ 1群: 652880659

智云翻譯技術(shù)交流QQ 2群: 669384425

智云翻譯技術(shù)交流QQ 3群: 807539209

智云翻譯技術(shù)交流QQ 4群: 936752411

聯(lián)系郵箱： zhiyun@corp.youdao.com

溫馨提示：

• 本文檔主要針對(duì)開(kāi)發(fā)人員，接入測(cè)試前需要獲取應(yīng)用ID和應(yīng)用密鑰；如果您還沒(méi)有，請(qǐng)按照新手指南獲取。
• 平臺(tái)向每個(gè)賬戶贈(zèng)送50元的體驗(yàn)金，供用戶集成前測(cè)試所用，具體資費(fèi)規(guī)則詳見(jiàn) 圖片翻譯服務(wù)報(bào)價(jià) 。

接口說(shuō)明

圖片翻譯API接口提供有道的圖片文字識(shí)別翻譯服務(wù)。您只需要通過(guò)調(diào)用圖片翻譯API，傳入圖片的Base64編碼，指定源語(yǔ)言與目標(biāo)語(yǔ)言，通過(guò)POST請(qǐng)求方式，就可以識(shí)別圖片中的文字并進(jìn)行翻譯。

圖片翻譯 API HTTPS地址：

https://openapi.youdao.com/ocrtransapi

協(xié)議須知

調(diào)用方在集成文本翻譯API時(shí)，請(qǐng)遵循以下規(guī)則。

接口調(diào)用參數(shù)

調(diào)用API需要向接口發(fā)送以下字段來(lái)訪問(wèn)服務(wù)。

簽名生成方法如下：
signType=v3；
sign=sha256(應(yīng)用ID+input+salt+curtime+應(yīng)用密鑰)；
其中，input的計(jì)算方式為：input=q前10個(gè)字符 + q長(zhǎng)度 + q后10個(gè)字符（當(dāng)q長(zhǎng)度大于20）或 input=q字符串（當(dāng)q長(zhǎng)度小于等于20）；

注意:

1. 請(qǐng)先將需要識(shí)別的圖片轉(zhuǎn)換為 Base64 編碼。
2. 在發(fā)送HTTP請(qǐng)求之前需要對(duì)各字段做 URL encode。
3. 在生成簽名拼接 應(yīng)用ID+q+salt+應(yīng)用密鑰 字符串時(shí)，q 不需要做 URL encode，在生成簽名之后，發(fā)送 HTTP 請(qǐng)求之前才需要對(duì)要發(fā)送的 q 做URL encode。
4. 簽名和請(qǐng)求有疑問(wèn)，可以參考文檔最后的常用語(yǔ)言demo。

輸出結(jié)果

返回的結(jié)果是json格式，具體說(shuō)明如下：

注：resRegions是一個(gè)json列表，表示圖中多個(gè)區(qū)域?qū)?yīng)的翻譯結(jié)果，每個(gè)json中有6個(gè)參數(shù)：boundingBox、linesCount、lineheight、context、linespace、tranContent。

示例

發(fā)送請(qǐng)求，調(diào)用接口：

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

返回結(jié)果：

{
    "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": "有兩種方法可以解決政府的問(wèn)題。一個(gè)(在前一章中討論的)是在一個(gè)市場(chǎng)環(huán)境中提供服務(wù)或產(chǎn)品。將評(píng)估的負(fù)擔(dān)從專業(yè)評(píng)估人員的肩膀上轉(zhuǎn)移到客戶和客戶的肩上，讓后者用腳投票。這些案件的“委托人”可以是公民個(gè)人或政府機(jī)構(gòu);重要的是客戶可以從競(jìng)爭(zhēng)對(duì)手那里選擇。"
        }, {
        "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": "但是一些公共服務(wù)不能提供，或者不能被市場(chǎng)所壟斷。我們可以想象允許父母在學(xué)校里選擇，但我們無(wú)法想象讓他們?cè)诰觳块T(mén)或軍隊(duì)中選擇(至少是在大多數(shù)情況下)。在這種情況下，應(yīng)該采用第二種評(píng)價(jià)公共服務(wù)的方法:進(jìn)行示范項(xiàng)目或進(jìn)行現(xiàn)場(chǎng)試驗(yàn)。(我將把這兩種觀點(diǎn)交替使用，盡管有些學(xué)校將兩者區(qū)分開(kāi)來(lái)。)實(shí)驗(yàn)是一種計(jì)劃中的改變，旨在衡量干預(yù)的效果。它涉及到問(wèn)這個(gè)問(wèn)題，“如果我改變X, Y會(huì)發(fā)生什么，首先確定其他一切都保持不變?”這聽(tīng)起來(lái)很容易，但事實(shí)并非如此。"
        }, {
        "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": "一個(gè)好的實(shí)驗(yàn)(壞的實(shí)驗(yàn)比沒(méi)有實(shí)驗(yàn)更糟糕)需要一個(gè)人做以下的事情:首先，確定要測(cè)試的行動(dòng)過(guò)程;叫它治療?！爸委煛笨梢允蔷斓牟呗?，也可以是學(xué)校里的，或者是福利項(xiàng)目。其次，確定治療的影響。"
    }]
}

支持語(yǔ)言

下表為各語(yǔ)言對(duì)應(yīng)代碼：

注意：若列表語(yǔ)言出現(xiàn)不支持的問(wèn)題，請(qǐng)參考產(chǎn)品定價(jià)列表語(yǔ)種互譯的限制

服務(wù)配置

錯(cuò)誤代碼列表

常用語(yǔ)言 Demo

Java 示例

圖片翻譯 Java demo

Python3 示例

圖片翻譯 python3 demo

C#示例

圖片翻譯 C# demo

PHP1 示例

圖片翻譯 php demo

go 示例

圖片翻譯 go demo