ID Verification：FACE_IDU_MIN

名称

类型

是否必选

描述

示例值

ProductCode

String

是

产品Code：FACE_IDU_MIN。

FACE_IDU_MIN

MerchantBizId

String

是

自定义的业务唯一标识，用于后续定位和排查问题。支持长度为 32 位的字母和数字的组合，请确保唯一。

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

是

自定义的用户 ID，或者其他可以识别特定用户的标识，例如：手机号码、邮箱地址等。强烈建议对该字段的值进行预先脱敏，例如对值进行哈希处理。

123456789

VerifyModel

String

是

验证类型：

• 0：检索模式

  • 功能：传入人脸库和用户人脸图片（SourceFacePicture/SourceFacePictureUrl/FacePictureFile），系统自动检索人脸库中是否已经存在该人脸图片，用户人脸图片支持开启静默活体检测。

  • 建议场景：真人注册账号且不允许重复注册场景。

• 1：验证模式（默认）

  • 功能：传入指定人脸图片（SourceFacePicture/SourceFacePictureUrl/FacePictureFile）与留底人脸图片（TargetFacePicture/TargetFacePictureUrl/TargetFacePictureFile），系统自动验证两者的人脸信息是否一致，且指定人脸图片支持开启静默活体检测。

  • 建议场景：修改登录、账号等信息时需验证是否为本人操作的场景。

• 2：综合模式

  • 功能：同时传入人脸库、指定人脸图片（SourceFacePicture/SourceFacePictureUrl/FacePictureFile）与留底人脸图片（TargetFacePicture/TargetFacePictureUrl/TargetFacePictureFile），系统自动检索人脸库中是否存在指定人脸图片，是否与留底人脸一致，且指定人脸图片支持开启静默活体检测。

  • 建议场景：需要验证是新增用户且是本人操作场景。

0

FaceGroupCodes

String

否

通过ID Verification产品控制台创建人脸库时获取对应编码，最大支持同时查询10个人脸库。当传入多个人脸库编码时，以逗号区分。

1232344,23444

SourceFacePicture

String

否

人像图片 Base64 编码。

base64

SourceFacePictureUrl

String

否

人像图片地址，公网可访问的 HTTP、HTTPS 链接。

https://***face1.jpeg

SourceFacePictureFile

String

否

人像图片文件流

人像图片文件流1

TargetFacePicture

String

否

底图人像图片 Base64 编码。

base64

TargetFacePictureUrl

String

否

底图人像图片地址，公网可访问的 HTTP、HTTPS 链接。

https://***face2.jpeg

TargetFacePictureFile

String

否

对比底图，底图人像图片文件流。

人像图片文件流2

AutoRegistration

String

否

检索不存在的人脸时，是否自动注册人脸到指定人脸库下。

• 0：自动注册

• 1：不注册（默认）

0

FaceRegisterGroupCode

String

否

注册人脸库。

0e0c34a77f

ReturnFaces

String

否

指匹配阈值之上存在多个人脸时，可通过该参数自定义返回数量。

• 默认返回 1

• 最大支持 5

1

FaceQualityCheck

String

否

N

FaceAttributeCheck

String

否

N

名称

类型

描述

示例值

HTTP Status Code

Integer

HTTP状态码。

200

HTTP Body

RequestId

String

请求ID。

130A2C10-B9EE-4D84-88E3-5384FF0****

Code

String

返回Code，具体信息请参见服务端返回HTTP状态码说明。

Success

Message

String

返回Code的详细描述。

success

Result.FacePassed

String

认证最终结果，取值：

• Y：通过

• N：不通过

Y

Result.FaceComparisonScore

Double

当验证模式为 1 或 2 时返回 1:1 验证的比对分。其取值范围为：0～100。

98

Result.DuplicateFace

String

当检索存在重复人脸时返回人脸库中对应的人脸ID、用户ID和比对分。

[
  {
    "faceGroupCode": "sg7****uzt",
    "faceId": "f5a921*******9e792ec84c8f0ca592a"
    "merchantUserId":"face0005",
    "score":93.26
  }
]

Result.FaceRegistrationResult

Integer

人脸注册结果

• 0：失败

• 1：成功

1

Result.FaceRegistrationId

String

当设置自动注册，且人脸注册成功时返回对应的FACEID。

9e792******a592a

Result.FaceAttack

String

采集人脸是否涉及活体攻击，攻击为 Y，否则为 N。 当开启静默活体检测时返回。

N

Result.FaceAttributeInfo

String

{
        gender: 1
        glasses: 0
        hat: 1
        mask: 1
        tattoo: 0
        smoking: 0
        others: 1
        env：office
        expression：1
        age：16
}

Result.SubCode

String

认证结果描述。请参考SubCode。

200

Result.TransactionId

String

认证请求的唯一标识。

4ab0b***cbde97

Result.ExtFaceInfo

Object

活体检测相关结果信息。关于JSON格式，请参见右侧示例。更多信息，请参见ExtFaceInfo说明。

{
  "FaceQualityScore": 66.3,
  "OcclusionScore": 100,
  "SharpnessScore": 70.3,
  "KaOcclusionScore": 80,
  "IlluminationScore": 90.79
}

名称

类型

描述

示例值

FaceQualityScore

Double

活体人脸质量分数。取值范围0～100，数值越大质量越高。

88.62

OcclusionScore

Double

质量判断子维度，遮挡的算法分数，取值范围0～100，数值越大质量越高。

99.99

KaOcclusionScore

Double

质量判断子维度，关键区域遮挡的算法分数，取值范围0～100，数值越大质量越高。

100

IlluminationScore

Double

质量判断子维度，光照的算法分数，取值范围0～100，数值越大质量越高。

97.43

SharpnessScore

Double

质量判断子维度，图片清晰度分数，取值范围0～100，数值越大质量越高。

60.78