本文介紹圖像識別(imagerecog)類目下的證件照質量審核EvaluateCertificateQuality的語法及示例。
功能描述
證件照質量審核能力可以識別拍攝的證件照片是否存在質量問題,且有哪些質量問題。
- 您可以進入在線咨詢獲取在線人工幫助。
- 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們。
應用場景
- 網絡認證:在網絡認證時,需要提交身份證、營業執照、護照、支票等證件照片。而拍攝的照片質量不一,部分照片由于拍攝或水印的原因,難以達到認證的清晰程度要求。證件照質量審核可以自動識別出證件圖像質量問題,減少人力審核投入。
- 登記注冊:在線下登記注冊操作時,需要拍攝證件電子檔照片,但拍攝條件水平不一, 部分照片質量存在問題。通過證件照質量審核可以篩選出有質量問題的照片,以免使用和識別的過程中出現操作失敗和報錯的情況。
特色優勢
- 全方面檢查:對影響認證的照片質量因素做全方面檢查。檢查項包括:是否目標證件類型、是否缺乏正面照、是否為復印件、證件圖像是否完整、是否缺乏印章、是否來源于電子檔、有無反光、有無水印覆蓋、文字清晰度。從以上方面考察照片是否影響認證效力。
- 實際業務積累:該算法經過阿里實際業務沉淀,實際總結了諸多影響注冊審核的各種質量問題,可助力業務自動化。
接入指引
1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:請確保您已開通圖像識別服務,若未開通服務請立即開通。
3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為圖像識別(imagerecog)的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 示例代碼:該能力常用語言的示例代碼,請參見證件照質量審核示例代碼。
7. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 圖像類型:JPEG、JPG、BMP、PNG。
- 圖像大小:小于10 MB。
- 圖像分辨率:大于100×100像素,小于5000×5000像素。
- URL地址中不能包含中文字符。
計費說明
證件照質量審核能力目前處于公測期,可免費調用。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | EvaluateCertificateQuality | 系統規定參數。取值:EvaluateCertificateQuality。 |
ImageURL | String | 是 | https://viapi-doc.oss-cn-shanghai.aliyuncs.com/imagerecog/xxxxx.jpg | 圖像URL地址。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 |
Type | String | 是 | BusinessLicense | 證照類型。
|
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 656318DC-3856-43E3-9147-859532721AD6 | 請求ID。 |
Data | Object | 返回的結果數據內容。 |
|
Elements | Array of Element | 輸出識別出的質量問題列表。 |
|
Value | String | lackoffront | 問題類型。
說明
|
Pass | String | false | 是否通過檢查。
|
Score | String | 0.06514739990234375 | 質量問題分值,分值越高,問題越嚴重,取值為0~100之間的整數。
|
SDK參考
阿里云視覺AI圖像識別類目下的證件照質量審核能力推薦使用SDK調用,支持多種編程語言,調用時請選擇AI類目為圖像識別(imagerecog)的SDK包,文件參數通過SDK調用可支持本地文件及任意URL,具體可參見SDK總覽。
示例代碼
該能力常用語言的示例代碼,請參見證件照質量審核示例代碼。
示例
請求示例
http(s):/imagerecog.cn-shanghai.aliyuncs.com/?Action=EvaluateCertificateQuality //更多關于訪問域名(Endpoint)信息,請參見:http://m.bestwisewords.com/document_detail/143103.html
&ImageURL=https://viapi-doc.oss-cn-shanghai.aliyuncs.com/imagerecog/xxxxx.jpg
&Type=BusinessLicense
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>656318DC-3856-43E3-9147-859532721AD6</RequestId>
<Data>
<Elements>
<Value>lackoffront</Value>
<Score>0.06514739990234375</Score>
<Pass>false</Pass>
</Elements>
</Data>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "656318DC-3856-43E3-9147-859532721AD6",
"Data" : {
"Elements" : {
"Value" : "lackoffront",
"Score" : 0.06514739990234375,
"Pass" : false
}
}
}
錯誤碼
關于證件照質量審核的錯誤碼,詳情請參見常見錯誤碼。
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規。
- 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統自動清理刪除。