敏感人物搜索(带自定义名单)
1. 任务简介
1.1 任务 ID
642a726e780a3f7692a5a912
提示
任务 ID 全局固定且不变,建议客户将其定义为代码常量。
1.2 能力介绍
支持识别过滤含有时政敏感人物、落马官员、恐怖分子、劣迹艺人等内容的涉政图片。支持客户配置自定义名单 ,识别自定义名单中的人物。
2. 请求参数
图片接口公共请求参数详见:图片同步识别接口,图片异步识别接口
视频接口公共请求参数详见:视频同步识别接口,视频文件异步识别接口,视频流异步识别接口
3. 返回结果
3.1 公共返回结果
图片接口公共返回结果详见:图片同步识别接口,图片异步识别接口
视频接口公共返回结果详见:视频同步识别接口,视频文件异步识别接口,视频流异步识别接口
3.2 任务返回结果 🎯
- 图片接口
- 视频文件接口(v3.1)
- 视频流接口(v3.1)
- 文档接口(v3.1)
任务结果
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
fileList | Array | 是 | 每张图片的识别结果,详见 FileResult 参数说明 |
FileResult 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 相似度得分最高的人脸的搜索结果,详见 任务返回标签说明 |
similarity | Float | 是 | 图片全部人脸中,最大相似度得分,范围在 [0-1] 之间,分值越高,越相似 |
review | Boolean | 是 | 是否复审 |
name | String | 是 | 如果上传的 image 参数是 url,则该值是图片 url;如果是以图片文件上传,则该值为文件名 |
objects | Array<Object> | 否 | 单张图片中,所有人脸的搜索结果,详见 Object 参数说明 |
personId | String | 否 | 相似度得分最高的人物的 ID |
featureId | String | 否 | 相似度得分最高的人物的特征 ID |
faceId | String | 否 | 相似度得分最高的人物的名称 |
typeName | String | 否 | 相似度得分最高的人物的所属类型名称 |
faceUrl | String | 否 | 相似度得分最高的人物的匹配图链接 |
facePosition | Array | 否 | 检测到的人脸坐标信息以图片左上角为原点,分别是 [左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式 |
tag | String | 否 | 调用时为该图片设置的 tag 参数 |
Object 参数
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 搜索结果,详见 任务返回标签说明 |
similarity | Float | 是 | 与人物的相似度,范围在 [0-1] 之间,分值越高,越相似 |
review | Boolean | 是 | 是否复审 |
personId | String | 否 | 与该人脸相似度得分最高的人物的 ID |
featureId | String | 否 | 与该人脸相似度得分最高的人物的特征 ID |
faceId | String | 否 | 与该人脸相似度得分最高的人物的名称 |
typeName | String | 否 | 与该人脸相似度得分最高的人物的所属类型名称 |
faceUrl | String | 否 | 与该人脸相似度得分最高的人物的匹配图链接 |
facePosition | Array | 否 | 检测到的人脸坐标信息以图片左上角为原点,分别是 [左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式 |
任务结果
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
fileList | Array<FileResult> | 否 | 每张图片的识别结果,在数组为空时该字段省略。详见 FileResult 参数说明 |
label | Int | 是 | 图片汇总后的任务标签识别分类,详见 任务返回标签说明 |
review | Boolean | 是 | 图片汇总后的结果是否需要复审 |
maximums | Array | 是 | 图片汇总后,识别分类及对应的最大得分,详见 Maximum 参数说明 |
statistics | Array | 是 | 图片汇总后,识别分类及对应的图片数量,详见 Statistic 参数说明 |
matchList | Array | 是 | 图片汇总后,全部人物命中数量,详见 Match 参数说明 |
FileResult 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 相似度得分最高的人脸的搜索结果,详见 任务返回标签说明 |
similarity | Float | 是 | 图片全部人脸中,最大相似度得分,范围在 [0-1] 之间,分值越高,越相似 |
review | Boolean | 是 | 是否复审 |
name | String | 是 | 视频截图文件名称 |
url | String | 是 | 视频截图文件链接,有效期 7 天 |
second | Float | 是 | 视频截图时间点,表示在第 N 秒截取了该图片。 1. 对于视频流,值为开始截图后的相对时间点 |
objects | Array<Object> | 否 | 单张图片中,所有人脸的搜索结果,详见 Object 参数说明 |
personId | String | 否 | 相似度得分最高的人物的 ID |
featureId | String | 否 | 相似度得分最高的人物的特征 ID |
faceId | String | 否 | 相似度得分最高的人物的名称 |
typeName | String | 否 | 相似度得分最高的人物的所属类型名称 |
faceUrl | String | 否 | 相似度得分最高的人物的匹配图链接 |
facePosition | Array | 否 | 检测到的人脸坐标信息以图片左上角为原点,分别是 [左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式 |
tag | String | 否 | 调用时为该图片设置的 tag 参数 |
Maximum 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 识别分类 |
max | Float | 是 | 对应识别分类的最大得分 |
Statistic 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 识别分类 |
count | Int | 是 | 对应识别分类的图片数量 |
Match 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
personId | String | 否 | 人物的 ID |
featureId | String | 否 | 人物的特征 ID |
faceId | String | 否 | 人物的名称 |
typeName | String | 否 | 人物的所属类型名称 |
count | Int | 是 | 对应人物的人脸数量 |
Object 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 搜索结果,详见 任务返回标签说明 |
similarity | Float | 是 | 与人物的相似度,范围在 [0-1] 之间,分值越高,越相似 |
review | Boolean | 是 | 是否复审 |
personId | String | 否 | 与该人脸相似度得分最高的人物的 ID |
featureId | String | 否 | 与该人脸相似度得分最高的人物的特征 ID |
faceId | String | 否 | 与该人脸相似度得分最高的人物的名称 |
typeName | String | 否 | 与该人脸相似度得分最高的人物的所属类型名称 |
faceUrl | String | 否 | 与该人脸相似度得分最高的人物的匹配图链接 |
facePosition | Array | 否 | 检测到的人脸坐标信息以图片左上角为原点,分别是 [左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式 |
任务结果
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
fileList | Array<FileResult> | 否 | 每张图片的识别结果,在数组为空时该字段省略。详见 FileResult 参数说明 |
matchList | Array | 是 | 图片汇总后,全部人物命中数量,详见 Match 参数说明 |
FileResult 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 相似度得分最高的人脸的搜索结果,详见 任务返回标签说明 |
similarity | Float | 是 | 图片全部人脸中,最大相似度得分,范围在 [0-1] 之间,分值越高,越相似 |
review | Boolean | 是 | 是否复审 |
name | String | 是 | 视频截图文件名称 |
url | String | 是 | 视频截图文件链接,有效期 7 天 |
second | Float | 是 | 视频截图时间点,表示在第 N 秒截取了该图片。 1. 对于视频流,值为开始截图后的相对时间点 |
objects | Array<Object> | 否 | 单张图片中,所有人脸的搜索结果,详见 Object 参数说明 |
personId | String | 否 | 相似度得分最高的人物的 ID |
featureId | String | 否 | 相似度得分最高的人物的特征 ID |
faceId | String | 否 | 相似度得分最高的人物的名称 |
typeName | String | 否 | 相似度得分最高的人物的所属类型名称 |
faceUrl | String | 否 | 相似度得分最高的人物的匹配图链接 |
facePosition | Array | 否 | 检测到的人脸坐标信息以图片左上角为原点,分别是 [左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式 |
tag | String | 否 | 调用时为该图片设置的 tag 参数 |
Match 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
personId | String | 否 | 人物的 ID |
featureId | String | 否 | 人物的特征 ID |
faceId | String | 否 | 人物的名称 |
typeName | String | 否 | 人物的所属类型名称 |
count | Int | 是 | 对应人物的人脸数量 |
Object 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 搜索结果,详见 任务返回标签说明 |
similarity | Float | 是 | 与人物的相似度,范围在 [0-1] 之间,分值越高,越相似 |
review | Boolean | 是 | 是否复审 |
personId | String | 否 | 与该人脸相似度得分最高的人物的 ID |
featureId | String | 否 | 与该人脸相似度得分最高的人物的特征 ID |
faceId | String | 否 | 与该人脸相似度得分最高的人物的名称 |
typeName | String | 否 | 与该人脸相似度得分最高的人物的所属类型名称 |
faceUrl | String | 否 | 与该人脸相似度得分最高的人物的匹配图链接 |
facePosition | Array | 否 | 检测到的人脸坐标信息以图片左上角为原点,分别是 [左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式 |
任务结果
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
fileList | Array<FileResult> | 否 | 每张图片的识别结果,在数组为空时该字段省略。详见 FileResult 参数说明 |
FileResult 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 相似度得分最高的人脸的搜索结果,详见 任务返回标签说明 |
similarity | Float | 是 | 图片全部人脸中,最大相似度得分,范围在 [0-1] 之间,分值越高,越相似 |
review | Boolean | 是 | 是否复审 |
name | String | 是 | 图片名称,根据所在页及图片索引生成,用以唯一标识文档中的图片 |
objects | Array<Object> | 否 | 单张图片中,所有人脸的搜索结果,详见 Object 参数说明 |
personId | String | 否 | 相似度得分最高的人物的 ID |
featureId | String | 否 | 相似度得分最高的人物的特征 ID |
faceId | String | 否 | 相似度得分最高的人物的名称 |
typeName | String | 否 | 相似度得分最高的人物的所属类型名称 |
faceUrl | String | 否 | 相似度得分最高的人物的匹配图链接 |
facePosition | Array | 否 | 检测到的人脸坐标信息以图片左上角为原点,分别是 [左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式 |
Object 参数说明
参数名称 | 类型 | 是否必有 | 说明 |
---|---|---|---|
label | Int | 是 | 搜索结果,详见 任务返回标签说明 |
similarity | Float | 是 | 与人物的相似度,范围在 [0-1] 之间,分值越高,越相似 |
review | Boolean | 是 | 是否复审 |
personId | String | 否 | 与该人脸相似度得分最高的人物的 ID |
featureId | String | 否 | 与该人脸相似度得分最高的人物的特征 ID |
faceId | String | 否 | 与该人脸相似度得分最高的人物的名称 |
typeName | String | 否 | 与该人脸相似度得分最高的人物的所属类型名称 |
faceUrl | String | 否 | 与该人脸相似度得分最高的人物的匹配图链接 |
facePosition | Array | 否 | 检测到的人脸坐标信息以图片左上角为原点,分别是 [左上角坐标 ,右上角坐标 ,右下角坐标 ,左下角坐标 ], 坐标值是相对于图片大小的百分比形式 |
3.3 任务返回标签说明 🎯🎯
label 值 | 说明 |
---|---|
0 | 政治人物 |
1 | 中间值(已废弃) |
2 | 非政治人物 |
3 | 无人脸(未检测到人脸,或人脸过小) |
3.4 任务结果示例
- 图片接口
- 视频文件接口(v3.1)
- 视频流接口(v3.1)
- 文档接口(v3.1)
{
"642a726e780a3f7692a5a912": {
"fileList": [
{
"label": 0,
"similarity": 0.91219645738601685,
"review": false,
"name": "<name>",
"typeName": "<typeName>",
"faceId": "<faceId>",
"faceUrl": "<faceUrl>",
"featureId": "<featureId>",
"personId": "<personId>",
"tag": "<tag>",
"facePosition": [
[
0.28205128205128205,
0.16666666666666666
],
[
0.6538461538461539,
0.16666666666666666
],
[
0.6538461538461539,
0.5384615384615384
],
[
0.28205128205128205,
0.5384615384615384
]
],
"objects": [
{
"label": 0,
"similarity": 0.91219645738601685,
"review": false,
"name": "<name>",
"typeName": "<typeName>",
"faceId": "<faceId>",
"faceUrl": "<faceUrl>",
"featureId": "<featureId>",
"personId": "<personId>",
"facePosition": [
[
0.28205128205128205,
0.16666666666666666
],
[
0.6538461538461539,
0.16666666666666666
],
[
0.6538461538461539,
0.5384615384615384
],
[
0.28205128205128205,
0.5384615384615384
]
]
}
]
}
]
}
}
{
"642a726e780a3f7692a5a912": {
"fileList": [
{
"label": 0,
"review": false,
"name": "279910f2ffce4ea18b8fd3526b6a98ba-4",
"url": "https://static.tuputech.com/api/image/original/cloud-api/storage-0831/2023-12-08/18-7/279910f2ffce4ea18b8fd3526b6a98ba/1702030163.2462770138989784069.jpeg",
"faceUrl": "https://static.tuputech.com/lts/image/original/%2Flts-52%2FLTS-Bucket-CustomData-politicians-database-panyiming-20190422%2F1_28%2Fb4ff8bc5691e36ddc169d34bd2e25530.jpg",
"similarity": 0.7028458,
"personId": "5cbe72359ba39146509d68a7",
"faceId": "李克强",
"typeName": "国家或地区领导人",
"facePosition": [
[
0.5646893,
0.3562533
],
[
0.5922368,
0.3562533
],
[
0.5922368,
0.41475397
],
[
0.5646893,
0.41475397
]
],
"offset": 11,
"second": 8.999999731779106,
"featureId": "ec0d44b76b76d0abe281e965c664d2ab",
"objects": [
{
"similarity": 0.7028458,
"faceId": "李克强",
"label": 0,
"review": false,
"faceUrl": "https://static.tuputech.com/lts/image/original/%2Flts-52%2FLTS-Bucket-CustomData-politicians-database-panyiming-20190422%2F1_28%2Fb4ff8bc5691e36ddc169d34bd2e25530.jpg",
"personId": "5cbe72359ba39146509d68a7",
"typeName": "国家或地区领导人",
"facePosition": [
[
0.5646893,
0.3562533
],
[
0.5922368,
0.3562533
],
[
0.5922368,
0.41475397
],
[
0.5646893,
0.41475397
]
],
"featureId": "ec0d44b76b76d0abe281e965c664d2ab"
}
]
}
],
"label": 0,
"review": false,
"maximums": [
{
"label": 0,
"max": 0.8632964
}
],
"statistics": [
{
"label": 0,
"count": 2
},
{
"label": 2,
"count": 7
}
],
"matchList": [
{
"personId": "5cbe72359ba39146509d68a7",
"faceId": "李克强",
"typeName": "国家或地区领导人",
"count": 1
}
]
}
}
{
"642a726e780a3f7692a5a912": {
"fileList": [
{
"label": 0,
"review": false,
"name": "279910f2ffce4ea18b8fd3526b6a98ba-4",
"url": "https://static.tuputech.com/api/image/original/cloud-api/storage-0831/2023-12-08/18-7/279910f2ffce4ea18b8fd3526b6a98ba/1702030163.2462770138989784069.jpeg",
"faceUrl": "https://static.tuputech.com/lts/image/original/%2Flts-52%2FLTS-Bucket-CustomData-politicians-database-panyiming-20190422%2F1_28%2Fb4ff8bc5691e36ddc169d34bd2e25530.jpg",
"similarity": 0.7028458,
"personId": "5cbe72359ba39146509d68a7",
"faceId": "李克强",
"typeName": "国家或地区领导人",
"facePosition": [
[
0.5646893,
0.3562533
],
[
0.5922368,
0.3562533
],
[
0.5922368,
0.41475397
],
[
0.5646893,
0.41475397
]
],
"offset": 11,
"second": 8.999999731779106,
"featureId": "ec0d44b76b76d0abe281e965c664d2ab",
"objects": [
{
"similarity": 0.7028458,
"faceId": "李克强",
"label": 0,
"review": false,
"faceUrl": "https://static.tuputech.com/lts/image/original/%2Flts-52%2FLTS-Bucket-CustomData-politicians-database-panyiming-20190422%2F1_28%2Fb4ff8bc5691e36ddc169d34bd2e25530.jpg",
"personId": "5cbe72359ba39146509d68a7",
"typeName": "国家或地区领导人",
"facePosition": [
[
0.5646893,
0.3562533
],
[
0.5922368,
0.3562533
],
[
0.5922368,
0.41475397
],
[
0.5646893,
0.41475397
]
],
"featureId": "ec0d44b76b76d0abe281e965c664d2ab"
}
]
}
],
"matchList": [
{
"personId": "5cbe72359ba39146509d68a7",
"faceId": "李克强",
"typeName": "国家或地区领导人",
"count": 1
}
]
}
}
{
"642a726e780a3f7692a5a912": {
"fileList": [
{
"label": 0,
"review": false,
"name": "279910f2ffce4ea18b8fd3526b6a98ba-1-1",
"faceUrl": "https://static.tuputech.com/lts/image/original/%2Flts-52%2FLTS-Bucket-CustomData-politicians-database-panyiming-20190422%2F1_28%2Fb4ff8bc5691e36ddc169d34bd2e25530.jpg",
"similarity": 0.7028458,
"personId": "5cbe72359ba39146509d68a7",
"faceId": "李克强",
"typeName": "国家或地区领导人",
"facePosition": [
[
0.5646893,
0.3562533
],
[
0.5922368,
0.3562533
],
[
0.5922368,
0.41475397
],
[
0.5646893,
0.41475397
]
],
"featureId": "ec0d44b76b76d0abe281e965c664d2ab",
"objects": [
{
"similarity": 0.7028458,
"faceId": "李克强",
"label": 0,
"review": false,
"faceUrl": "https://static.tuputech.com/lts/image/original/%2Flts-52%2FLTS-Bucket-CustomData-politicians-database-panyiming-20190422%2F1_28%2Fb4ff8bc5691e36ddc169d34bd2e25530.jpg",
"personId": "5cbe72359ba39146509d68a7",
"typeName": "国家或地区领导人",
"facePosition": [
[
0.5646893,
0.3562533
],
[
0.5922368,
0.3562533
],
[
0.5922368,
0.41475397
],
[
0.5646893,
0.41475397
]
],
"featureId": "ec0d44b76b76d0abe281e965c664d2ab"
}
]
}
]
}
}