人脸比对 & 活体检测
1. 任务简介
1.1 任务 ID
5c131f28153a11339add4a91
提示
任务 ID 全局固定且不变,建议客户将其定义为代码常量。
1.2 能力介绍
该识别服务由活体检测与人脸比对组成。通过对视频组图与图片进行检测分析,判断视频图像质量以及视频中人像是否为活体,并将视频人像与图片人像进行对比,判断是否为同一人。
信息
- 每次请求只处理一组头像与视频认证。
image
字段按顺序区分图片类别,第一张图片是头像,其余是鉴别活体的视频图片组(视频截图不包含头像最多 10 张,最少 8 张),单张大小超出 700K 或头像无效或视频图片数量过少都会返回 异常。- 只要视频组图中有一张无人,均会判为 视频无人。
- 图片及视频的清晰度、光照以及后期滤镜效果(如美颜)会对识别准确度产生较大影响。
2. 请求参数
图片接口公共请求参数详见:图片同步识别接口,图片异步识别接口
视频接口公共请求参数详见:视频同步识别接口,视频文件异步识别接口,视频流异步识别接口
3. 返回结果
3.1 公共返回结果
图片接口公共返回结果详见:图片同步识别接口,图片异步识别接口
视频接口公共返回结果详见:视频同步识别接口,视频文件异步识别接口,视频流异步识别接口
3.2 任务返回结果 🎯
任务结果
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
fileList | Object | 是 | 活体检测结果,详见 FileResult 参数说明 |
FileResult 参数说明
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
name | String | 是 | 如果上传的 image 参数是 url, 则该值是图片 url;如果是以图片文件上传,则该值为文件名 |
similarity | Number | 是 | 与基准图的相似度,范围 [0.0, 1.0] 之间,分值越高,越相似。默认 0.8 以上,人脸比对通过; 0.8 - 0.81 范围,需要复审。 |
label | Number | 是 | 识别结果,详见 任务返回标签说明 |
review | Boolean | 是 | 是否需要复审, true :需要, false :不需要 |
tag | String | 否 | 调用时为该图片设置的 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"
}
}
}