本文介绍证件照质量审核EvaluateCertificateQuality的语法及示例。
功能描述
证件照质量审核能力可以识别拍摄的证件照片是否存在质量问题,且有哪些质量问题。
应用场景
- 网络认证:在网络认证时,需要提交身份证、营业执照、护照、支票等证件照片。而拍摄的照片质量不一,部分照片由于拍摄或水印的原因,难以达到认证的清晰程度要求。证件照质量审核可以自动识别出证件图像质量问题,减少人力审核投入。
- 登记注册:在线下登记注册操作时,需要拍摄证件电子档照片,但拍摄条件水平不一, 部分照片质量存在问题。通过证件照质量审核可以筛选出有质量问题的照片,以免使用和识别的过程中出现操作失败和报错的情况。
特色优势
- 全方面检查:对影响认证的照片质量因素做全方面检查。检查项包括:是否目标证件类型、是否缺乏正面照、是否为复印件、证件图像是否完整、是否缺乏印章、是否来源于电子档、有无反光、有无水印覆盖、文字清晰度。从以上方面考察照片是否影响认证效力。
- 实际业务积累:该算法经过阿里实际业务沉淀,实际总结了诸多影响注册审核的各种质量问题,可助力业务自动化。
前提条件
输入限制
- 图像类型: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链接,如何生成URL请参见生成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之间的整数。
|
示例
请求示例
http(s)://[Endpoint]/?Action=EvaluateCertificateQuality
&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
}
}
}
错误码
关于证件照质量审核的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。