本文介绍证件照质量审核EvaluateCertificateQuality的语法及示例。

功能描述

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

应用场景

  • 网络认证:在网络认证时,需要提交身份证、营业执照、护照、支票等证件照片。而拍摄的照片质量不一,部分照片由于拍摄或水印的原因,难以达到认证的清晰程度要求。证件照质量审核可以自动识别出证件图像质量问题,减少人力审核投入。
  • 登记注册:在线下登记注册操作时,需要拍摄证件电子档照片,但拍摄条件水平不一, 部分照片质量存在问题。通过证件照质量审核可以筛选出有质量问题的照片,以免使用和识别的过程中出现操作失败和报错的情况。

特色优势

  • 全方面检查:对影响认证的照片质量因素做全方面检查。检查项包括:是否目标证件类型、是否缺乏正面照、是否为复印件、证件图像是否完整、是否缺乏印章、是否来源于电子档、有无反光、有无水印覆盖、文字清晰度。从以上方面考察照片是否影响认证效力。
  • 实际业务积累:该算法经过阿里实际业务沉淀,实际总结了诸多影响注册审核的各种质量问题,可助力业务自动化。

前提条件

请确保您已开通图像识别服务,若未开通服务请立即开通

图片限制

  • 图像类型:JPEG、JPG、BMP、PNG。
  • 图像大小:小于10M。
  • 图像分辨率:大于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/RecognizeBusinessLicense.jpg

图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

Type String BusinessLicense

证照类型。

  • IDCard:身份证。
  • BusinessLicense:电子执照。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

Elements Array of Element

输出识别出的质量问题列表。

Pass String false

是否通过检查。

  • true:通过检查。
  • false:未通过检查。
  • verify:无法检验证照质量,请人工确认。
  • ERROR:该模块算法推理失败。
Score String 0.06514739990234375

质量问题分值,分值越高,问题越严重,取值为0~100之间的整数。

  • 当系统无法给出分值时,输出结果为score
  • Pass字段为ERROR时,输出结果为null
Value String lackoffront

问题类型。

  • nottargettype:不是目标证件类型。
  • lackoffront: 缺乏正面照。
  • copy:复印件。
  • imageincomplete:证件图像不完整。
  • nationalemblemincomplete:营业执照国徽不完整。
  • lackofseal:缺乏印章。
  • electronic:来源于电子档。
  • reflection:反光。
  • watermarksoverlay:水印覆盖。
  • textclarity:文字清晰度。
说明
  • 如果请求参数Type为IDCard,无lackofseal(缺乏印章)。
  • 如果请求参数Type为BusinessLicense,无lackoffront(缺乏正面照)。
RequestId String 656318DC-3856-43E3-9147-859532721AD6

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=EvaluateCertificateQuality
&ImageURL=https://viapi-doc.oss-cn-shanghai.aliyuncs.com/imagerecog/RecognizeBusinessLicense.jpg
&Type=BusinessLicense
&<公共请求参数>

正常返回示例

XML格式

<RequestId>656318DC-3856-43E3-9147-859532721AD6</RequestId>
<Data>
    <Elements>
        <Value>lackoffront</Value>
        <Score>0.06514739990234375</Score>
        <Pass>false</Pass>
    </Elements>
</Data>

JSON格式

{
    "RequestId": "656318DC-3856-43E3-9147-859532721AD6",
    "Data": {
        "Elements": {
            "Value": "lackoffront",
            "Score": 0.06514739990234375,
            "Pass": false
        }
    }
}

错误码

关于证件照质量审核的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。