明星人物搜索

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	否	与该人脸最相似人物的所属类型名称

任务返回标签说明

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

3.3 响应示例

{
    "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
}