调用CompareFaceVerify接口通过服务端接入金融级人脸比对_实人认证(ID Verification)-阿里云帮助中心

传入照片格式要求

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

照片清晰、曝光正常，人脸完整无遮挡、表情自然，脸部无过黑、过亮、光晕等情况，角度无太大偏差。
分辨率不超过1920*1080（高*宽），至少640*480，推荐短边缩放到720像素，压缩率大于0.9。照片高大于宽，如果传入的照片宽大于高，可能会影响检测效果。
照片大小：小于1 MB。

说明

支持传入90、180和270旋转角度的照片，多人脸的情况下会选取最大人脸。

示例如下：

发起认证请求

接口名：CompareFaceVerify。

全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）

请求方法：POST和GET。

传输协议：HTTPS。

接口说明：通过服务端接入实现实人认证的接口。

QPS限量：API独享QPS限量，详情请参见服务端接口QPS限量说明。

请求参数

名称	类型	是否必选	描述	示例值
SceneId	Long	是	认证场景ID。该ID在控制台创建认证场景后自动生成。关于如何创建认证场景，请参见添加认证场景。	1000000006
OuterOrderNo	String	是	客户服务端自定义的业务唯一标识，用于后续定位排查问题使用。值最长为32位长度的字母数字组合，请确保唯一。	e0c34a77f5ac40a5aa5e6ed20c353888
ProductCode	String	是	固定值：PV_FC。	PV_FC
SourceFaceContrastPicture	String	是金融级人脸对比方案提供四种传入人脸照片的方式，请您选择其中一种。 SourceFaceContrastPicture SourceFaceContrastPictureUrl SourceCertifyId OSS：SourceOssBucketName、SourceOssObjectName	照片Base64编码。	/9j/4AAQSkZJRgABAQAASxxxxxxx
SourceFaceContrastPictureUrl	String		传入公网可访问的照片URL，用于与传入的底库照片做对比。	https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg
SourceCertifyId	String		如果您之前已经通过实人认证，可使用实人认证唯一标识CertifyId，认证时的照片作为人脸比对照片。	0bfa7c493f850e5178b9f8613634c9xx
SourceOssBucketName	String		已授权OSS空间的Bucket名。	cn-shanghai-aliyun-cloudauth-xxxxx
SourceOssObjectName	String		已授权OSS空间的文件名。	verify/xxxxx/xxxxxx.jpeg
TargetFaceContrastPicture	String	是金融级人脸对比方案提供四种传入人脸照片的方式，请您选择其中一种。 TargetFaceContrastPicture TargetFaceContrastPictureUrl TargetCertifyId OSS：TargetOssBucketName、TargetOssObjectName	底库照片Base64编码。	/9j/4AAQSkZJRgABAQAASxxxxxxx
TargetFaceContrastPictureUrl	String		传入公网可访问的底库照片URL。	https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg
TargetCertifyId	String		如果您之前已通过实人认证，可选择该接口，将实人认证标识CertifyId作为人脸比对照片。	0bfa7c493f850e5178b9f8613634c9xx
TargetOssBucketName	String		已授权OSS空间的Bucket名。	cn-shanghai-aliyun-cloudauth-xxxxx
TargetOssObjectName	String		已授权OSS空间的文件名。	verify/xxxxx/xxxxxx.jpeg
Crop	String	否	是否允许裁剪人脸图片，默认不允许。 T：表示允许剪裁。 F：表示不允许剪裁。说明若您请求的图片并非来自标准活体检测SDK采集，建议您允许裁剪人脸图片。开启该功能后，将会对请求的图片先进行人脸裁剪与矫正，完成后会发起请求服务。	T

说明

以Source开头的参数代表您要上传的近期人脸照片参数，以Target开头的参数代表您要上传的底库近期人脸照片参数。传入照片的格式要求请参见传入照片格式要求。

如果您选择OSS方式传入人脸照片，您必须同时传入OssBucketName和OssObjectName字段。

OSS入参格式仅支持开通实人认证时授权的OSS生成的URL、Bucket和文件名。关于如何查询授权的OSS，请参见授权金融级实人认证访问OSS存储空间。

如果您选择FaceContrastPicture（照片Base64编码）方式传入人脸照片，请注意检查照片大小，不要传入过大的照片；您可以通过OSS方式上传较大的人脸照片。

返回数据

名称	类型	描述	示例值
RequestId	String	请求ID。	130A2C10-B9EE-4D84-88E3-5384FF039795
Message	String	错误信息。	success
Code	String	返回码：200表示成功，其他返回码表示失败。	200
ResultObject.Passed	String	认证结果。取值： T：认证通过。 F：认证失败。	T
ResultObject.CertifyId	String	08573be80f944d95ac812e019e3655a8	实人认证请求的唯一标识。
ResultObject.VerifyScore	Float	人脸比对分。	99.60875

返回示例

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

返回Code和Message

Code	Message	描述
200	success	成功。
400	参数不能为空	参数不能为空。
401	参数非法	非法参数。传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母等特殊字符。
402	应用配置不存在	应用配置不存在。
404	认证场景配置不存在	认证场景配置不存在，请先在控制台上创建认证场景。
410	未开通服务	未开通OSS产品或未完成OSS读写授权，请登录控制台完成授权。
411	RAM 无权限	需要给子账号授予AliyunAntCloudAuthFullAccess的操作权限。
412	欠费中	金融级实人认证或OSS存在欠费，请充值后操作。
419	传入图片不可用	图片无法下载、图片内容为空、图片分辨率不符合要求或提取不到人脸特征，建议更换图片。
420	数据重复	图片传入方式超过2种。
421	传入图片过大	图片超过了1 MB，建议压缩图片或更换图片上传方式。
422	下载图片超时	图片下载超过了3秒，请排查网络后重新操作。
423	状态错误	需确保传入的CertifyId认证状态为T或F，或更换其他方式传入照片。
500	系统错误	系统内部错误，请联系工程师排查。