圖片翻譯 API 簡介

概念解釋

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

說明

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

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

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

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

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

如果您對文檔內(nèi)容有任何疑問，可以通過以下幾種方式聯(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

溫馨提示：

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

接口說明

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

圖片翻譯 API HTTPS地址：

https://openapi.youdao.com/ocrtransapi

協(xié)議須知

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

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

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

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

注意:

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

輸出結(jié)果

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

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

示例

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

支持語言

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

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

服務(wù)配置

錯(cuò)誤代碼列表

常用語言 Demo

Java 示例

圖片翻譯 Java demo

Python3 示例

圖片翻譯 python3 demo

C#示例

圖片翻譯 C# demo

PHP1 示例

圖片翻譯 php demo

go 示例

圖片翻譯 go demo