faceMatch

解释：人脸对比，支持两张人脸图片的相似度对比，图片类型可以为：生活照，证件照，身份证芯片照或者带网纹照。

最低支持版本 3.20.11 。

方法参数：ObjectObject 参数说明：

参数名参数类型是否必填说明
dataArray是图片信息
successFunction否接口调用成功后的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

data 参数

参数名参数类型是否必填说明
imagestring是图片信息(总数据大小应小于 10M)，图片上传方式根据 image_type 来判断。
image_typestring是图片类型。· BASE64:图片的 base64 值，base64 编码后的图片数据，编码后的图片大小不超过 2M；· URL: 图片的 URL 地址( 可能由于网络等原因导致下载图片时间过长)；· FACE_TOKEN: 人脸图片的唯一标识，调用人脸检测接口时，会为每个人脸图片赋予一个唯一的 FACE_TOKEN，同一张图片多次检测得到的 FACE_TOKEN 是同一个。
quality_controlstring否图片质量控制。· NONE: 不进行控制；· LOW:较低的质量要求；· NORMAL: 一般的质量要求；· HIGH: 较高的质量要求；默认 NONE，若图片质量不满足要求，则返回结果中会提示质量检测失败。
liveness_controlstring否活体检测控制。· NONE: 不进行控制；· LOW:较低的活体要求(高通过率 低攻击拒绝率)；· NORMAL: 一般的活体要求(平衡的攻击拒绝率, 通过率)；· HIGH: 较高的活体要求(高攻击拒绝率 低通过率)。默认 NONE，若活体检测结果不满足要求，则返回结果中会提示活体检测失败。
face_typestring否人脸的类型。· LIVE 表示生活照：通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等；· IDCARD表示身份证芯片照：二代身份证内置芯片中的人像照片；· WATERMARK 表示带水印证件照：一般为带水印的小图，如公安网小图；· CERT 表示证件照片：如拍摄的身份证、工卡、护照、学生证等证件图片；默认 LIVE。

返回值说明

参数名参数类型说明
scorenumber人脸相似度得分，推荐阈值80分。
face_listArray人脸信息列表

face_list参数说明

参数名参数类型说明
face_tokenstring人脸的唯一标志

示例代码

  1. swan.ai.faceMatch({
      data: [
        {
            "image": "https://www.downloadImage.com/xxxx.jpg",
            "image_type": "URL",
            "face_type": "LIVE",
            "quality_control": "LOW",
            "liveness_control": "HIGH"
        },
        {
            "image": "https://www.downloadImage.com/xxxx.jpg",
            "image_type": "URL",
            "face_type": "IDCARD",
            "quality_control": "LOW",
            "liveness_control": "HIGH"
        }
      ],
      success(res) {
        console.log('res');
      }
    });

返回示例

  1. {
        "score": 44.3,
        "face_list": [  //返回的顺序与传入的顺序保持一致
            {
                "face_token": "fid1"
            },
            {
                "face_token": "fid2"
            }
        ]
    }