指尖检测（邀测）
更新时间：2022-11-15
接口描述
对于输入的一张图片（可正常解码，且长宽比适宜），检测图片中的手部，定位食指指尖、及4个辅助关键点的坐标位置，模型针对儿童学习机点读场景进行专项调优，可用于点读搜题、自动跟读等应用。
当前接口主要适用于图片中单个手部的情况，图片中同时存在多个手部时，识别效果可能欠佳。
示例图如下：
注：
1、邀测的接口，不能直接在控制台调用，可通过百度人体分析官方QQ群（860337848）联系群管、或提交工单申请开通测试权限。
2、邀测的接口，暂未封装服务端SDK，只能通过API调用。
在线调试
您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法：POST
请求URL：https://aip.baidubce.com/rest/2.0/image-classify/v1/fingertip
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token，参考“Access Token获取” |
Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数，参数详情如下：
请求参数
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|---|---|---|---|
| image | 是 | string | - | 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。图片的base64编码是不包含图片头的，如(data:image/jpg;base64,)，支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px。 |
返回说明
返回参数
| 字段 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| hand_num | 是 | uint32 | 检测到的人手数目 |
| hand_info | 否 | object[] | 手部关节点信息 |
| +location | 否 | object | 手部坐标信息 |
| ++left | 否 | int | 手部区域离左边界的距离 |
| ++top | 否 | int | 手部区域离上边界的距离 |
| ++width | 否 | int | 手部区域的宽度 |
| ++height | 否 | int | 手部区域的高度 |
| ++score | 是 | float | 置信度分数，取值范围0-1 |
| +hand_parts | 是 | object | 指尖关键点信息，包含食指指尖、及辅助的4个关键点 |
| ++0 | 是 | object | 食指指尖 |
| +++x | 是 | uint32 | x坐标 |
| +++y | 是 | uint32 | y坐标 |
| +++score | 是 | float | 置信度分数，取值范围0-1。可基于置信度分数进行过滤，排除掉分数低的误识别“无效关键点”，推荐的过滤方案：置信度分数≥0.2。实际应用中，可根据对误识别、漏识别的容忍程度，调整阈值过滤方案，灵活应用 |
| ++1 | 是 | object | 食指中间关节 |
| +++x | 是 | uint32 | x坐标 |
| +++y | 是 | uint32 | y坐标 |
| +++score | 是 | float | 置信度分数 |
| ++2 | 是 | object | 食指指根 |
| +++x | 是 | uint32 | x坐标 |
| +++y | 是 | uint32 | y坐标 |
| +++score | 是 | float | 置信度分数 |
| ++3 | 是 | object | 中指中间关节 |
| +++x | 是 | uint32 | x坐标 |
| +++y | 是 | uint32 | y坐标 |
| +++score | 是 | float | 置信度分数 |
| ++4 | 是 | object | 中指指根 |
| +++x | 是 | uint32 | x坐标 |
| +++y | 是 | uint32 | y坐标 |
| +++score | 是 | float | 置信度分数 |
返回示例
{
"log_id": "4653273132348525916",
"hand_num": 1,
"hand_info": [
{
"hand_parts": {
"0": {
"y": 707,
"x": 829,
"score": 0.81601244211197
},
"1": {
"y": 620,
"x": 873,
"score": 0.6850221157074
},
"2": {
"y": 533,
"x": 916,
"score": 0.75532239675522
},
"3": {
"y": 467,
"x": 938,
"score": 0.79282909631729
},
"4": {
"y": 380,
"x": 993,
"score": 0.88114696741104
}
},
"location": {
"height": 556,
"width": 426,
"top": 151,
"score": 0.795880126953,
"left": 567
}
}
]
}