本文档为您详细介绍如何通过控制台、OpenAPI 及服务端 SDK 等多种方式,查看和管理视频点播中的媒资信息。
什么是媒资信息
媒资信息是指一个视频上传至视频点播后,所关联的全部数据。这不仅包括您上传的原始文件,还包括转码后生成的不同清晰度版本、视频封面、字幕文件,以及由各类 AI 任务(如智能切片、人声分离等)生成的派生数据。
Vid 模式
Vid 模式下的媒资信息分类和说明如下表所示。
媒资信息类型 | 说明 | 参考文档 |
|---|
基础信息 | - 音视频元数据:包括视频 ID(Vid)、名称、描述、存储地址、发布状态、标签、分类、创建时间等。
- 素材元数据:包括素材 ID(Mid)、名称、描述、素材类型、文件格式、文件大小、创建时间等。
| 获取媒资信息接口中的 BasicInfo |
源文件信息 | 您上传的原始视频文件的信息,包括文件 ID、文件 MD5 值、文件类型、编码类型、视频宽度、视频高度、格式、时长、大小、文件地址 、清晰度、码率、帧率、存储类型等。 | 获取媒资信息接口的 SourceInfo |
播放信息 | 用于播放的 URL 列表、封面图 URL、加密信息等。 | 获取播放地址 |
派生媒资 | 由各类媒体处理任务生成的新文件或数据: - 转码产物:由转码任务生成的视频的信息,包括文件 ID、文件 MD5 值、文件类型、水印标签、是否加密、格式、时长、大小、文件地址等。
- 截图结果:由截图任务生成的图片的信息,包括截图类型、格式、图片宽高、存储地址等
- 字幕信息:由智能字幕任务生成、或您手动上传的
.vtt / .srt 字幕文件信息,包括字幕标签、格式、语言、来源、创建时间等。 - AI 元数据:由各类 AI 任务(如智能切片、人声分离等)生成的派生数据或文件。这些数据通常包含了对视频内容的深度分析结果。
- 检测修复结果:由检测修复任务产生的信息,基础检测、贴片检测、黑帧检测和水波纹检测等检测结果信息。
- 多媒体 AI:智能分类、精彩剪辑、蒙版弹幕等 AI 处理结果信息。
| |
DirectUrl 模式
DirectUrl 模式下的媒资信息包括文件路径(FileName)、文件大小、存储类型、最新修改时间等,具体请见根据文件路径获取媒资信息接口中的 VodFileMetaInfos。
管理媒资信息
视频点播支持更新视频封面、名称、分类、标签、描述等信息,不支持更新媒资的元信息,比如格式、大小、类型等。
方式 1:通过控制台
视频点播控制台提供了功能丰富、操作直观的可视化界面,用于查看和管理单个视频的所有关联信息。
视频详情页
- 登录视频点播控制台,进入指定空间。
- 在视频列表中找到目标视频,单击其操作列下的详情按钮。

查看与管理基础信息
视频详情页顶部集中展示了视频的核心信息与操作。

- 支持查看视频名称、Vid、文件路径、发布状态、格式、编码格式、视频宽高、时长、码率、大小、动态范围、创建时间、分类、标签、音视频来源、描述、存储类型。
tip
- 文件路径:一般用于拼接视频播放地址。在同一个空间下,上传相同文件路径的媒资将会覆盖上一次上传的媒资。
- 大小:当视频文件为 HLS 格式时,大小一行显示的是 M3U8 文件的大小。同时,还会显示 HLS 协议文件大小。HLS 协议文件大小为 M3U8 文件和所有关联的 TS 分片之和。
- 视频预览与获取播放链接:
- 预览:页面左侧提供播放器,支持直接预览视频内容。您可以通过单选框切换预览时使用的域名(点播加速域名产生分发费用,外网访问域名产生存储流出费用)。
- 获取视频链接:单击复制链接按钮,即可快速获取当前视频的播放地址。
- 视频封面:
- 修改视频封面:单击视频封面的编辑图标,在弹出的对话框中,您可以选择以下两种方式设置封面:

- 智能候选封面:从系统自动截取的精彩帧候选中选择一张。
warning
您需在上传视频前,在系统设置 > 上传及存储设置中开启自动生成封面候选,否则此处可能为空。
- 自定义封面:单击上传按钮,从本地选择一张图片作为视频封面。
- 获取封面图地址:单击视频封面的复制图标,即可复制封面图地址。
warning
您需要添加封面图域名后,才能复制封面图地址。具体步骤请见添加域名。
管理派生媒资信息
视频详情页底部通过页签对所有派生信息进行了分类管理。以下是核心页签的详细说明:
功能模块 | 功能说明 |
|---|
视频地址 | - 展示由转码任务生成的所有视频流文件。
- 您可以查看每个流的清晰度、格式、文件路径、编码格式、分辨率、码率等技术参数。
- 支持对特定清晰度的视频进行复制链接、预览或下载。
|
截图结果 | - 展示由截图任务生成的封面图、雪碧图或采样截图。
- 支持预览和下载图片。
|
AI 元数据 | - 展示由 ASR 提取字幕、OCR 提取字幕、人声背景音分离、智能场景切分这四个 AI 任务生成的派生数据和文件。
- 支持以下操作:
- 查看:在线预览图片或查看 JSON 文本内容。
- 下载:将派生文件下载到本地。
- 删除:删除不需要的 AI 产物(需二次确认)。
|
字幕文件 | - 管理与该视频关联的所有外挂字幕文件。
- 支持上传新的字幕文件,或对已有字幕进行下载和删除。
|
tip
控制台还提供检测修复结果(画质检测等)、多媒体 AI(智能分类、标签等)、水印贴片及视频审核结果等页签,您可以点击对应页签查看详细的处理记录和结果。
方式 2:通过 OpenAPI/服务端 SDK
通过 API,您可以程序化地批量获取或更新媒资信息,以满足自动化业务流程的需求。
获取与查询媒资信息
视频点播提供了不同粒度的 API,用于获取不同类型的媒资信息。
要获取的信息 | API | 说明 |
|---|
基础信息与转码产物 | GetMediaInfos | 一次性获取视频的基础信息 (BasicInfo)、源文件信息 (SourceInfo) 和所有转码产物信息 (TranscodeInfos)。 |
播放地址 | GetPlayInfo | 专门用于获取视频的播放地址 (PlayInfoList) 和封面地址 (PosterUrl)。 |
字幕文件列表 | GetSubtitleInfoList | 获取与指定 Vid 关联的所有外挂字幕文件的信息和 URL。 |
AI 元数据 (派生实体) | | 用于查询由 AI 任务生成的、持久化的派生媒资实体(如智能切片结果、人声分离音轨等)。 |
更新媒资信息
调用 UpdateMediaInfo 接口,可以更新视频的标题、描述、标签、分类、封面图等基础信息。
参考信息
获取 DirectUrl 模式媒资的访问地址
对于 DirectUrl 模式或仅需临时访问的场景,您也可以在控制台快速生成带鉴权的访问链接。
warning
- 获取访问地址前,请确保您已添加点播加速域名,具体请见添加并配置加速域名。
- 仅支持生成 A 类型 URL 鉴权以及关闭 URL 鉴权的域名的访问地址。域名 URL 鉴权变更的生效时间为分钟级,变更期间生成的访问地址可能无效。
- 登录视频点播控制台,进入指定空间。
- 单击左侧导航栏视频管理或素材管理。
- 单击 DirectUrl 模式页签。
- 在目标文件的操作列,单击生成访问地址。
- 在弹出的对话框中选择域名,并单击立刻生成。
