明星人物搜索
1. 任务简介
1.1 任务 ID
5c861a3aa80f7fc164eff612
提示
任务 ID 全局固定且不变,建议客户将其定义为代码常量。
1.2 能力介绍
- 明星人物搜索,支持通过人脸检测并匹配特征的方式识别用户图片中的人脸,返回相似明星人物的名字,以及匹配的人物图
2. 请求参数
图片接口公共请求参数详见:图片同步识别接口,图片异步识别接口
视频接口公共请求参数详见:视频同步识别接口,视频文件异步识别接口,视频流异步识别接口
3. 返回结果
3.1 公共返回结果
图片接口公共返回结果详见:图片同步识别接口,图片异步识别接口
视频接口公共返回结果详见:视频同步识别接口,视频文件异步识别接口,视频流异步识别接口
3.2 任务返回结果 🎯
任务结果
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
fileList | Array | 是 | 每张图片的识别结果,详见 FileResult 参数说明 |
FileResult 参数说明
表示上传的图片列表及其识别结果
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
name | String | 是 | 如果上传的 image 参数是 url,则该值是图片 url;如果是以图片文件上传,则该值为文件名 |
objects | Array | 是 | 检测出来的所有人脸。详见 Objects 参数 |
label | Number | 是 | 识别分类,详见任务返回标签说明 |
similarity | Number | 是 | 与图片的相似度,范围在 [0-1] 之间,分值越高,越相似 |
faceId | String | 是 | 最终给出相似人物的名字 |
faceUrl | String | 是 | 最终给出相似人物匹配图链接 |
personId | String | 否 | 最终给出相似人物 id |
review | Boolean | 是 | 是否复审 |
facePosition | Array | 否 | 人脸方框坐标以图片左上角为原点,分别是 [左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式 |
typeName | String | 否 | 最相似人物的所属类型名称 |
tag | String | 否 | 调用时为该图片设置的 tag 参数 |
Objects 参数
相似对象的信息
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
similarity | Number | 是 | 与人物的相似度,范围在 [0-1] 之间,分值越高,越相似 |
faceId | String | 是 | 与该人脸最相似人物的名称 |
label | Number | 是 | 搜索结果 |
review | Boolean | 是 | 是否复审 |
faceUrl | String | 否 | 最终给出相似人物匹配图链接 |
personId | String | 否 | 最终给出相似人物 id |
facePosition | String | 否 | 人脸方框坐标以图片左上角为原点,分别是 [左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式 |
typeName | String | 否 | 与该人脸最相似人物的所属类型名称 |
3.3 任务返回标签说明 🎯🎯
label | 说明 |
---|---|
0 | 明星人物 |
1 | 中间值 |
2 | 非明星人物 |
3 | 无人脸 |
3.4 任务结果示例
{
"5c861a3aa80f7fc164eff612": {
"fileList": [
{
"name": "https://www.tuputech.com/test.jpg",
"objects": [
{
"facePosition": [
[
0.28205128205128205,
0.16666666666666666
],
[
0.6538461538461539,
0.16666666666666666
],
[
0.6538461538461539,
0.5384615384615384
],
[
0.28205128205128205,
0.5384615384615384
]
],
"similarity": 0.91219645738601685,
"typeName": "xxx",
"faceId": "YYY",
"featureId": "5fc71e0438ecdf209dddc20f",
"personId": "5fc71e0438ecdf209dddc20e",
"review": false,
"label": 0
}
],
"similarity": 0.91219645738601685,
"label": 0,
"review": false,
"facePosition": [
[
0.28205128205128205,
0.16666666666666666
],
[
0.6538461538461539,
0.16666666666666666
],
[
0.6538461538461539,
0.5384615384615384
],
[
0.28205128205128205,
0.5384615384615384
]
],
"typeName": "xxx",
"faceId": "YYY",
"featureId": "5fc71e0438ecdf209dddc20f",
"personId": "5fc71e0438ecdf209dddc20e",
"tag": "test"
}
]
}
}