证件照质量审核EvaluateCertificateQuality的语法及示例_视觉智能开放平台(VIAPI)-阿里云帮助中心

功能描述

证件照质量审核能力可以识别拍摄的证件照片是否存在质量问题，且有哪些质量问题。

说明

您可以进入在线咨询获取在线人工帮助。
阿里云视觉智能开放平台视觉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	证照类型。 IDCard：身份证。 BusinessLicense：电子执照。

返回数据

名称	类型	示例值	描述
RequestId	String	656318DC-3856-43E3-9147-859532721AD6	请求ID。
Data	Object		返回的结果数据内容。
Elements	Array of Element		输出识别出的质量问题列表。
Value	String	lackoffront	问题类型。 lackoffront：缺乏正面照。 copy：复印件。 imageincomplete：证件图像不完整。 nationalemblemincomplete：营业执照国徽不完整。 lackofseal：缺乏印章。 electronic：来源于电子档。 reflection：反光。说明如果请求参数Type为IDCard，无lackofseal（缺乏印章）。如果请求参数Type为BusinessLicense，无lackoffront（缺乏正面照）。
Pass	String	false	是否通过检查。 true：通过检查。 false：未通过检查。 verify：无法检验证照质量，请人工确认。 ERROR：该模块算法推理失败。
Score	String	0.06514739990234375	质量问题分值，分值越高，问题越严重，取值为0~100之间的整数。当系统无法给出分值时，输出结果为`score`。当Pass字段为`ERROR`时，输出结果为`null`。

SDK参考

阿里云视觉AI图像识别类目下的证件照质量审核能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。

示例代码

该能力常用语言的示例代码，请参见证件照质量审核示例代码。

示例

请求示例

http(s):/imagerecog.cn-shanghai.aliyuncs.com/?Action=EvaluateCertificateQuality      //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.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小时后会被系统自动清理删除。