faceDetect:人脸检测
功能详情
识别图片中是否有人脸,有几张人脸,人脸的具体位置并给出人脸在图片中的坐标,适用于客流统计、人形检测、人脸抠图等多种场景。
请求地址
https://openapi.lechange.cn/openapi/faceDetect
传入参数说明
参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 |
---|---|---|---|---|---|
token | String | 是 | 开发者在账号对接模块获取的Token | ||
type | String | 是 | 0:表示图片URL;1:表示Base64编码的二进制图片数据 | 图片数据上传类型 | |
content | String | 是 | 当type=0时,为图片URL;当type=1时,为Base64编码的二进制图片数据 | 图片数据 | |
operation | String[] | 否 | age:年龄;sex:性别;glass:是否戴眼镜 | 待检测项 |
样例输入
{
"system":{
"ver":"1.0",
"appId":"lcd08b4b07ce224508",
"sign":"b7e5bbcc6cc07941725d9ad318883d8e",
"time":1599013514,
"nonce":"fbf19fc6-17a1-4f73-a967-75eadbc805a2"
},
"id":"98a7a257-c4e4-4db3-a2d3-d97a3836b87c",
"params":{
"token": "At_12345678901234567890123456789012",
"type": "0",
"content": "https://www.google.com/face.jpg",
"operation": ["age","sex","glass"]
}
}
返回data字段说明
字段名 | 字段类型 | 字段说明 | ||
---|---|---|---|---|
faces | faceToken | String | 人脸图片唯一标示 | |
location | x | Integer | 人脸框左上角的横坐标,单位px,坐标原点为原图左上角 | |
y | Integer | 人脸框左上角的纵坐标,单位px,坐标原点为原图左上角 | ||
width | Integer | 人脸框的宽度,单位px | ||
height | Integer | 人脸框的宽度,单位px | ||
age | range | Integer | 浮动范围,-1表示未知 | |
value | Integer | 年龄 | ||
sex | rate | Double | 准确率,取值范围为[0,100],-1表示未知 | |
value | String | 性别,male-男,female-女 | ||
glass | rate | Double | 准确率,取值范围为[0,100],-1表示未知 | |
value | String | 是否戴眼镜,true-是,false-否 |
样例输出
{
"result":{
"msg":"操作成功。",
"code":"0",
"data": {
"faces": [
{
"faceToken": "a3esa78x3cc6cc05d9ad318883d8e",
"location": {
"x": 30,
"y": 30,
"width": 30,
"height": 30
},
"age": {
"range": 2,
"value": 30
},
"sex": {
"rate": 90.99,
"value": "male"
},
"glass": {
"rate": 90.99,
"value": "true"
}
}
]
}
},
"id":"98a7a257-c4e4-4db3-a2d3-d97a3836b87c"
}