本文介绍视频内容检索服务视频入库的的四种方式:控制台视频新增(适用于功能体验场景)、API新增、SDK新增、批量操作(适用于视频已经存放在OSS中,且数据操作规模较大的场景)。请根据您的实际情况进行选择。

前提条件

已开通视频内容检索服务并创建实例,具体请参见开通服务

控制台方式

  1. 登录视频内容检索控制台
  2. 进入视频指纹页面,在实例列表中选择目标实例,单击实例ID或右侧的操作,进入实例详情页。视频入库-实例列表
  3. 选择页签视频入库,进入视频入库操作页。视频入库页面
    标号 功能 说明
    1 添加视频 向实例中添加视频素材,生成视频底库,作为检索范围。
    2 任务搜索 支持任务ID和视频描述对任务进行搜索,可以进行模糊检索,仅支持左匹配。
    3 任务列表 视频入库任务列表,显示入库任务的基本信息。

    视频入库任务ID:代表视频入库任务的唯一id,可凭此id通过API或SDK查询任务的详细信息。

    业务key:视频入库时指定的视频的id。此id为该视频在视频库中的唯一标识,如果存在同业务key的其他视频入库,原视频数据将被覆盖。

    视频描述:入库视频的描述信息。

    入库信息:包含首次入库和覆盖入库。当业务key在实例中不存在时,为首次入库。当业务key已经在实例中存在时,原视频数据被覆盖,入库信息为覆盖入库。

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

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

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

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

  4. 单击添加视频,根据页面提示输入参数,单击确认视频入库-添加视频
    表 1. 输入参数
    参数 说明
    视频URL地址 待入库视频的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。

    业务key 视频入库时指定的视频的id。此id为该视频在视频库中的唯一标识,如果存在同业务key的其他视频入库,原视频数据将被覆盖。
    视频描述 入库视频的描述信息,长度不超过1000个字符。
    视频标签

    与视频相关的标签信息,会和视频数据一起进行索引,可以与视频一起被搜索,并可用于查询时的条件过滤。

    支持英文、数字和下划线,最多不超过32个字符。
    完成后消息通知 任务结束时的回调URL,仅支持HTTP请求,不支持IP地址回调。
  5. 返回视频入库页面,查看视频入库结果。
    • 任务状态为已完成,单击查看结果
    • 任务状态为失败,单击失败详情,了解视频入库失败原因。
    入库结果

API方式

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

SDK方式

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

批量操作

视频内容检索服务结合阿里云OSS使用,通过简单操作即可以将存储在OSS中的视频批量导入到视频内容检索服实例中。同时也支持通过数据文件批量新增视频。适用于较大规模、离线数据操作。具体操作,请参见批量操作