圖片翻譯 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