视频同步识别接口

1. 接口介绍

该接口对视频内容进行检测识别，并同步返回识别结果。

支持格式

• 视频大小限制：不超过 100M；

• 支持的格式：flv, mkv, mp4, rmvb, avi, wmv, 3gp, ts, mov, gif, m3u8, mpg/mpeg, mxf。

视频截图分辨率

如果视频的分辨率的短边超过 1024，则截取的图片以 “1024/短边” 等比例截取。

例如：视频分辨率为 1920 x 1080，截图的尺寸为 1820 x 1024。

2. 请求

2.1 请求地址

区域	请求地址
国内	http://api.video.tuputech.com/v3/recognition/video/syncscan/<secretId>
国外	http://api-us.open.tuputech.com/v3/recognition/video/syncscan/<secretId>

提示

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

2.2 请求方法

POST

2.3 请求头

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

2.4 请求参数说明

参数名称	类型	是否必需	说明
video	String / File	是	1. 支持视频链接或者上传视频文件 (上传视频文件时请求类型为 multipart/form-data)； 2. 只支持一个 video 参数，即只能传一个视频链接或者上传一个视频文件； 3. 支持常见视频格式和 gif 动图。
interval	Number	否	视频截图间隔，范围 [0.5, 60] 秒，默认 1 秒。
maxFrames	Number	否	最大截图张数（达到最大截图张数则结束截图），范围 [5, 200] 张，默认 200 张。
tag	String	否	用于给视频附加额外信息（比如：直播客户可能传房间号，或者主播 ID 信息）。方便后续根据 tag 搜索到相关的视频。只支持一个 tag 参数。
task	Array	否	指定本次调用要审核的任务。
timestamp	Number	是	当前的服务器的 Unix 时间戳。
nonce	Number	是	随机数。
signature	String	是	RSA-SHA256 算法签名。签名步骤： 将参与签名的参数（secretId，timestamp，nonce）用英文半角逗号 , 拼接，得到 SignString； 使用您的私钥以 RSA-SHA256 算法对 SignString 签名，然后进行 Base64 编码，得到 signature 字符串。 点击 数字证书 下载私钥 点击 签名及验证示例 查看签名示例

2.5 请求示例

JSON 请求

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

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'

3. 返回

3.1 公共返回结果

提示

接口返回带签名的 JSON 数据，业务数据需要用户解析 json 字段获得

参数名称	类型	说明
signature	String	响应内容签名，由图普使用私钥签名，在需要时，您可以通过 图普公钥 进行验签以确保此响应内容来自图普（与您调用接口时使用的公私钥不同）。验签步骤： 取 json 字段内容为 SignString； 将 signature 字段内容进行 Base64 解码，得到 RawSignature； 使用图普公钥以 SHA256 算法验证 RawSignature 及 SignString
json	String	响应或回调内容经过 JSON 转义后的字符串

json 参数

参数名称	类型	说明
[taskId]	Object	识别任务的结果，每个识别任务会有 全局固定不变 的 taskId 和对应数据结构，详见任务识别结果。
code	Number	返回码，参考公共状态码。
message	String	返回信息。
nonce	Number	随机数。
timestamp	Number	当前的服务器的 Unix 时间戳。

3.2 任务识别结果

视频接口的图像类任务返回结果与图片接口任务结果相同，请参看图片识别的具体任务识别结果。

语音类任务返回结果请参看语音识别的具体任务识别结果。