跳到主要内容

人脸比对 & 活体检测

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 参数

3.3 任务返回标签说明 🎯🎯

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

3.4 任务结果示例

{
"5c131f28153a11339add4a91": {
"fileList": {
"name": "https://www.tuputech.com/test.jpg",
"label": 0,
"similarity": 0.93,
"review": false,
"tag": "tag_test"
}
}
}