全部产品
Search
文档中心

视频点播:获取/更新媒资信息

更新时间:Feb 09, 2026

媒体文件上传完成或完成媒体处理后,就可以通过控制台或者API获取到相应媒资信息。本文为您介绍通过控制台和API/SDK获取媒资信息的方法。

场景一:通过API获取/更新

媒资信息是描述一个媒体文件的结构化数据集合。为了满足不同业务场景的需求,视频点播将媒资信息划分为以下几种类型,可以通过不同的API独立获取和更新:

信息类型

获取信息API

更新信息API

使用场景

基础信息

获取单个音视频信息

批量获取音视频信息

获取单个图片信息

修改单个音视频信息

批量修改音视频信息

批量更新图片信息

获取媒资基础信息(标题/时长/状态)用于应用展示,更新媒资属性(标题/描述/封面图/分类ID/标签)完善内容管理。

源文件信息

获取源文件信息

源文件信息是从文件本身提取的Meta信息,不支持更新。

获取上传的原始文件地址和参数,常用于存档、二次处理或问题排查。

播放信息

获取音视频播放地址

播放信息不支持更新。但可通过转码,转出新的音视频流。提交媒体转码作业

获取用于播放的地址(含鉴权),是视频播放功能的核心。

说明

推荐使用服务端SDK调用API来获取和更新媒资信息,详情请参见VOD SDK使用说明

场景二:通过控制台获取/更新

控制台提供了直观的界面来查看和管理单个媒资的详细信息,适合运营人员日常管理或开发阶段快速验证。

  1. 登录视频点播控制台

  2. 点播控制台左侧的导航栏选择媒资库,单击音/视频图片短视频素材,进入音视频、图片或短视频素材页面。

  3. 单击管理查看媒资详情。

管理

音/视频管理为例:

基础信息

可以在基础信息页签查看或修改音/视频的标题、描述、分类、标签、封面等信息。信息编辑完成后,单击保存完成配置。

基础信息

参数和说明如下表所示。

参数

说明

封面

您可以通过上传一张图片或选中某个视频截图,将其设置为默认的视频封面。

说明

可以上传自定义封面,仅支持JPG或PNG格式,最大1MB,分辨率不超过1920*1080。

名称

音/视频的名称,播放时在播放器窗口中可见,支持的长度范围为1~128个字节。

描述

音/视频的详细描述信息,支持的长度范围为0~1024个字节。

分类

可以在分类管理中,配置视频分类,详情请参见媒资分类

标签

可以对每个音/视频添加多个标签,仅支持中文、英文、数字及下划线,输入逗号、分号,或按回车键完成单个标签输入。

视频地址

可以查看当前视频的原始文件、所有转码格式和所有清晰度的详细地址,以及相应的分辨率和码率信息。

11

功能和说明如下表所示。

功能

说明

复制地址

复制当前清晰度的播放地址到浏览器或播放器中预览播放。

预览

在控制台中直接预览当前清晰度的视频。

删除

删除对应清晰度视频。

一键清除

清除全部转码后的文件(不含原始文件),清除后无法恢复,请谨慎使用。

Web播放器代码

开发者可以根据需要,针对每个视频使用HTML代码或JavaScript代码。此外,还可以通过使用播放器参数(包括播放器尺寸、是否自动播放)的快捷配置工具,快速修改代码片段中的相应参数,提高工作效率。

说明
  • 仅当媒体资源为视频时,才存在Web播放器代码页签。

  • 实际接入时请使用Web播放器的最新版本,详情请参见Web播放器

web播放器