通用文字識別 API 簡介

概念解釋

通用文字識別：將自然場景下圖片上的文字內容，通過定位和檢測，智能識別為可編輯的文本信息。

說明

Hi，您好，歡迎使用有道智云通用文字識別 API接口服務。

如果您想快速體驗服務，建議您前往 體驗中心 或者在體驗中心右下側找到小程序二維碼，掃描進行體驗。

本文檔主要針對需要集成HTTP API的技術開發(fā)工程師，詳細描述OCR識別能力相關的技術內容。

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

商務郵箱： AIcloud_Business@corp.youdao.com

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

客服QQ：1906538062

智云OCR技術交流QQ 1群: 654064748

智云OCR技術交流QQ 2群: 471638046

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

溫馨提示：

• 本文檔主要針對開發(fā)人員，接入測試前需要獲取應用ID和應用密鑰；如果您還沒有，請按照 新手指南 獲取。
• 平臺向每個賬戶贈送50元的體驗金，供用戶集成前測試所用，具體資費規(guī)則詳見 通用文字識別服務報價 。

接口能力

有道智云OCR API接口提供有道的OCR文字識別服務，目前有道智云OCR支持八十種語言的文字識別。您只需要通過調用有道智云OCR API，傳入經過Base64編碼的圖片，通過POST請求方式，就可以得到相應的文字識別結果。

有道智云OCR API HTTPS地址：

https://openapi.youdao.com/ocrapi

注：請求采用application/x-www-form-urlencoded，不用JSON。

協(xié)議須知

調用方在集成通用文字識別 API時，請遵循以下規(guī)則。

接口調用參數(shù)

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

簽名生成方法如下： signType=v3； sign=sha256(應用ID+input+salt+curtime+應用密鑰)。

其中，input的計算方式為：input=img前10個字符 + img長度 + img后十個字符（當img長度大于20）或 input=img字符串（當img長度小于等于20）。

不同語言獲取時間戳，請參看此鏈接

如果對簽名有疑問，可以參看文檔末尾各語言demo。

輸出結果

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

即識別結果主要在Result中，輸出結構為：regions->lines->words.一個文檔可能有多個region，代表段落，一個段落有多行，一行有多個字。

每個段落、每行、每個字都有boundingBox，代表能夠框住段落、行、字的最大box的位置信息。

boundingBox共八個值：分別是左上角坐標(x,y)，右上角坐標(x,y)，右下角坐標(x,y)，左下角(x,y)。

具體可參見下面的參考示例。

參考示例

識別的返回結果：

{
    "errorCode": "0",   //識別錯誤碼
    "Result": {         //識別結果
        "orientation": "UP",//圖像方向
        "regions": [        //段落
        {
            "boundingBox": "90,56,232,56,232,244,90,244",   //段落區(qū)域位置信息
	    "dir": "h",	//按行識別
	    "lang": "zh",	//語種
            "lines": [      //行
            {
            "boundingBox": "116,56,204,56,204,82,116,82",   //行區(qū)域位置信息
            "words": [  //字
                {
                    "boundingBox": "124,54,148,54,148,86,124,86",   //字區(qū)域位置信息
                    "word": "靜" //字識別結果
                },
                {
                "boundingBox": "156,54,172,53,172,85,156,86",
                "word": "夜"
                },
                {
                "boundingBox": "180,53,204,53,204,85,180,85",
                "word": "思"
                }
            ],
            "text": "靜夜思"   //行識別結果
        },
        ...
        ]
        }
        ]
    }
}

支持語言

auto支持所有語種的自動識別

服務配置

錯誤代碼列表

常用語言 Demo

Java 示例

通用ocr Java demo

Python3 示例

通用ocr python3 demo

C#示例

通用ocr c# demo

PHP 示例

通用ocr php demo

go 示例

通用ocr go demo