全部产品
云市场
云游戏

视频查询

更新时间:2020-04-23 00:13:03

目前视频内容检索服务提供三种检索任务提交方式,通过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提交的视频查询任务也会体现在视频查询任务列表中。即该列表是一个总的任务列表并不区分查询任务提交渠道。

视频查询任务提交

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

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

    注意
    • 如果上传视频的业务key在实例中已经存在,则正在上传视频将会覆盖实例中已经存在的视频。【视频查询】列表页->【入库信息】字段将显示“覆盖入库”
    • 如果上传视频的业务key在实例中不存在,视频将正常入库,【视频查询】列表页->入库信息字段将显示“首次入库”
    • 是否进行覆盖入库,与视频本身无关,只与业务key是否已经存在有关。

  5. 视频标签:支持英文、数字和下划线,最多不超过32个字符。与视频相关的标签信息,会和视频数据一起进行索引,可以与视频一起被搜索,并可用于查询时的条件过滤。
  6. 过滤条件:表示检索结果仅在指定的标签下返回,例如只想返回“zongyi”标签下的相似视频结果,或者只想返回“zongyi”或者“tiyu”下的相似视频结果。多个过滤条件用英文“,”分隔,表示“或”关系。
  7. 查询视频的入库策略:包含“直接入库”、“去重入库”和“不入库”,表示对查询视频是否进行入库操作。
    1. 直接入库:即查询视频进行查询并直接入库。需要特别注意 ,如果查询视频的业务key,已经存在于视频库中,那查询视频将覆盖入库。
    2. 去重入库:即当检索结果中所有视频片段的置信度均小于客户设置的去重入库的阈值时,则该查询视频将被入库。需要特别注意 ,如果查询视频的业务key,已经存在于视频库中,那查询视频将覆盖入库。
    3. 不入库:查询视频不进行任何入库操作。