人脸静默活体检测API

人脸静默活体检测API

接口名：LivenessFaceVerify。

服务地址：cloudauth.aliyuncs.com。

请求方法：HTTPS POST和GET。

接口说明：调用LivenessFaceVerify接口对人脸图片进行活体检测。

请求参数

返回数据

{
    // 是否为攻击。T表示是，F表示否。
    "faceAttack": "F",
    // 是否有脸部遮挡。T表示是，F表示否。
    "faceOcclusion": "F",
    "facialPictureFront": {
         // 人脸攻击分。
         "faceAttackScore": 0.00008597839769208804，
         // 活体人脸质量分数。
        "qualityScore": 88.3615493774414
    }
}

ResultObject.SubCode错误码说明

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.20</version>
</dependency>

调用示例：

DefaultProfile profile = DefaultProfile.getProfile(
    "cn-hangzhou",    // 固定为cn-hangzhou。
    "AccessKeyID",      // 您的AccessKey ID。
    "AccessKeySecret");  // 您的AccessKey Secret。
IAcsClient client = new DefaultAcsClient(profile);
LivenessFaceVerifyRequest request = new LivenessFaceVerifyRequest();
// 固定值。
request.setProductCode("LR_FR_MIN");
// 固定值。
request.setModel("FRONT_CAMERA_LIVENESS");

request.setOuterOrderNo("商户请求的唯一标识");
request.setSceneId(10xxxxxxL);

// 请在以下方式中选择一种，传入人脸图片。
// 方式一：人脸图片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")

LivenessFaceVerifyResponse 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().getSubCode());
System.out.println(response.getResultObject().getMaterialInfo());