本文提供了调用视频指纹检索任务的具体内容,旨在帮助您编写程序构建HTTP调用请求。

  • 关于如何构造HTTP请求,请参考请求结构
  • 您也可以直接选用已构造好的HTTP请求,具体请参考SDK参考

描述

业务接口/green/video/asyncscan
说明 目前视频指纹检索功能的 endpoint仅支持 cn-shanghai

调用本接口在指定视频分组中检索与待检测视频相似的视频。

该接口为异步接口,提交检索任务后,您可以通过返回的taskId,调用查询视频指纹检索结果获取检索结果。

关于视频的限制
  • 视频文件链接支持以下协议:HTTP和HTTPS。
  • 视频文件支持以下格式:.avi、.flv、.mp4、.mpg、.asf、.wmv、.mov、.wma、.rmvb、.rm、.flash、.mid。
  • 视频大小限制:单个视频大小不超过200MB。如您有特殊需求(大视频),可以提工单进行调整。
  • 视频检测的时间依赖于视频的下载时间。请保证被检测的视频文件所在的存储服务稳定可靠,建议您使用阿里云OSS存储服务存储视频文件。

请求参数

关于在请求中必须包含的公共请求参数,请参考公共参数

请求body是一个JSON对象,字段说明如下:
名称 类型 是否必需 描述
bizType 字符串 自定义业务类型,由业务方提供。
每个bizType对应不同的算法/模型,运维人员可以为某一bizType动态地增加、删除要检测的风险场景。通过配置,后端根据该字段对请求做不同处理。
说明 该字段优先级高于 scenes字段。
scenes 字符串数组 指定检测场景,视频指纹检索场景的取值:video-dna
callback 字符串 异步检测结果回调通知您的URL,支持HTTP/HTTPS。
说明 如果该字段为空,则您必须定时检索检测结果。
seed 字符串 回调通知请求中的签名。
说明 传入 callback时,也必须传入该字段。
tasks JSON数组 指定检测任务列表。JSON数组中的每个元素是一个结构体,具体结构见video
表 1. video
名称 类型 是否必需 描述
clientInfo JSON结构体 客户端信息,参考公共参数中的公共查询参数。
服务器会把全局的 clientInfo和此处独立的 clientInfo合并。
说明 独立的 clientInfo优先级更高。
dataId 字符串 待检测数据的ID。您需要保证在一次请求中,所有的dataId不重复。
url 字符串 待检测视频的地址。
extras map 待检测的视频分组的groupId,指定从该视频分组中检测相似视频。
time 整形 待检测视频的创建/编辑时间。
length 整形 待检测视频的长度,单位为秒。

返回参数

返回结果说明,参见返回结果

返回body中的data字段是JSON数组,每一个元素包含如下字段:
名称 类型 是否必需 描述
taskId 字符串 该检测任务的ID。
dataId 字符串 对应请求中的dataId
url 字符串 对应请求中的url

示例

请求示例
{
  "scenes":["video-dna"],
  "tasks":[
    {
      "dataId":"videoId xxx",
      "time":1475556078881,
      "url":"http://xxx.xxxx.mp4",
	  "extras":[
	    "groupId":"group1"
	  ]
    }
  ]
}
返回示例
{
  "code":200,
  "msg":"OK",
  "requestId":"requestID xxx",
  "data":[
    {
      "dataId":"videoId xxx",
      "taskId":"taskId xxx"
    }
  ]
}