自定义图库
1. 任务 ID
5c8f44ca25ade48455a63bad
详情请参考图片视频任务标签
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 | 各个分类的图片数量。 |
| label | Number | 最终识别分类。 |
fileList 参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| url | String | 图片链接。 |
| label | Number | 识别分类。 |
| similarity | Number | 图片相似度。 |
| relatives | Array | 相似的在库图片。 |
| offset | Number | 截帧位置，单位秒。 |
relatives 参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| path | String | 图片链接。 |
| score | Number | 匹配分数。 |
4. 响应示例
4.1 视频流片段回调示例
{
"videoInfo": {
"id": "5cef85b518e5bc327d102e42",
"captureStart": "2019-06-01T00:00:00.000Z"
},
"fragmentInfo": {
"id": "5cef85b518e5bc327d102e42",
"offsetStart": 0,
"offsetEnd": 60
},
"customInfo": {
"id": 1
},
"5c8f44ca25ade48455a63bad": {
"fileList": [
{
"url": "https://static.tuputech.com/api/image/original/cloud-api/storage-0831/2019-06-20/15-7/5c8760515a82342809627fea/15610140357660.906444779265335.jpg",
"label": 2,
"similarity": 0.6458022594451904,
"relatives": [
{
"path": "https://static.tuputech.com/lts/image/original/lts-52/LTS-Bucket-UserDefineImages/2019-03-29/cloud-api/storage-0831/2019-03-29/10/0.9202317260827633/15538277415580.7420568768203986.jpg",
"score": 0.6458022594451904
}
]
}
]
}
}
4.2 视频文件回调示例
{
"videoInfo": {
"id": "5d0b2f0511b3e74eadf152dd",
"captureStart": "2019-06-20T07:00:22.851Z",
"duration": 8.5,
"frames": 204,
"status": "end",
"message": "success"
},
"customInfo": {
"id": 1
},
"5c8f44ca25ade48455a63bad": {
"maximums": [
{
"max": 0.7245864868164062,
"label": 2
}
],
"statistics": [
{
"count": 4,
"label": 2
}
],
"fileList": [
{
"url": "https://static.tuputech.com/api/image/original/cloud-api/storage-0831/2019-06-20/15-7/5c8760515a82342809627fea/15610140357660.906444779265335.jpg",
"label": 2,
"similarity": 0.6458022594451904,
"relatives": [
{
"path": "https://static.tuputech.com/lts/image/original/lts-52/LTS-Bucket-UserDefineImages/2019-03-29/cloud-api/storage-0831/2019-03-29/10/0.9202317260827633/15538277415580.7420568768203986.jpg",
"score": 0.6458022594451904
}
],
"offset": 10
}
],
"label": 2
}
}