本文介绍证件照质量审核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

证照类型。

  • 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。

示例

请求示例

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