视频同步识别接口

请求地址:

http://api.open.tuputech.com/v3/recognition/video/syncscan/'your_secretId' 'your_secretId'需替换为您的secretId,请联系我们为您开通secretId。

请求方法:

POST

请求头

参数名称 类型 是否必需 说明
Content-Type String multipart/form-data

关于视频文件的限制

视频大小限制:不超过20M;
支持的格式:flv, mkv, mp4, rmvb, avi, wmv, 3gp, ts, mov, gif, m3u8。

关于视频并发的限制

视频同步处理最大并发为1分钟60个,即1分钟内处理最大数量为60个。
1分钟内调用超过60个,则需要等待下一分钟才能调用。

关于视频截图的尺寸

如果视频的分辨率的短边超过1024,则截取的图片以“1024/短边”等比例截取。
例如:视频分辨率为1920x1080,截图的尺寸为1820x1024。

请求参数

参数名称 类型 是否必需 说明
video String / File 1.支持视频链接或者上传视频文件;
2.只支持一个video参数,即只能传一个视频链接或者上传一个视频文件;
3.支持常见视频格式和gif动图。
interval Number 视频截图间隔,范围[1, 10]秒,默认1秒。
maxFrames Number 最大截图张数(达到最大截图张数则结束截图),范围[5, 200]张,默认200张。
tag String 用于给视频附加额外信息(比如:直播客户可能传房间号,或者主播ID信息)。方便后续根据tag搜索到相关的视频。只支持一个tag参数。
timestamp Number 当前的服务器的Unix时间戳。
nonce Number 随机数。
signature String 我们采用的数字证书签名算法是:"RSA-SHA256",签名输出类型是:"base64",具体步骤如下:
1、所有参与签名的参数为:secretId,timestamp,nonce,用英文半角逗号“,”相连,得到sign_string;
2、利用您的私钥,使用算法"RSA-SHA256"签名,输出为 "base64" 格式,得到参数signature的值。

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

curl请求示例

curl -X POST --header 'Content-Type: multipart/form-data' \
-F 'video=@your_video_file_path_or_url' \
-F 'interval=1' \
-F 'maxFrames=5' \
-F 'timestamp=1559554003759' \
-F 'nonce=0.6157904536165131' \
-F 'signature=your_signature' \
'http://api.open.tuputech.com/v3/recognition/video/syncscan/your_secret_id'

请求示例

{
    "video": FILE_DATA_or_URL,
    "interval": 1,
    "maxFrames": 5,
    "timestamp": 1559554003759,
    "nonce": 0.6157904536165131,
    "signature": "p0fX2xxb5JMtN0wM7WkQRsyq/aH2zk3zYYRlBAydPmuWkofb06KdSPhq4URYHaAFU/dXodfJS9x2PbZBNz084RF0NIiJvBUcK8mFeA/YliRJnGqv2x3BiNffN61nWJirALvmjbfEWwxFArAIvsV35ivuTBO/jDueWhoxEI9Y="
}

返回参数

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

参数名称 类型 说明
[taskId] Object 识别任务的结果。
code Number 返回码,参考服务公共状态码解析
message String 返回信息。
nonce Number 随机数。
timestamp Number 当前的服务器的Unix时间戳。

taskId参数为接口开通的识别任务返回结果,分为图像或视频结果,可参考以下文档:

图像结果

视频结果

results matching ""

    No results matching ""