全部产品

视频查询任务

更新时间:2020-04-23 00:19:42

视频查询任务是视频内容检索的核心功能,目前视频内容检索服务提供三种检索任务提交方式,通过API调用、SDK调用和管控台进行视频查询任务 ,推荐使用SDK调用方式。

API调用

通过 Http 或 Https 协议直接访问,需要按照给定的签名机制进行身份验证,发送请求的 RequestBody 需要按照给定的格式进行传输,详情见 API参考

SDK调用

目前提供的SDK,您不需要再关注签名验证以及 RequestBody 格式拼装等繁琐的事情,推荐使用该种方式,详情见 SDK参考

管控台操作

视频查询任务列表

点击 实例->管理->视频查询,进入视频查询列表页面

视频查询任务列表

  1. 视频查询任务列表
    • 任务ID:该视频查询任务的唯一标识
    • 业务key:由于新建查询任务时,支持客户选择入库策略,所以该业务key代表客户选择对该查询视频做入库时的唯一视频id。该视频id由客户自己维护。因为牵涉到视频入库,这个id会成为该视频在视频库中的唯一标识,如果存在同业务key的其他视频,原视频数据将被覆盖。所以,还请谨慎维护。
    • 视频文件名称:视频URL地址后缀中最后一层的视频文件名称。
    • 处理时长:该视频查询任务的处理时长。
    • 入库策略:包含“直接入库”、“去重入库”和“不入库“。表示新建视频查询任务时,用户选择的对查询视频的入库策略。
    • 入库信息:包含“不入库”、“首次入库”、“覆盖入库”和“未入库”。
      • 如果入库策略选择了 “不入库”,则视为不对查询视频进行入库处理,入库信息为“不入库”;
      • 如果入库策略选择了“直接入库”或“去重入库”,且“去重入库”满足了入库条件,并且该入库视频的业务key在实例中不存在,则该视频的入库信息为首次入库
      • 如果入库策略选择了“直接入库”或“去重入库”,且“去重入库”满足了入库条件,并且该入库的视频的业务key在实例中已经存在,则该视频的入库信息为覆盖入库
      • 如果入库策略选择了“去重入库”,且“去重入库”未达到入库条件,则该视频的入库信息为“未入库”;
        注意:该视频是否为覆盖入库与视频本身无关,只与业务key是否在实例中已经存在有关。
    • 任务状态:包含“排队中”、“处理中”、“已完成”和“失败”。其中,“排队中”的任务可以取消,任务取消后,该任务自动被删除。所以,还请谨慎取消。
    • 操作:支持结果查看和下载
  2. 添加查询任务:跳转到视频添加任务页面。
  3. 任务查询和刷新:可以按照“任务ID”、“文件名称”和“业务key”对视频新增列表进行查询。点击刷新按钮,刷新页面任务状态。
  4. 通过API或SDK提交的视频查询任务也会体现在视频查询任务列表中。即该列表是一个总的任务列表并不区分查询任务提交渠道。

视频查询任务提交

点击【添加查询任务】按钮,进入添加查询任务页面

image.png

  1. 视频地址:公测期间仅支持提交OSS URL地址。
    • 视频文件最长时长不超过3小时,分辨率小于2560*1440,视频大小不超过2G。
    • 视频文件支持格式:”.avi”,”.flv”,”.mkv”,”.mpg”,”.mp4”,”.ts”,”.mov”,”.mxf”
  2. 业务key:支持英文、数字和下划线,最多不超过32个字符。表示视频入库时视频的唯一id,由客户自己维护。因为牵涉到视频入库,这个id会成为该视频在视频库中的唯一标识,如果存在同业务key的其他视频,原视频数据将被覆盖。所以,还请谨慎维护。
    说明:

    • 如果上传视频的业务key在实例中已经存在,则正在上传视频将会覆盖实例中已经存在的视频。【视频查询】列表页->【入库信息】字段将显示“覆盖入库”
    • 如果上传视频的业务key在实例中不存在,视频将正常入库,【视频查询】列表页->入库信息字段将显示“首次入库”
    • 是否进行覆盖入库,与视频本身无关,只与业务key是否已经存在有关。
  3. 视频标签:支持英文、数字和下划线,最多不超过32个字符。与视频相关的标签信息,会和视频数据一起进行索引,可以与视频一起被搜索,并可用于查询时的条件过滤。

  4. 查询过滤条件:表示检索结果仅在指定的标签下返回,例如只想返回“zongyi”类目下的相似结果,或者只想返回“zongyi”或者“tiyu”类目下的相似结果。多个标签用英文“,”分隔,表示“或”关系。
    • 过滤条件与视频标签组合使用,只有上传了视频标签,过滤条件使用才有意义。
    • 在提交查询任务时,支持填写过滤条件,同时支持单个过滤条件和多个过滤条件,多个过滤条件用英文逗号“,”分隔,表示”或”关系。例如,填写“zongyi”,则表示仅在zongyi类目下进行结果查询;填写“zongyi,tiyu”,则表示在zongyi或tiyu类目下进行结果查询。
    • 如果未填写过滤条件,则默认在全量底库视频中搜索。
  5. 查询视频的入库策略:包含“直接入库”、“去重入库”和“不入库”,表示对查询视频是否进行入库操作。

    • 直接入库:即查询视频进行检索并直接入库。
      需要特别注意,如果查询视频的业务key,已经存在于视频库中,那查询视频将覆盖掉视频库中的原有视频。还请谨慎维护业务key。
      说明
      • 如果选择直接入库,则【视频查询】任务列表中的“入库策略”字段将显示为“直接入库”。
      • 如果查询视频的业务key未存在于视频库中,则查询视频将被直接入库,且【视频查询】任务列表中的“入库信息”字段将显示“首次入库”。
      • 如果查询视频的业务key已经存在视频库中,则视频库中的原有视频将被查询视频覆盖,【视频查询】任务列表中的“入库信息”字段将显示为“覆盖入库”。
      • 不管查询视频的业务key在实例中是否存在,只要选择“直接入库”,则查询视频都将被新增到视频库中。
    • 去重入库:即当检索结果中所有视频片段的置信度均小于客户设置的去重入库的阈值时,则该查询视频将被入库。
      需要特别注意,如果查询视频的业务key,已经存在于视频库中,那查询视频将覆盖掉视频库中的原有视频。还请谨慎维护业务key。
      说明

      • 如果选择去重入库,则【视频查询】列表中的“入库策略”字段将显示为“去重入库”。
      • 如果选择去重入库,并且设置的阈值大于检索结果中所有视频片段的置信度时,则查询视频将被入库到实例中。于此同时如果查询视频的业务key,已经存在于视频库中,则视频库中的原有视频将被查询视频覆盖,【视频查询】任务列表中的“入库信息”字段将显示“覆盖入库”。
      • 如果选择去重入库,并且设置的阈值大于检索结果中所有视频片段的置信度时,则查询视频将被入库到实例中。与此同时如果查询视频的业务key,未存在于视频库中,则查询视频将被直接入库,【视频查询】任务列表中的“入库信息”字段将显示“首次入库”。
      • 如果选择去重入库,并且设置的阈值小于检索结果中任一视频片段的置信度时,查询视频将不被入库,此时【视频查询】任务列表中的“入库信息”字段将显示“未入库”。
    • 不入库:查询视频不进行任何入库操作。且入库信息字段展示“不入库”。