FACE_CROSS_COMPARE - ID Verification

本文介绍通过纯服务端（API）接入FACE_CROSS_COMPARE 的产品方案，实现如下功能：传入三张用户人脸图片，通过三张图片的交叉比对验证，确认是否属于同一个人。

接口说明

说明

在调试和集成前，请确保您已完整阅读使用OpenAPI调试和集成服务端API文档，充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

您可以在OpenAPI Explorer中直接运行本接口进行调试，并生成本接口的SDK代码示例。

图片格式：JPG、JPEG、PNG。
图片大小：推荐50~100 KB，最大不超过1 MB。
图片分辨率：不超过1920*1080（高*宽），至少为640*480（高*宽），推荐短边缩放到720像素，压缩率大于0.9。照片高大于宽，如果传入的照片宽大于高，可能会影响检测效果。
说明
图片转base64格式后，通常会导致数据体积增加。如您需要使用base64格式传参，请保证原始图片的体积不超过0.6MB，以满足1MB的最大数据传输限制。
图片质量建议：
- 人脸面部需要完整清晰无遮挡，正对摄像头，推荐通过前置摄像头采集的人脸图片。
- 人脸大小占比图片中面积需要>60%，若人脸较小会影响检测的准确性。
- 若图片中存在多个人脸，算法默认截取较大的人脸，建议避免传入多人脸图片。

说明

上传人像图片时，需通过以下两种方式之一提供图像数据：

二者仅需选择其一。若采用 Base64 编码方式，请避免上传过大图像。

名称	类型	是否必选	描述	示例值
ProductCode	String	是	要接入的产品方案。取值： FACE_CROSS_COMPARE	FACE_CROSS_COMPARE
SceneCode	String	否	自定义业务场景 ID。	1234567890
MerchantBizId	String	是	自定义的业务唯一标识，用于后续定位排查问题使用。支持长度为32位的字母和数字的组合，请确保唯一。	e0c34a77f5ac40a5aa5e6ed20c35****
CompareModel	String	否	比对模式 0 - 链式比对（默认）：A比对B，且B比对C 1 - 循环比对：A比对B，且B比对C，且C比对A	0
SourceAFacePicture	String	否	人像图片 Base64 编码。	base64
SourceAFacePictureUrl	String	否	人像图片地址，公网可访问的 HTTP、HTTPS 链接。	https://www.xxx.com/1.jpg
SourceBFacePicture	String	否	人像图片 Base64 编码。	base64
SourceBFacePictureUrl	String	否	人像图片地址，公网可访问的 HTTP、HTTPS 链接。	https://www.xxx.com/1.jpg
SourceCFacePicture	String	否	人像图片 Base64 编码。	base64
SourceCFacePictureUrl	String	否	人像图片地址，公网可访问的 HTTP、HTTPS 链接。	https://www.xxx.com/1.jpg
FaceVerifyThreshold	String	否	人脸匹配阈值。此参数为系统预留参数，暂不支持自定义。	0.4

HTTP Status Code	Code	描述
200	Success	请求成功。
400	MissingParameter	参数不能为空。
400	InvalidParameter	非法参数。
401	NoFaceDetected	自定义比对源的图片人脸特征提取失败，建议更换图片上传。
401	UnqualifiedPhoto	传入的图片不可读，或图片分辨率不符合要求，建议更换图片。需确保照片清晰、曝光正常，完整无遮挡，角度无太大偏差。
401	ToolargeImage	图片尺寸过大，建议压缩图片或更换图片上传方式。
401	DataDuplication	同时传入SourceFacePicture和SourceFacePictureUrl。
401	DownloadTimeout	URL图片下载超时。
403	Forbidden.RAMUserAccessDenied	需要给RAM用户授予AliyunAntCloudAuthFullAccess的操作权限。更多信息，请参见授权RAM用户访问服务。
403	Forbidden.AccountAccessDenied	确保您开通了ID verification，并且保证账户未欠费。
403	Throttling.Api	API限流拦截。
500	InternalError	系统内部错误，请反馈工程师排查。