照片实人认证

传入图片格式要求

当您在进行实人认证的时候，请传入满足以下所有条件的图片：

• 认证主体的近期照片，人脸需要完整清晰无遮挡、表情自然且正对摄像头。
• 照片清晰、曝光正常，脸部无过黑、过亮、光晕等情况、角度无太大偏差。
• 分辨率不超过1920*1080（高*宽），至少640*480，推荐短边缩放到720像素，压缩率大于0.9。照片高大于宽，如果传入的照片宽大于高，可能会影响检测效果。
• 照片大小需要小于1 MB。
• 支持人像顺时针旋转90度、180度和270度，多人脸的情况会选取最大人脸。

示例：

发起认证请求

接口名：ContrastFaceVerify。

服务地址：cloudauth.aliyuncs.com。

请求方法：HTTPS POST和GET。

接口说明：通过传入图片进行实人认证。

ResultObject.MaterialInfo的JSON格式示例：

{
    // 是否为攻击：攻击为T，非攻击为F。
    "faceAttack": "F",
    // 是否有脸部遮挡：有脸部遮挡为T，否则为F。
    "faceOcclusion": "F",
    "facialPictureFront": {
         // 人脸攻击分。
         "faceAttackScore": 0.00008597839769208804，
         // 活体人脸质量分数。
        "qualityScore": 88.3615493774414,
        // 人脸和公安比对分数，阈值可参考下表详细说明。
        "verifyScore": 50.28594166529785
    }
}

SDK使用说明

如需其他语言的SDK示例代码，您可以通过OpenAPI Explorer在线调试工具调试API接口。该工具会自动生成SDK示例代码。

Java SDK使用示例

• Maven依赖 ：

  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-core</artifactId>
      <version>4.4.3</version>
  </dependency>
  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-cloudauth</artifactId>
      <version>2.0.22</version>
  </dependency>

• 使用示例：

  DefaultProfile profile = DefaultProfile.getProfile(
              "cn-hangzhou",    // 固定为cn-hangzhou。
              "AccessKeyID",      // 您的AccessKey ID。
              "AccessKeySecret");  // 您的AccessKey Secret。
  IAcsClient client = new DefaultAcsClient(profile);
  ContrastFaceVerifyRequest request = new ContrastFaceVerifyRequest();
  // 固定值。
  request.setProductCode("ID_MIN");
  // 固定值。
  request.setCertType("IDENTITY_CARD");
  request.setCertName("姓名张三");
  request.setIp("用户IP地址");
  request.setMobile("用户手机号");
  request.setDeviceToken("通过设备指纹获取的deviceToken");
  request.setUserId("用户ID");
  request.setCertNo("18位身份证号");
  request.setOuterOrderNo("商户请求的唯一标识");
  request.setSceneId(10xxxxxxL);
  request.setModel("FRONT_CAMERA_LIVENESS");
  
  
  // 请在以下四种方式中选择其一。
  // 1.照片Base64编码。
  // 2.照片OSS bucket名和文件名。
  // 3.照片OSS的URL地址。
  // 4.已经实人认证通过的CertifyId。
  
  // 方式一：照片Base64。
  request.setFaceContrastPicture("人脸照片Base64编码");
  // 方式二：照片OSS bucket名和文件名。
  //request.setOssBucketName("cn-shanghai-aliyun-cloudauth-xxxxx");
  //request.setOssObjectName("verify/xxxxx/xxxxxx.jpeg");
  // 方式三：照片OSS的URL地址，公网可访问。
  //request.setFaceContrastPictureUrl("https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg")
  // 方式四：已经实人认证通过的CertifyId。
  //request.setCertifyId("0bfa7c493f850e5178b9f8613634c9xx");
  
  ContrastFaceVerifyResponse response = client.getAcsResponse(request);
  System.out.println(response.getCode());
  System.out.println(response.getMessage());
  System.out.println(response.getRequestId());
  System.out.println(response.getResultObject().getPassed());
  System.out.println(response.getResultObject().getMaterialInfo());
  System.out.println(response.getResultObject().getIdentityInfo());