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

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

1. 接口请求

1.1 接口地址

http://api.video.tuputech.com/v3/recognition/video/result/'your_secretId'

'your_secretId' 需替换为您的 secretId,请联系我们为您开通 secretId。

海外服务调用域名: api-us.open.tuputech.com

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的值。

点击管理公钥证书查看如何生成私钥,及如何上传您的公钥用于数字签名的认证;点击API SDK查看代码示例。

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 ""