传入照片格式要求

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

  • 照片清晰、曝光正常，人脸完整无遮挡、表情自然，脸部无过黑、过亮、光晕等情况，角度无太大偏差。
  • 分辨率不超过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。

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

请求参数
名称类型是否必选描述示例值
SceneIdLong是认证场景ID。该ID在控制台创建认证场景后自动生成。关于如何创建认证场景，请参见添加认证场景。1000000006
OuterOrderNoString是客户服务端自定义的业务唯一标识，用于后续定位排查问题使用。值最长为32位长度的字母数字组合，请确保唯一。e0c34a77f5ac40a5aa5e6ed20c353888
ProductCodeString是固定值：PV_FC。PV_FC
SourceFaceContrastPictureString是
金融级人脸对比方案提供四种传入人脸照片的方式，请您选择其中一种。
  • SourceFaceContrastPicture
  • SourceFaceContrastPictureUrl
  • SourceCertifyId
  • OSS：SourceOssBucketName、SourceOssObjectName
照片Base64编码。 /9j/4AAQSkZJRgABAQAASxxxxxxx
SourceFaceContrastPictureUrlStringOSS照片地址，目前只支持已授权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 是
金融级人脸对比方案提供四种传入人脸照片的方式，请您选择其中一种。
  • TargetFaceContrastPicture
  • TargetFaceContrastPictureUrl
  • TargetCertifyId
  • OSS：TargetOssBucketName、TargetOssObjectName
底库照片Base64编码。/9j/4AAQSkZJRgABAQAASxxxxxxx
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否是否允许裁剪人脸图片，默认不允许。
  • T：表示允许剪裁。
  • F：表示不允许剪裁。
说明 若您请求的图片并非来自标准活体检测SDK采集，建议您允许裁剪人脸图片。

开启该功能后，将会对请求的图片先进行人脸裁剪与矫正，完成后会发起请求服务。

T
说明

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

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

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

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

返回数据
名称类型描述示例值
RequestIdString请求ID。 130A2C10-B9EE-4D84-88E3-5384FF039795
MessageString错误信息。success
CodeString返回码：200表示成功，其他返回码表示失败。200
ResultObject.PassedString认证结果。取值：
  • T：认证通过。
  • F：认证失败。
T
ResultObject.CertifyIdString08573be80f944d95ac812e019e3655a8实人认证请求的唯一标识。
ResultObject.VerifyScoreFloat人脸比对分。99.60875
返回示例
{
    "Code": "200",
    "Message": "success",
    "RequestId": "23699272-B263-4B6C-BC04-0EBA1AB6F6D5",
    "ResultObject": {
        "Passed": "T",
        "VerifyScore": 99.60875
    }
}
返回Code和Message
CodeMessage描述
200success成功。
400参数不能为空参数不能为空。
401参数非法非法参数。传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母等特殊字符。
402应用配置不存在应用配置不存在。
404认证场景配置不存在认证场景配置不存在，请先在控制台上创建认证场景。
410未开通服务未开通OSS产品或未完成OSS读写授权，请登录控制台完成授权。
411RAM 无权限需要给子账号授予AliyunAntCloudAuthFullAccess的操作权限。
412欠费中金融级实人认证或OSS存在欠费，请充值后操作。
419传入图片不可用图片无法下载、图片内容为空、图片分辨率不符合要求或提取不到人脸特征，建议更换图片。
420数据重复图片传入方式超过2种。
421传入图片过大图片超过了1 MB，建议压缩图片或更换图片上传方式。
422下载图片超时图片下载超过了3秒，请排查网络后重新操作。
423状态错误传入的CertifyId认证状态需要为T，您也可以更换其他方式传入图片。
500系统错误系统内部错误，请联系工程师排查。