知名人物搜索

1. 任务 ID

5e13f8b2170dd16ec51f2c95

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 匹配的全部人物列表。

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": "5d0b2f0511b3e74eadf152dd",
    "captureStart": "2019-06-20T07:00:22.851Z",
    "duration": 8.5,
    "frames": 204,
    "status": "end",
    "message": "success"
  },
  "customInfo": {
    "id": 1
  },
  "5e13f8b2170dd16ec51f2c95": {
    "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": "外国政治人物"
      }
    ]
  }
}

results matching ""

    No results matching ""