跳到主要内容

人脸比对 & 活体检测

1. 任务简介​

1.1 任务 ID​

5c131f28153a11339add4a91

提示

任务 ID 全局固定且不变，建议客户将其定义为代码常量。

1.2 能力介绍​

该识别服务由活体检测与人脸比对组成。通过对视频组图与图片进行检测分析，判断视频图像质量以及视频中人像是否为活体，并将视频人像与图片人像进行对比，判断是否为同一人。

调用须知
  • 每次请求只处理一组头像与视频认证。
    • image 字段按顺序区分图片类别，第一张图片是头像，其余是鉴别活体的视频图片组（视频截图不包含头像最多 10 张，最少 8 张），单张大小超出 700K 或头像无效或视频图片数量过少都会返回异常。
    • 只要视频组图中有一张无人，均会判为视频无人。
    • 图片及视频的清晰度、光照以及后期滤镜效果（如美颜）会对识别准确度产生较大影响。

2. 请求参数​

图片接口公共请求参数详见：图片同步识别接口，图片异步识别接口

视频接口公共请求参数详见：视频同步识别接口，视频文件异步识别接口，视频流异步识别接口

3. 返回结果​

3.1 公共返回结果​

图片接口公共返回结果详见：图片同步识别接口，图片异步识别接口

视频接口公共返回结果详见：视频同步识别接口，视频文件异步识别接口，视频流异步识别接口

3.2 任务返回结果​

任务结果​

参数名称类型是否必需说明
fileListObject是活体检测结果，详见 FileResult 参数说明

FileResult 参数说明​

参数名称类型是否必需说明
nameString是如果上传的 image 参数是 url ，则该值是图片 url；如果是以图片文件上传，则该值为文件名
similarityNumber是与基准图的相似度，范围 0.0 - 1.0 之间，分值越高，越相似。默认 0.8 以上，人脸比对通过； 0.8 - 0.81 范围，需要复审。
labelNumber是识别结果，详见任务返回标签说明
reviewBoolean是是否需要复审， true ：需要， false ：不需要
tagString否调用时为该图片设置的 tag 参数

任务返回标签说明​

label 值说明
0人脸认证通过
1人脸认证不通过
2图片多人认证
3视频多人认证
4图片无人
5视频无人
6视频昏暗
7视频模糊
8非活体
10视频人脸被遮挡
-1处理失败

3.3 响应示例​

{
    "5c131f28153a11339add4a91": {
        "fileList": {
            "name": "https://www.tuputech.com/test.jpg",
            "label": 0,
            "similarity": 0.9379766464233398, // 与基准图的相似度，范围0.0-1.0之间，分值越高，越相似。默认0.8以上，人脸比对通过；0.8-0.81范围，需要复审。
            "review": false,
            "tag": "tag_test"
        }
    },
    "code": 0,
    "message": "success",
    "nonce": "0.24628431661924322",
    "timestamp": 1523765333265
}