本文介绍视频内容检索服务检索视频的四种方式:控制台检索(适用于功能体验场景)、API检索、SDK检索(推荐方式)和批量操作。

控制台方式

  1. 登录视频内容检索控制台
  2. 进入视频指纹页面,在实例列表中选择目标实例,单击实例ID或右侧的操作,进入实例详情页。
  3. 选择页签视频检索,进入视频检索操作页。检索任务列表
    标号 功能 说明
    1 添加检索任务 添加视频检索任务,支持视频搜视频和图片搜视频两种任务类型。
    2 任务搜索 支持任务ID和描述对任务进行搜索,可以进行模糊检索,仅支持左匹配。
    3 任务列表 视频检索任务列表,包含检索任务的基本信息。

    视频检索任务ID:检索任务的唯一id,可凭此id通过API查询任务详情。

    检索类型:视频搜视频或图片搜视频。

    描述:检索任务的描述信息,在新建检索任务时填写。

    任务处理时长:任务状态处于处理中的时间长度。

    任务状态:包含排队中、处理中、已完成、失败4种状态。

    上次修改时间:记录每次任务状态变化的时间点。

    操作:支持取消任务(当任务状态为排队中时)、检索结果查看和下载(当任务状态为已完成时)、失败详情查看(当任务状态为失败时)。

  4. 单击添加检索任务,根据页面提示输入参数。
    • 视频搜视频视频搜视频
      1. 选择检索类型视频搜视频
      2. 输入视频的URL地址。

        目前支持的视频格式:avi、wmv、asf、mpeg、mpg、dat、ts、m4v、m1v、m2v、vob、mov、3gp、mts、m2ts、mkv、flv、webm、ogg、swf、mxf。

        新增或查询的视频文件需要满足最大时长不超过2小时,分辨率需小于等于1080 P,视频大小不超过1 G。视频有效帧大于1s,即纯色(黑、白、雪花)、纯字幕等特殊情况下的视频有效时长大于1s。

      3. 添加查询任务的描述,长度不超过1000个字。描述信息将在检索结果中一并输出。
      4. 选填过滤条件。

        过滤条件需与视频标签组合使用,只有在视频入库时设置了视频标签,过滤条件才有意义。添加了过滤条件后,检索任务只在带标签的视频中进行,否则默认在全量底库视频中搜索。多个过滤条件用英文逗号(,)分隔,表示“或”关系。例如:填写“zongyi”,表示仅在视频库中带有“zongyi”标签的视频中查询;填写“zongyi,tiyu”,则表示在带有“zongyi”标签或“tiyu”标签的视频中查询。

      5. 填写返回结果数,代表检索结果返回的最大相似视频数量。
      6. 选填任务结束时的回调URL,仅支持HTTP请求,不支持IP地址回调。
      7. 单击确认
    • 图片搜视频图片搜视频
      1. 选择检索类型图片搜视频
      2. 上传图片,可选择本地上传或URL上传。图片格式支持jpg,bmp,png,tiff,ppm,jpeg,webp,cwebp。
      3. 添加查询任务的描述,长度不超过1000个字。描述信息将在检索结果中一并输出。
      4. 选填过滤条件。

        过滤条件需与视频标签组合使用,只有在视频入库时设置了视频标签,过滤条件才有意义。添加了过滤条件后,检索任务只在带标签的视频中进行,否则默认在全量底库视频中搜索。多个过滤条件用英文逗号(,)分隔,表示“或”关系。例如:填写“zongyi”,表示仅在视频库中带有“zongyi”标签的视频中查询;填写“zongyi,tiyu”,则表示在带有“zongyi”标签或“tiyu”标签的视频中查询。

      5. 填写返回结果数,代表检索结果返回的最大相似视频数量。
      6. 选填任务结束时的回调URL,仅支持HTTP请求,不支持IP地址回调。
      7. 单击确认
  5. 返回视频检索页面,单击右侧查看结果,查看检索任务执行结果。结果查看
    标号 说明
    1 检索结果中的相似视频列表。

    置信度:表示相似视频中相似片段的时长占比,表示该返回视频属于相似视频的可信度。取值区间为0~100%,占比越高表示置信度越高。

    视频描述:相似视频的描述信息。

    2 相似视频列表中选中的相似视频的内容以及基本信息。
    3 相似片段详情,按照相似度降序排列:

    查询视频区间:检索任务提交的视频对应的相似片段。

    相似视频区间:检索结果中相似视频对应的相似片段。

    相似度:查询视频的片段和检索出的相似视频的片段之间的相似程度。

    4 检索任务提交的视频的基本信息。
    说明
    • 任务结果只保留30天,如需下载或查看,还请在任务分析完成后30天内完成。过期后,结果将被删除。
    • 如果检索结果视频URL失效,则无法查看视频结果。因此,如果后续还需查看任务结果,请保持入库视频URL长期有效。
    • 保证OSS已经打开了跨域访问,如未开启跨域访问,则视频无法被浏览器加载。具体操作,请参见:设置跨域访问

API方式

使用API方式创建视频检索任务,可以通过HTTP或HTTPS协议直接访问,需要按照签名机制进行身份验证,发送请求的RequestBody需要按照给定的格式进行传输。具体操作,请参见API参考。

SDK方式

视频内容检索服务提供多个版本的SDK,使用此方式,您无需关注签名验证以及RequestBody格式拼装。具体操作,请参见SDK参考。

批量操作

视频内容检索服务结合阿里云OSS使用,通过简单操作即可以批量创建检索任务。同时也支持通过数据文件批量检索。适用于较大规模、离线数据操作。具体操作,请参见批量操作