全部产品

视频检索

更新时间:2020-10-12 15:52:08

本文介绍视频内容检索服务视频检索的方法。

背景信息

视频内容检索服务支持通过API、SDK(推荐方式)、控制台(适用于功能体验场景)和批量操作四种方式进行相似视频查询。

控制台方式

  1. 登录视频内容检索控制台
  2. 点击视频指纹,选择目标实例。
  3. 单击视频检索,进入视频检索任务列表。
    视频检索

详请参见 管控台介绍 > 视频检索

4.点击添加检索任务按钮。
添加任务

添加检索任务参数设置如下所示:

参数 对应API参数名称 是否必选 说明
检索类型 SearchType 视频检索类型,支持视频搜视频、图片搜视频。
视频/图片URL地址 VideoUrl 待查询的视频Url或图片Url。
说明:
对视频的要求:
- 视频格式支持:avi、wmv、asf、mpeg、mpg、dat、ts、m4v、m1v、m2v、vob、mov、3gp、mts、m2ts、mkv、flv、webm、ogg、swf、mxf
- 视频时长:<=2小时
- 视频大小:<=1G
- 视频分辨率:<=1080P
- 视频有效帧:>1s,即纯色(黑、白、雪花)、纯字幕等特殊情况下的视频有效时长大于1s
对图片的要求:
- 图片格式支持:jpg,bmp,png,tiff,ppm,jpeg,webp,cwebp
- 图片大小:<=10M
- 图片尺寸:<=4096px
视频描述/图片描述 Description 查询任务的描述信息,长度不超过1000个字。
说明
描述信息将在检索结果中一并输出。
过滤条件 QueryTags 表示检索结果仅在指定的标签下返回,与视频标签对应。
例如:填写“zongyi”,则表示仅在“zongyi”标签下进行结果查询;填写“zongyi,tiyu”,则表示在“zongyi”或“tiyu”下进行结果查询。
说明
- 过滤条件与视频标签组合使用,只有在视频入库时上传了视频标签,过滤条件的使用才有意义。
- 多个过滤条件用英文“,”分隔,表示“或”关系。
- 如果未填写过滤条件,则默认在全量底库视频中搜索。
返回结果数量 ReturnVideoNumber 检索结果返回的最大相似视频数量。
完成后消息通知 CallbackUrl 任务结束时的回调url,仅支持http请求。
说明
不支持IP地址回调。


5.查看检索结果。

结果查看
详情参见 管控台介绍 > 检索结果查看
说明:

  1. 任务结果只保留30天,如需下载或查看,还请在任务分析完成后30天内完成。过期后,结果将被删除。
  2. 如果检索结果视频URL失效,则无法查看视频结果,所以如有查看任务结果需要,还请保持入库视频URL长期有效。
  3. 保证OSS已经打开了跨域访问,如未开启跨域访问,则视频无法被浏览器加载。详情请参考:https://help.aliyun.com/document_detail/31903.html


API方式

通过HTTP或HTTPS协议直接访问,需要按照签名机制进行身份验证,发送请求的RequestBody需要按照给定的格式进行传输。更多详情请参见视频查询。

SDK方式

视频内容检索服务提供多个版本的SDK,您无需关注签名验证以及RequestBody格式拼装等繁琐的事情。更多详情请见SDK参考。

批量操作

视频内容检索服务与阿里云OSS对接,通过简单操作即可将OSS中的视频作为query视频查询相似视频。同时也支持通过数据文件进行批量查询操作。详情参见批量操作