ID Verification：FACE_IDU_MIN

名称

类型

是否必选

描述

示例值

ProductCode

String

是

产品Code：FACE_IDU_MIN。

FACE_IDU_MIN

SceneCode

String

否

自定义的认证场景 ID。

1234567890

MerchantBizId

String

是

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

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

是

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

123456789

VerifyModel

String

是

验证类型：

• 0：检索模式

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

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

• 1：验证模式（默认）

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

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

• 2：综合模式

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

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

0

Liveness

String

否

是否开启静默活体检测。

• 0：不开启

• 1：开启

0

FaceGroupCodes

String

否

通过控制台创建的人脸库编码，最大支持同时查询 10 个人脸库。当传入多个人脸库编码时，以逗号区分。

1232344,23444

SourceFacePicture

String

否

人像图片 Base64 编码。

base64

SourceFacePictureUrl

String

否

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

https://***face1.jpeg

TargetFacePicture

String

否

人像图片 Base64 编码。

base64

TargetFacePictureUrl

String

否

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

https://***face2.jpeg

AutoRegistration

String

否

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

• 0：自动注册

• 1：不注册（默认）

0

FaceRegisterGroupCode

String

否

注册人脸库。

0e0c34a77f

SaveFacePicture

String

否

预留字段，暂未生效。

FaceVerifyThreshold

String

否

预留字段，暂未生效。

ReturnFaces

String

否

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

• 默认返回 1

• 最大支持 5

1

名称

类型

描述

示例值

HTTP Status Code

Integer

HTTP状态码。

200

HTTP Body

RequestId

String

请求ID。

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

Code

String

返回Code。

Success

Message

String

返回Code的详细描述。

success

Result.FacePassed

String

认证最终结果，取值：

• Y：通过

• N：不通过

Y

Result.FaceComparisonScore

String

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

98

Result.DuplicateFace

String

存在重复人脸时，返回检索到的人脸库人脸 ID 和 UserID。

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

Result.FaceRegistrationResult

String

人脸注册结果

• 0：失败

• 1：成功

1

Result.FaceRegistrationId

String

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

9e792******a592a

Result.FaceAttack

String

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

N

Result.FaceAttackScore

String

人脸静默活体检测攻击的概率。取值范围：0～100。当开启静默活体检测时返回。

99

Result.FaceAge

String

人脸预测的参考年龄，可能存在预测失败无法返回的情况。

30

Result.FaceGender

String

人脸图片预测的性别，可能存在预测失败无法返回的情况。

• M：男

• F：女

M

Result.SubCode

String

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

200

Result.TransactionId

String

认证请求的唯一标识。

4ab0b***cbde97