本文介紹文字識(shí)別(ocr)類目下的二維碼識(shí)別RecognizeQrCode的語(yǔ)法及示例。
功能描述
二維碼識(shí)別能力可以識(shí)別圖像中是否含有二維碼信息,輸出圖像中二維碼包含的文本信息(每個(gè)二維碼對(duì)應(yīng)的URL或文本),可支持圖像中含有多個(gè)二維碼識(shí)別。
- 在同時(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)介紹。
調(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í)行的操作,取值包括:
|
QrCodesData | Array of String | https://yqh.aliyun.com/live/detail/23798 | 圖片中含有二維碼時(shí),返回圖片中二維碼包含的文本信息(每個(gè)二維碼對(duì)應(yīng)的URL或者文本)。 說(shuō)明 不是所有的二維碼圖片都能識(shí)別返回出對(duì)應(yīng)的URL或文本。
|
Label | String | qrcode | 檢測(cè)結(jié)果的分類,取值包括:
說(shuō)明 默認(rèn)不識(shí)別小程序碼。如果需要識(shí)別,請(qǐng)通過(guò)釘釘群(23109592)聯(lián)系我們。 |
Rate | Float | 99.91 | 結(jié)果為該分類的概率,取值范圍為 |
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)清理刪除。