You need to enable JavaScript to run this app.
视频点播

视频点播

Copy page
Download PDF
媒资管理
查看与管理媒资信息
Copy page
Download PDF
查看与管理媒资信息

本文档为您详细介绍如何通过控制台、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:通过控制台

视频点播控制台提供了功能丰富、操作直观的可视化界面,用于查看和管理单个视频的所有关联信息。

视频详情页

  1. 登录视频点播控制台,进入指定空间。
  2. 在视频列表中找到目标视频,单击其操作列下的详情按钮。
    Image

查看与管理基础信息

视频详情页顶部集中展示了视频的核心信息与操作。
Image

  • 支持查看视频名称、Vid、文件路径、发布状态、格式、编码格式、视频宽高、时长、码率、大小、动态范围、创建时间、分类、标签、音视频来源、描述、存储类型。

    tip

    • 文件路径:一般用于拼接视频播放地址。在同一个空间下,上传相同文件路径的媒资将会覆盖上一次上传的媒资。
    • 大小:当视频文件为 HLS 格式时,大小一行显示的是 M3U8 文件的大小。同时,还会显示 HLS 协议文件大小。HLS 协议文件大小为 M3U8 文件和所有关联的 TS 分片之和。
  • 视频预览与获取播放链接:
    • 预览:页面左侧提供播放器,支持直接预览视频内容。您可以通过单选框切换预览时使用的域名(点播加速域名产生分发费用,外网访问域名产生存储流出费用)。
    • 获取视频链接:单击复制链接按钮,即可快速获取当前视频的播放地址。
  • 视频封面:
    • 修改视频封面:单击视频封面的编辑图标,在弹出的对话框中,您可以选择以下两种方式设置封面:
      Image
      • 智能候选封面:从系统自动截取的精彩帧候选中选择一张。

        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 鉴权变更的生效时间为分钟级,变更期间生成的访问地址可能无效。
  1. 登录视频点播控制台,进入指定空间。
  2. 单击左侧导航栏视频管理素材管理
  3. 单击 DirectUrl 模式页签。
  4. 在目标文件的操作列,单击生成访问地址
  5. 在弹出的对话框中选择域名,并单击立刻生成
    Image
Last updated: 2026.03.17 14:50:26