本文介紹文字識(shí)別(ocr)類目下的二維碼識(shí)別RecognizeQrCode的語(yǔ)法及示例。

功能描述

二維碼識(shí)別能力可以識(shí)別圖像中是否含有二維碼信息,輸出圖像中二維碼包含的文本信息(每個(gè)二維碼對(duì)應(yīng)的URL或文本),可支持圖像中含有多個(gè)二維碼識(shí)別。

說(shuō)明
  • 在同時(shí)檢測(cè)多個(gè)Task的情況下,將按照Task的個(gè)數(shù)進(jìn)行累計(jì)計(jì)費(fèi)。
  • 您可以進(jìn)入在線咨詢獲取在線人工幫助。
  • 當(dāng)前能力可在視覺(jué)智能開(kāi)放平臺(tái)有完整的免費(fèi)產(chǎn)品體驗(yàn),您可以單擊立即試用對(duì)該能力進(jìn)行更直觀試用以及在線購(gòu)買。
  • 阿里云視覺(jué)智能開(kāi)放平臺(tái)視覺(jué)AI能力API接入、接口使用或問(wèn)題咨詢等,請(qǐng)通過(guò)釘釘群(23109592)加入阿里云視覺(jué)智能開(kāi)放平臺(tái)咨詢?nèi)郝?lián)系我們。

接入指引

1. 注冊(cè)阿里云賬號(hào):打開(kāi)阿里云官網(wǎng),在阿里云官網(wǎng)右上角,單擊立即注冊(cè),按照操作提示完成賬號(hào)注冊(cè)。

2. 開(kāi)通能力:請(qǐng)確保您已開(kāi)通文字識(shí)別服務(wù),若未開(kāi)通服務(wù)請(qǐng)立即開(kāi)通

3. 創(chuàng)建AccessKey:請(qǐng)確保您已創(chuàng)建AccessKey,如果您使用的是子賬號(hào)AccessKey,您需要給子賬號(hào)賦予AliyunVIAPIFullAccess權(quán)限,具體操作,請(qǐng)參見(jiàn)RAM授權(quán)

4. 在線調(diào)試(可選):您可以通過(guò)OpenAPI Explorer在線調(diào)試能力,查看完整的調(diào)用示例代碼及SDK依賴信息,也可以下載完整的工程。

5. 開(kāi)發(fā)接入步驟:

  • SDK總覽中選擇您要接入使用的SDK語(yǔ)言。
  • 在對(duì)應(yīng)語(yǔ)言的SDK文檔中找到AI類目為文字識(shí)別(ocr)的SDK包進(jìn)行安裝。
  • 參考文檔中提供的示例代碼進(jìn)行適當(dāng)修改后調(diào)用。

6. 示例代碼:該能力常用語(yǔ)言的示例代碼,請(qǐng)參見(jiàn)二維碼識(shí)別示例代碼

7. 客戶端直接調(diào)用:該能力常用的客戶端調(diào)用方式包括以下幾種。

輸入限制

  • 圖像格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
  • 圖像大小:不超過(guò)10 MB。如您有大圖需求,請(qǐng)通過(guò)釘釘群(23109592)聯(lián)系我們。
  • 圖像分辨率:建議不低于256×256像素,分辨率過(guò)低可能會(huì)影響識(shí)別效果。
  • URL地址中不能包含中文字符。
  • 僅支持二維碼圖片識(shí)別,其他類型的碼不支持。

檢測(cè)說(shuō)明

  • 最長(zhǎng)檢測(cè)時(shí)間為6秒,如果在該時(shí)間限制內(nèi)沒(méi)有完成檢測(cè),系統(tǒng)會(huì)返回超時(shí)錯(cuò)誤碼。
  • 圖片下載時(shí)間限制為3秒,如果下載時(shí)間超過(guò)3秒,則返回下載超時(shí)。
  • 圖片檢測(cè)接口響應(yīng)時(shí)間依賴圖片的下載時(shí)間。請(qǐng)保證被檢測(cè)圖片所在的存儲(chǔ)服務(wù)穩(wěn)定可靠,建議您使用阿里云OSS存儲(chǔ)或者CDN緩存等。

計(jì)費(fèi)說(shuō)明

關(guān)于二維碼識(shí)別的計(jì)費(fèi)方式及報(bào)價(jià),請(qǐng)參見(jiàn)計(jì)費(fèi)介紹

說(shuō)明 下方調(diào)試接口為付費(fèi)接口,如需免費(fèi)體驗(yàn)調(diào)試請(qǐng)前往體驗(yàn)中心

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String RecognizeQrCode

系統(tǒng)規(guī)定參數(shù)。取值:RecognizeQrCode

Tasks.N.ImageURL String http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeQrCode/RecognizeQrCode6.jpg

待檢測(cè)圖像的URL地址。JSON數(shù)組中的每個(gè)元素是一個(gè)圖片檢測(cè)任務(wù)結(jié)構(gòu)體(image表)。最多支持10個(gè)元素,即最多同時(shí)對(duì)10張圖片進(jìn)行檢測(cè)。推薦使用上海地域的OSS鏈接,對(duì)于文件在本地或者非上海地域OSS鏈接的情況,請(qǐng)參見(jiàn)文件URL處理

