跳到主要内容

明星人物搜索

1. 任务简介

1.1 任务 ID

5c861a3aa80f7fc164eff612

提示

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

1.2 能力介绍

  • 明星人物搜索,支持通过人脸检测并匹配特征的方式识别用户图片中的人脸,返回相似明星人物的名字,以及匹配的人物图

2. 请求参数

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

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

3. 返回结果

3.1 公共返回结果

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

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

3.2 任务返回结果 🎯

任务结果

参数名称类型是否必需说明
fileListArray每张图片的识别结果,详见 FileResult 参数说明

FileResult 参数说明

表示上传的图片列表及其识别结果

参数名称类型是否必需说明
nameString如果上传的 image 参数是 url,则该值是图片 url;如果是以图片文件上传,则该值为文件名
objectsArray检测出来的所有人脸。详见 Objects 参数
labelNumber识别分类,详见任务返回标签说明
similarityNumber与图片的相似度,范围在 [0-1] 之间,分值越高,越相似
faceIdString最终给出相似人物的名字
faceUrlString最终给出相似人物匹配图链接
personIdString最终给出相似人物 id
reviewBoolean是否复审
facePositionArray人脸方框坐标以图片左上角为原点,分别是 [左上角坐标,右上角坐标,右下角坐标,左下角坐标], 坐标值是相对于图片大小的百分比形式
typeNameString最相似人物的所属类型名称
tagString调用时为该图片设置的 tag 参数

Objects 参数

相似对象的信息

参数名称类型是否必需说明
similarityNumber与人物的相似度,范围在 [0-1] 之间,分值越高,越相似
faceIdString与该人脸最相似人物的名称
labelNumber搜索结果
reviewBoolean是否复审
faceUrlString最终给出相似人物匹配图链接
personIdString最终给出相似人物 id
facePositionString人脸方框坐标以图片左上角为原点,分别是 [左上角坐标,右上角坐标,右下角坐标,左下角坐标], 坐标值是相对于图片大小的百分比形式
typeNameString与该人脸最相似人物的所属类型名称

3.3 任务返回标签说明 🎯🎯

label说明
0明星人物
1中间值
2非明星人物
3无人脸
-1识别失败

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"
}
]
},
"code": 0,
"message": "success",
"nonce": "0.19657901975332637",
"timestamp": 1505124155500
}