Appearance
人脸关键点检测 #
功能简介 #
- 能力说明:检测图像中的所有人脸并返回每个人脸的核心关键点,包括眼睛、眉毛、嘴巴、鼻子以及人脸轮廓。适应大角度侧脸,部分遮挡,表情变化,明暗变化等各种实际环境
- 适用范围:支持一张图,并且图片中只有多张人脸;最小支持 50x50 像素,最大无限制。
AI 能力集成 #
- 外部应用最多只需调用两个接口,就可以完成一次 AI 能力集成,对不同图像识别能力,接口是固定的:其一是识别能力接口,其二是用户反馈接口
识别能力接口 #
接口说明
输入一张图片,检测图像中的所有人脸并返回每个人脸的核心关键点。
接口 URL
https://aicp.teamshub.com/sitech/aiopen/FaceAttributesDetection
访问方式
POST
接口头部参数
Content-Type:application/json token:"token" 注:可用的 token 需要联系管理员进行申请
参数 | 值 |
---|---|
Content-Type | multipart/form-data |
Body 参数
"file": "图片文件", "baseLs": "图片BASE64编码"
请求参数说明
**参数名** | **是否必传** | **类型** | **说明** |
---|---|---|---|
file | Y | file | 图片文件 |
baseLs | N | string | 图片的 BASE64 编码(与 file 二传一即可), 不含 BASE64 头 |
- 返回参数
{
"status": 200,
"message": "Request successful",
"data": {
"FaceInfos" :
{
"boxs" :
[
{
"height" : 651,
"width" : 507,
"x" : 207,
"y" : 386
}
],
"key_points" :
[
[
{
"x" : 366,
"y" : 660
},
{
"x" : 588,
"y" : 648
},
{
"x" : 480,
"y" : 818
},
{
"x" : 396,
"y" : 911
},
{
"x" : 573,
"y" : 901
}
]
]
},
"result" : "ok"
}
}
- 返回参数说明
**参数名** | **类型** | **说明** | |
---|---|---|---|
message | Y | string | 返回描述 |
status | Y | int | code 状态码 |
data | Y | object | 返回 JSON 对象 |
+result | Y | string | 算法层执行结果 |
+FaceInfos | Y | object | 人脸关键点对象 |
++boxs | Y | object | 人脸位置信息数组 |
+++x | Y | int | 人脸框 x 坐标 |
+++y | Y | int | 人脸框 y 坐标 |
+++width | Y | int | 人脸框宽度 |
+++height | Y | int | 人脸框高度 |
++key_points | Y | object | 人脸五点信息数组 |
+++x | Y | int | 头脸关键点 x 坐标 |
+++y | Y | int | 头脸关键点 y 坐标 |
用户反馈接口 #
接口说明
用户在调用识别能力后,需要反馈识别能力识别的信息是否准确。用户反馈接口和能力识别接口通过业务流水号唯一标识进行关联。
调用 URL:
https://aicp.teamshub.com/feedback/sitech/feedbackInformation
Header:
参数 值 Content-Type application/json token string 调用方法:
post
请求参数:
参数名 类型 是否必选 参数说明 serialNumber String 是 业务流水号 jobNumber String 否 业务工单号 information String 是 用户修正信息(转义的 json 字符串,每个能力不同) modifyFlag Boolean 是 修改标记(true 已修改,false 未修改) feedbackFlag Boolean 是 反馈标识 (true 为正确,false 为错误) time String 否 工单发生时间,不填默认查当天 请求报文示例:
{ "serialNumber":"8063200944317145088", "jobNumber":"test_jobNumber", "time":"2021-03-25", "modifyFlag":true, "feedbackFlag":false, "information":"{}" }
返回值描述:
参数名 类型 参数说明 flag Boolean 成功标识 resultCode Long 状态码 message String 返回信息 data JSON 返回结果 serialNumber String 业务流水号 成功返回示例:
{ "flag": true, "resultCode": 0, "message": "系统处理正常", "data": { "xxx":"" } }
失败返回示例:
{ "flag": false, "resultCode": 1, "message": "服务端报错", "data": null }