文档

证件照质量审核

更新时间:

本文介绍图像识别(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

证照类型。

  • 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小时后会被系统自动清理删除。

  • 本页导读 (1)
文档反馈