You need to enable JavaScript to run this app.
文档中心
视频点播

视频点播

复制全文
下载 pdf
媒资管理
下载媒体文件
复制全文
下载 pdf
下载媒体文件

视频点播服务支持将存储于视频点播中的媒体文件下载至本地磁盘或其他存储设备,提供控制台批量下载、服务端 API 调用或客户端 SDK 实现等多种下载方式。本文详细介绍可下载文件类型、下载地址获取方式及不同下载路径的操作指南。

可下载的媒体文件类型

使用视频点播服务时会产生多种可下载的媒体文件,分类如下:

  • 音视频源文件:用户上传至视频点播的源文件。
  • 转码产物:用户通过视频点播媒体处理服务转码生成的流文件(某个清晰度)。
  • 视频截图:用户通过视频点播媒体处理服务截图生成的图片。

下载地址类型

用户可获取的媒体文件下载地址,通常为存储地址或加速地址。

  • 若您未在视频点播服务中配置加速域名,各媒体文件的下载地址统一为存储地址。从存储地址下载媒体文件会产生存储流出费用。
  • 若您在视频点播服务中配置了加速域名,各媒体文件的下载地址统一为加速地址。从加速地址下载媒体文件会产生分发加速计费。

常见地址和标识的区别如下:

名称含义常见用途
Vid视频点播生成的视频 ID用于调用 GetPlayInfo 获取播放地址,或在控制台 Vid 模式下管理视频。
FileName文件在点播存储中的路径常见于 DirectUrl 模式、AI 任务结果或派生文件结果,可用于定位文件或拼接访问 URL。
DirectUrl直接文件地址或文件路径模式适用于按文件路径管理、访问或处理媒资的场景。
播放地址用于在线播放的 URL通常通过点播加速域名访问,访问时可能产生分发加速费用。
下载地址用于下载文件的 URL根据使用的域名类型,可能产生存储流出费用或分发加速费用。

说明

如果您通过 AI 任务、媒体处理任务或 API 返回结果获取到 FileName,通常需要先确认产物所在空间是否已配置点播加速域名,再基于加速域名和 FileName 拼接访问地址,或调用相关查询接口获取 Vid 后再获取播放地址。

下载限制

若您启用了防盗链配置、视频加密等功能,即便获取到媒体文件的下载地址,下载媒体后仍可能面临相同的使用限制。具体说明如下:

  • 若为加速域名配置了 URL 鉴权,地址将在一段时间后失效,届时需重新获取,建议设置较长的有效期。
  • 若为加速域名配置了访问限制,通过加速地址下载,将受到配置的 Refer 黑名单、IP 黑名单等策略的限制,这与在线播放的情况一致;通过存储地址下载,则不受此限制。
  • 若使用视频加密,无论通过何种方式下载,得到的转码输出产物仍为加密文件,需解密后才能播放。更多信息,请参见 HLS 标准加密和火山引擎私有加密。

直接从控制台批量下载音视频

注意

  • 从控制台下载使用外网访问域名,会产生存储流出费用。
  • 对于 HLS 协议视频,仅支持下载 M3U8 文件,无法关联下载 TS 分片。

下载音视频源文件

  1. 登录视频点播控制台,进入指定空间。

  2. 在视频管理页面 Vid 模式和已上传页签下,勾选需要下载的视频文件,单击下载按钮。

  3. 在下载视频弹窗中,确认您勾选的视频是否可下载。

    说明

    若视频状态显示为无法下载,请参考以下思路排查:

    • 检查视频是否已发布。
    • 前往上传存储设置页面的存储设置页签,检查默认存储是否为点播存储。目前仅支持下载存储于点播存储中的媒资。
  4. 确认无误后,单击确认下载。浏览器将开始下载操作。

下载转码产物

  1. 登录视频点播控制台,进入指定空间。
  2. 在视频管理页面,单击目标视频操作列的详情按钮,进入视频详情页面。
  3. 在视频地址页签下,勾选需要下载的转码产物,单击下载按钮。
    Image
  4. 在下载视频弹窗中,确认您勾选的视频是否可下载。

    说明

    若视频状态显示为无法下载,请参考以下思路排查:

    • 检查视频是否已发布。
    • 前往上传存储设置页面的存储设置页签,检查默认存储是否为点播存储。目前仅支持下载存储于点播存储中的媒资。
  5. 确认无误后,单击确认下载。浏览器将开始下载操作。

获取下载地址

注意

获取下载地址前,请确保您已配置点播加速域名或封面加速域名。具体请见添加域名。

通过控制台获取

  • 获取音视频源文件的下载地址:
    1. 登录视频点播控制台,进入指定空间。
    2. 在视频管理页面 Vid 模式和已上传页签下,单击目标视频操作列的复制链接按钮,即可获取下载地址。
  • 获取转码产物的下载地址:
    1. 登录视频点播控制台,进入指定空间。
    2. 在视频管理页面,单击目标视频操作列的详情按钮,进入视频详情页面。
    3. 在视频地址页签下,单击目标清晰度的复制链接按钮,即可获取该清晰度视频的下载地址。
  • 获取视频截图的下载地址:
    1. 登录视频点播控制台,进入指定空间。
    2. 在视频管理页面,单击目标视频操作列的详情按钮,进入视频详情页面。
    3. 在截图结果页签下,单击目标截图的复制链接按钮,即可获取该图片的下载地址。

通过 OpenAPI/服务端 SDK 获取

  • 获取音视频源文件和转码产物的下载地址:调用 GetPlayInfo 接口并将 NeedOriginal 设为 1,返回结果 PlayInfoList 对象中的 MainPlayUrl 字段即为音视频的下载地址。
  • 获取视频截图的下载地址:调用 ListSnapshots 接口,返回结果中的 Url 字段即为截图的下载地址。

客户端下载

针对移动端的使用场景,视频点播播放器 SDK 提供视频下载功能。您可以根据业务需要实现下载功能,允许终端用户在有网络的条件下将视频下载至本地,以便后续在无网络环境下观看。详见以下文档:

最近更新时间:2026.09.07 15:02:30
这个页面对您有帮助吗?
有用
有用
无用
无用