跳到主要内容

头像人脸质量识别

1. 任务简介​

1.1 任务 ID​

638f1715f44e2ff92d4b3321

提示

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

1.2 能力介绍​

针对头像图片审核场景中的人脸质量进行判别。当检测到人脸状态属于侧脸、人脸倒置、脸部不全、五官有遮挡、俯仰角度过大，以及脸部在头像图片中面积占比过大或过小的情况，则会判断为质量不合格。

2. 请求参数​

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

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

3. 返回结果​

3.1 公共返回结果​

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

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

3.2 任务返回结果​

任务结果​

参数名称类型是否必需说明
reviewCountNumber是需要复审的图片数量
fileListArray是每张图片的识别结果，详见 FileResult 参数说明
statisticArray否各个分类的图片数量，数组索引是 label 值，元素值是数量；如 [1, 0] 表示 label = 0的数量为 1，label = 1 的数量为 0。 任务返回 statistic, 就不返回 topNStatistic
topNStatisticArray否类别数多时，本次调用的全部图片，各个类别的图片数据分布。任务返回 topNStatistic, 就不返回 statistic

FileResult 参数说明​

参数名称类型是否必需说明
rateFloat是分类得分，范围 [0.0, 1.0], 值越高机器对判定结果越有把握
labelNumber是任务一级标签识别分类（ -1 表示识别失败），详见 一级标签 label 值说明
nameString是如果上传的 image 参数是 url，则该值是图片 url；如果是以图片文件上传，则该值为文件名
reviewBoolean是是否需要复审
tagString否调用时为该图片设置的 tag 参数

3.3 任务返回标签说明​

一级标签label值说明​

label 值说明
0合格
1不合格

3.4 响应示例​

任务返回结果示例

{
    "638f1715f44e2ff92d4b3321": {
        "reviewCount": 0,
        "fileList": [
            {
                "label": 0,
                "rate": 1,
                "review": false,
                "name": "http://tuputech.com/test.jpg",
            }
        ],
        "statistic": [
            1,
            0
        ]
    },
    "nonce": "0.010413094889372587",
    "timestamp": 1435385737,
    "code": 0,
    "message": "success"
}