返回?cái)?shù)據(jù)

名稱 類型 示例值 描述
RequestId String A53DC437-F883-4968-86D5-EB21FB044692

請(qǐng)求ID。

Data Object

返回的結(jié)果數(shù)據(jù)內(nèi)容。

Elements Array of Element

識(shí)別返回的元素信息。

ImageURL String http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeQrCode/RecognizeQrCode6.jpg

對(duì)應(yīng)請(qǐng)求中的圖像URL地址。

TaskId String img5iGtwVIxQzc4Nqy$L84yHd-1v****

該檢測(cè)任務(wù)的ID。

Results Array of Result

返回結(jié)果。調(diào)用成功時(shí)返回結(jié)果中包含一個(gè)或多個(gè)元素。

Suggestion String review

建議您執(zhí)行的操作,取值包括:

  • pass:圖片正常,無(wú)需進(jìn)行其余操作。
  • review:檢測(cè)結(jié)果不確定,需要進(jìn)行人工審核。
  • block:圖片違規(guī),建議執(zhí)行進(jìn)一步操作(如直接刪除或做限制處理)。
QrCodesData Array of String https://yqh.aliyun.com/live/detail/23798

圖片中含有二維碼時(shí),返回圖片中二維碼包含的文本信息(每個(gè)二維碼對(duì)應(yīng)的URL或者文本)。

說(shuō)明 不是所有的二維碼圖片都能識(shí)別返回出對(duì)應(yīng)的URL或文本。
  • 當(dāng)Suggestionreview時(shí)說(shuō)明識(shí)別到的二維碼不含對(duì)應(yīng)的URL或文本信息,QrCodesData不會(huì)透出對(duì)應(yīng)信息。
  • 當(dāng)Suggestionblock時(shí)會(huì)攜帶識(shí)別到的對(duì)應(yīng)二維碼的URL或文本信息進(jìn)行透出。
Label String qrcode

檢測(cè)結(jié)果的分類,取值包括:

  • normal:正常圖片。
  • qrcode:含二維碼的圖片。
  • programCode:含小程序碼的圖片。
說(shuō)明 默認(rèn)不識(shí)別小程序碼。如果需要識(shí)別,請(qǐng)通過(guò)釘釘群(23109592)聯(lián)系我們。
Rate Float 99.91

結(jié)果為該分類的概率,取值范圍為[0.00-100.00]。值越高,表示屬于該分類的概率越大。

SDK參考

阿里云視覺(jué)AI文字識(shí)別類目下的二維碼識(shí)別能力推薦使用SDK調(diào)用,支持多種編程語(yǔ)言,調(diào)用時(shí)請(qǐng)選擇AI類目為文字識(shí)別(ocr)的SDK包,文件參數(shù)通過(guò)SDK調(diào)用可支持本地文件及任意URL,具體可參見(jiàn)SDK總覽

示例代碼

該能力常用語(yǔ)言的示例代碼,請(qǐng)參見(jiàn)二維碼識(shí)別示例代碼

示例

請(qǐng)求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeQrCode      //更多關(guān)于訪問(wèn)域名(Endpoint)信息,請(qǐng)參見(jiàn):http://bestwisewords.com/document_detail/143103.html
&Tasks=[{"ImageURL":"http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeQrCode/RecognizeQrCode6.jpg"}]
&公共請(qǐng)求參數(shù)

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RecognizeQrCodeResponse>
    <RequestId>A53DC437-F883-4968-86D5-EB21FB044692</RequestId>
    <Data>
        <Elements>
            <ImageURL>http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeQrCode/RecognizeQrCode6.jpg</ImageURL>
            <TaskId>img5iGtwVIxQzc4Nqy$L84yHd-1v****</TaskId>
            <Results>
                <Suggestion>review</Suggestion>
                <QrCodesData>https://yqh.aliyun.com/live/detail/23798</QrCodesData>
                <Label>qrcode</Label>
                <Rate>99.91</Rate>
            </Results>
        </Elements>
    </Data>
</RecognizeQrCodeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A53DC437-F883-4968-86D5-EB21FB044692",
  "Data" : {
    "Elements" : [ {
      "ImageURL" : "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeQrCode/RecognizeQrCode6.jpg",
      "TaskId" : "img5iGtwVIxQzc4Nqy$L84yHd-1v****",
      "Results" : [ {
        "Suggestion" : "review",
        "QrCodesData" : [ "https://yqh.aliyun.com/live/detail/23798" ],
        "Label" : "qrcode",
        "Rate" : 99.91
      } ]
    } ]
  }
}

錯(cuò)誤碼

關(guān)于二維碼識(shí)別的錯(cuò)誤碼,詳情請(qǐng)參見(jiàn)常見(jiàn)錯(cuò)誤碼

安全聲明

  • 請(qǐng)確保上傳的圖片或文件來(lái)源符合相應(yīng)的法律法規(guī)。
  • 通過(guò)體驗(yàn)調(diào)試上傳的臨時(shí)文件有效期為1小時(shí),在24小時(shí)后會(huì)被系統(tǒng)自動(dòng)清理刪除。