图片搜索
1. 任务 ID
- 政治人物搜索:
5b7be1f59b0c77a8c2afb351
分类标签请参考图片视频任务标签。
2. 回调公共参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| signature | String | 我们采用的数字证书签名算法是："RSA-SHA256"，签名输出类型是："base64"，首先下载图普科技的公钥证书，然后按如下步骤认证：1、收到的JSON数据经过JSON.parse()，得到JSON对象，记为data； 2、data含两个字段：signature、json；signature是数字签名，json是真正的有效数据的字符串格式； 3、用signature对json进行签名认证,算法： RSA-SHA256，输出类型：base64，得到认证结果；4、认证通过后，对json进行JSON.parse()，得到JSON数据，详见"json"字段说明。 |
| json | String | json 字段需经过JSON.parse(json)后，得到具体的结果。 |
json 参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| videoInfo | Object | 视频信息，具体字段依是否实时回调不同。 |
| fragmentInfo | Object | 视频片段信息。 |
| customInfo | Object | 自定义信息，请求参数中的customInfo。 |
| [taskId] | Object | 识别任务的结果。 |
| code | Number | 返回码，参考服务公共状态码解析。 |
| message | String | 返回信息。 |
| nonce | Number | 随机数。 |
| timestamp | Number | 当前的服务器的Unix时间戳。 |
2.1 视频流片段回调
videoInfo 参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| id | String | 视频唯一标识。 |
| captureStart | String | 视频截图开始时间，ISO时间。 |
fragmentInfo 参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| id | String | 视频片段唯一标识。 |
| offsetStart | Number | 视频片段截帧开始位置，单位秒。 |
| offsetEnd | Number | 视频片段截帧结束位置，单位秒。 |
taskId 参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| fileList | Array | 每张图片的识别结果。 |
2.2 视频文件回调
videoInfo 参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| id | String | 视频唯一标识。 |
| captureStart | String | 视频截图开始时间，ISO时间。 |
| duration | Number | 视频时长，单位秒。 |
| frames | Number | 视频帧数，单位帧。 |
| status | String | 视频状态，end/error。 |
| message | String | 视频结果信息。 |
3. taskId 参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| fileList | Array | 指定label的部分图片的识别结果。 |
| maximums | Array | 各个分类的图片的最高分。 |
| statistics | Array | 各个分类的图片数量。 |
| matchList | Array | 匹配的全部人物列表。 |
| label | Number | 最终识别分类。 |
| review | Boolean | 是否需要复审。 |
fileList 参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| url | String | 图片链接。 |
| similarity | Number | 人物相似度。 |
| label | Number | 识别分类。 |
| review | Boolean | 是否需要复审。 |
| personId | String | 人物ID。 |
| faceId | String | 人物名称。 |
| typeName | String | 人物类型。 |
| facePosition | Array | 人脸方框坐标 [左上角坐标,右上角坐标,右下角坐标,左下角坐标], 坐标值是相对于图片大小的百分比形式。 |
| offset | Number | 截帧位置，单位秒。 |
matchList 参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| personId | String | 人物ID。 |
| faceId | String | 人物名称。 |
| typeName | String | 人物类型。 |
4. 响应示例
4.1 视频流片段回调示例
{
"videoInfo": {
"id": "5cef85b518e5bc327d102e42",
"captureStart": "2019-06-01T00:00:00.000Z"
},
"fragmentInfo": {
"id": "5cef85b518e5bc327d102e42",
"offsetStart": 0,
"offsetEnd": 60
},
"customInfo": {
"id": 1
},
"5b7be1f59b0c77a8c2afb351": {
"fileList": [
{
"url": "https://static.tuputech.com/api/image/original/cloud-api/storage-0831/2019-06-20/15-7/5c8760515a82342809627fea/15610140357660.906444779265335.jpg",
"similarity": 0.32518404722213745,
"label": 2,
"review": false,
"facePosition": [
[
0.19140625,
0.25
],
[
0.3125,
0.25
],
[
0.3125,
0.4652777777777778
],
[
0.19140625,
0.4652777777777778
]
],
"typeName": "外国政治人物",
"faceId": "非政治人物"
}
]
}
}
4.2 视频文件回调示例
{
"videoInfo": {
"id": "5d0b2f0511b3e74eadf152dd",
"captureStart": "2019-06-20T07:00:22.851Z",
"duration": 8.5,
"frames": 204,
"status": "end",
"message": "success"
},
"customInfo": {
"id": 1
},
"5b7be1f59b0c77a8c2afb351": {
"fileList": [
{
"url": "https://static.tuputech.com/api/image/original/cloud-api/storage-0831/2019-06-20/15-7/5c8760515a82342809627fea/15610140357660.906444779265335.jpg",
"similarity": 0.32518404722213745,
"label": 2,
"review": false,
"facePosition": [
[
0.19140625,
0.25
],
[
0.3125,
0.25
],
[
0.3125,
0.4652777777777778
],
[
0.19140625,
0.4652777777777778
]
],
"typeName": "外国政治人物",
"faceId": "金正恩",
"personId": "5cc01fe9da417194068fdd41",
"offset": 0
}
],
"statistics": [
{
"count": 1,
"label": 0
},
{
"count": 3,
"label": 2
},
{
"count": 6,
"label": 3
}
],
"matchList": [
{
"personId": "5cc01fe9da417194068fdd41",
"faceId": "金正恩",
"typeName": "外国政治人物"
}
],
"label": 0,
"review": false
}
}