查询异步识别任务状态及结果

限于视频流时长不确定，对于视频流任务本接口未返回识别结果。

1. 接口请求

1.1 接口地址

  • 国内: http://api.video.tuputech.com/v3/recognition/video/result/<secretId>
  • 国外: http://api-us.open.tuputech.com/v3/recognition/video/result/<secretId>

secretId 需替换为您的 secretId，请联系我们为您开通 secretId。

1.2 请求方法及请求头

请求方法: POST

请求头:

参数名称 类型 是否必需 说明
Content-Type String 是 application/json

1.3 请求参数

参数名称 类型 是否必需 说明
videoId String 是 视频唯一标识。
timestamp Number 是 当前的服务器的Unix时间戳。
nonce Number 是 随机数。
signature String 是 我们采用的数字证书签名算法是："RSA-SHA256"，签名输出类型是："base64"，具体步骤如下：
1、所有参与签名的参数为：secretId，timestamp，nonce，用英文半角逗号“,”相连，得到sign_string；
2、利用您的私钥，使用算法"RSA-SHA256"签名，输出为 "base64" 格式，得到参数signature的值。

点击管理公钥证书查看如何生成私钥，及如何上传您的公钥用于数字签名的认证。

1.4 请求示例

{
    "videoId": "5cef85b518e5bc327d102e42",
    "timestamp": 1559554003759,
    "nonce": 0.6157904536165131,
    "signature": "p0fX2Vb5JMtN0wM7WkQRsyaH2zk3zYYRlBAydPmuWkofb06KdSPhq4URYHaAFU/dXodfJS9x2PbZBNz084RF0NIiJvBUcK8mFeA//jDueWhoxEI9Y="
}

2. 接口响应

2.1 响应内容

参数名称 类型 说明
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参数

参数名称 类型 说明
code Int 返回码，参考服务公共状态码解析。
message String 返回信息。
status String 视频任务当前状态: cancelled: 已取消, failed：任务失败, pending: 正在排队, processing: 正在处理, success: 处理完成
result Object 识别结果, 结构参考视频异步识别接口回调结果。
nonce Int 随机数。
timestamp Int 当前的服务器的Unix时间戳。

2.2 json 示例

{
  "code": 0,
  "message": "success",
  "status": "success",
  "result": {
    "5e13f8b2170dd16ec51f2c95": {
      "fileList": [
        {
          "label": 0,
          "review": false,
          "url": "https://static.tuputech.com/api/image/original/cloud-api/storage-233/2021-10-18/18-7/60d5a703f5790e00946ea229/1634553641.8709216301029604823.jpeg",
          "faceUrl": "https://static.tuputech.com/lts/image/original/%2Flts-52%2FLTS-Bucket-CustomData-politicians-database-panyiming-20190422%2F1_401%2F4d8bcede32481cdd2c80eb7cabfa5719.jpg",
          "similarity": 0.57177734375,
          "personId": "5cbe72409ba39146509d6fa3",
          "faceId": "范长龙",
          "typeName": "国家或地区领导人",
          "facePosition": [
            [
              0.11796875,
              0.39305555555555555
            ],
            [
              0.21796875,
              0.39305555555555555
            ],
            [
              0.21796875,
              0.5708333333333333
            ],
            [
              0.11796875,
              0.5708333333333333
            ]
          ],
          "offset": 14,
          "featureId": "c9f0a79176f26fd061cb976efd28caf5"
        }
      ],
      "maximums": [
        {
          "label": 0,
          "max": 0.86474609375
        }
      ],
      "statistics": [
        {
          "label": 0,
          "count": 4
        }
      ],
      "matchList": [
        {
          "personId": "5cbe72409ba39146509d6fa3",
          "faceId": "范长龙",
          "typeName": "国家或地区领导人"
        }
      ],
      "label": 0,
      "review": false
    },
    "riskType": 0,
    "suggestion": 0,
    "videoInfo": {
      "id": "616d194a68a181480f976a02",
      "captureStart": "2021-10-18T10:40:40.013Z",
      "duration": 51.48,
      "frames": 119
    }
  },
  "nonce": 0.041237185,
  "timestamp": 1634873294041
}

results matching ""

    No results matching ""