CompareFaceVerify_实人认证服务_API调试-阿里云OpenAPI开发者门户

接口名：CompareFaceVerify。
服务地址：cloudauth.aliyuncs.com。
请求方法：HTTPS POST 和 GET。
接口说明：通过服务端接入实现实人认证的接口。

传入照片格式要求

当您在进行人脸比对的时候，请传入满足以下所有条件的 2 张人脸照片。

近期照片/底库近期照片，人脸完整清晰无遮挡，表情自然，正对摄像头。
照片清晰、曝光正常，脸部无过黑、过亮、光晕等情况、角度无太大偏差。
分辨率不超过 1920*1080，至少 640*480，推荐短边缩放到 720 像素，压缩率大于 0.9。
照片大小：<1MB。
支持 90、180 和 270 度照片，多人脸的情况会选取最大脸。

请求参数

字段名称	字段详情
SceneIdinteger<int64>	认证场景 ID。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:1000000006
OuterOrderNostring	商户请求的唯一标识。展开详情示例值:e0c34a77f5ac40a5aa5e6ed20c353888
ProductCodestring	固定值：PV_FC。示例值:PV_FC
SourceFaceContrastPicturestring	照片 Base64 编码。展开详情示例值:/9j/4AAQSkZJRgABAQAASxxxxxxx字符长度 <= 1048676
SourceFaceContrastPictureUrlstring	OSS 照片地址，目前只支持已授权 OSS 照片地址。展开详情示例值:https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg
SourceCertifyIdstring	之前实人认证通过的 CertifyId，认证时的照片作为人脸比对照片。展开详情示例值:0bfa7c493f850e5178b9f8613634c9xx
SourceOssBucketNamestring	已授权 OSS 空间的 Bucket 名。展开详情示例值:cn-shanghai-aliyun-cloudauth-xxxxx
SourceOssObjectNamestring	已授权 OSS 空间的文件名。展开详情示例值:verify/xxxxx/xxxxxx.jpeg
TargetFaceContrastPicturestring	底库照片 Base64 编码。展开详情示例值:/9j/4AAQSkZJRgABAQAASxxxxxxx字符长度 <= 1048676
TargetFaceContrastPictureUrlstring	底库 OSS 照片地址，目前只支持已授权 OSS 照片地址。展开详情示例值:https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg
TargetCertifyIdstring	之前实人认证通过的 CertifyId，认证时的照片作为人脸比对照片。展开详情示例值:0bfa7c493f850e5178b9f8613634c9xx
TargetOssBucketNamestring	已授权 OSS 空间的 Bucket 名。展开详情示例值:cn-shanghai-aliyun-cloudauth-xxxxx
TargetOssObjectNamestring	已授权 OSS 空间的文件名。展开详情示例值:verify/xxxxx/xxxxxx.jpeg
Cropstring

请求说明

说明以 Source 开头的参数代表您要上传的近期人脸照片参数，以 Target 开头的参数代表您要上传的底库近期人脸照片参数。传入照片格式要求请参见传入照片格式要求。如果您选择 OSS 方式传入人脸照片，您必须同时传入 OssBucketName 和 OssObjectName 字段。OSS 入参格式仅支持开通实人认证时授权的 OSS 生成的 URL、Bucket 和文件名。关于如何查询授权的 OSS，请参见开通 OSS 空间并授权。如果您选择 FaceContrastPicture（照片 Base64 编码）方式传入人脸照片，请注意检查照片大小，不要传入过大的照片；您可以通过 OSS 方式上传较大的人脸照片。

返回参数

字段名称	字段详情
Codestring	返回码：200 为成功，其他为失败。示例值:200
Messagestring	错误信息。示例值:success
RequestIdstring	请求 ID。示例值:130A2C10-B9EE-4D84-88E3-5384FF039795
ResultObjectobject	人脸比对结果信息。

返回说明

返回值示例：

{
    "Code": "200",
    "Message": "success",
    "RequestId": "23699272-B263-4B6C-BC04-0EBA1AB6F6D5",
    "ResultObject": {
        "Passed": "T",
        "VerifyScore": 99.60875
    }
}

变更历史

	变更时间	变更内容概要	操作
	2024-05-30	变更请求参数SourceFaceContrastPicture 变更请求参数TargetFaceContrastPicture
	2021-09-08	新增请求参数Crop