BatchGetMediaInfos - 批量获取媒资信息_视频点播(VOD)-阿里云帮助中心

批量获取媒资基础信息和源文件信息。

接口说明

一次最多获取 20 个音视频的信息。
音视频上传完成后，点播会对上传完成的音视频源文件进行分析，因此媒资信息是异步生成的。可通过设置音视频分析完成的事件通知，当接收到音视频分析完成的事件通知后，再调用本接口获取音视频信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
vod:BatchGetMediaInfos	get	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
MediaIds	string	是	媒资 ID，即音/视频 ID（VideoId）。多个 ID 之间使用半角逗号（,）分隔，最多支持 20 个。可通过以下方式获取：通过控制台上传的音/视频，可登录点播控制台，选择媒资库 > 音/视频查看音/视频 ID。通过获取音视频上传地址和凭证接口获取上传地址和凭证时，为返回参数 VideoId 的值。音/视频上传后，可通过搜索媒体信息接口查询，为请求后返回参数 VideoId 的值。	61ccbdb06fa83012be4d8083f6**,7d2fbc380b0e08e55f**

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	9E290613-04F4-47F4-795D30732077****
NonExistMediaIds	array	不存在的媒资 ID 列表。
MediaId	string	不存在的媒资 ID 列表。	["bbc65bba53f6ed90de118a7849****"]
ForbiddenMediaIds	array	被禁止操作的媒资 ID 列表，通常是由于没有多应用的权限而导致被禁止操作，更多信息，请参见多应用。
MediaId	string	被禁止操作的媒资 ID 列表，通常是由于没有多应用的权限而导致被禁止操作，更多信息，请参见多应用。	["bbc65bba53f6ed90de118a7849****"]
MediaInfos	array<object>	媒资列表。
MediaBasicInfo	object	媒资列表。
MediaId	string	媒资 ID。	10a5fa364a5b71ef89246733a78e****
MediaInfo	object	媒资基础信息。
StorageLocation	string	音/视频存储地址。	outin-***.oss-cn-shanghai.aliyuncs.com
CreationTime	string	音/视频创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-11-14T09:15:50Z
Status	string	视频状态。取值： Uploading：上传中。 UploadFail：上传失败。 UploadSucc：上传完成。 Transcoding：转码中。 TranscodeFail：转码失败。 Blocked：屏蔽。 Normal：正常。	Normal
CateId	long	分类 ID。	781111****
MediaId	string	媒资 ID。	7753d144efd74d6c45fe0570****
DownloadSwitch	string	离线下载开关状态，打开离线下载功能后，则允许移动端用户通过阿里云播放器将视频缓存至本地观看。具体操作，请参见离线下载。取值： on：开启，允许离线下载。 off：关闭，禁止离线下载。	on
Tags	string	音/视频标签。多个标签之间使用半角逗号（,）分隔。	标签1, 标签2
ModificationTime	string	音/视频的最后一次更新时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-06-26T06:38:48Z
CateName	string	分类名称。	分类名称
Description	string	音/视频描述。	阿里云VOD视频描述
AppId	string	应用 ID。	app-****
CoverURL	string	音/视频封面 URL。	https://example.aliyundoc.com/****.jpg
TemplateGroupId	string	转码模板组 ID。	b4039216985f4312a5382a4ed****
Title	string	音/视频标题。	阿里云VOD视频标题
Snapshots	array	视频截图 URL 数组。
Snapshot	string	视频截图 URL 数组。说明本接口仅会返回视频的封面截图数据，通过视频截图功能截取的普通截图、雪碧截图、雪碧图原始图、WebVTT 截图的截图数据，请调用 ListSnapshots 接口查询。	["http://example.aliyundoc.com/snapshot/**.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333","http://example.aliyundoc.com/snapshot/.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27243**",...]
StorageClass	string	媒资存储类型。取值： Standard：标准。 IA：媒资低频。 Archive：媒资归档。 ColdArchive：媒资冷归档。 SourceIA：源文件低频。 SourceArchive：源文件归档。 SourceColdArchive：源文件冷归档。 Changing：媒资存储类型变更中。 SourceChanging：源文件存储类型变更中。	Standard
RestoreStatus	string	媒资解冻状态。取值： Processing：解冻中。 Success：解冻成功。 Failed：解冻失败。	Success
RestoreExpiration	string	媒资解冻有效期。	2023-03-30T10:14:14Z
UserData	string	自定义参数。	{"Extend":"xxx","MessageCallback":"xxx"}
MezzanineInfo	object	源文件信息。
CreationTime	string	文件创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-11-14T09:15:50Z
Status	string	文件状态。取值： Uploading（上传中）：文件的初始状态，表示正在上传。 Normal（正常）：文件上传成功。 UploadFail（失败）：文件上传失败。 Deleted（删除）：文件被删除。	Normal
FileURL	string	源文件地址。	http://example-bucket-**.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1**.mp4
MediaId	string	媒资 ID。	1f1a6fc03ca04814031b8a6559e****
Height	long	文件高度。单位：px。	540
Bitrate	string	文件码率。单位：Kbps。	771.2280
FileName	string	文件名称。	27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
Width	long	文件宽度。单位：px。	960
Size	long	文件大小。单位：Byte。	4096477
Duration	string	文件时长。单位：秒。	42.4930
Fps	string	文件帧率，每秒多少帧。	25.0000
AudioStreamList	array<object>	音频流信息。
AudioStream	object	音频流详情
Index	string	音频流序号，标识音频流在整个媒体流中的位置。	0
Timebase	string	时基。	0.000000
SampleFmt	string	采样格式。	fltp
SampleRate	string	采样率。	44100
ChannelLayout	string	声道输出样式。取值： mono：单声道。 stereo：双声道。	mono
Lang	string	语言。	und
CodecLongName	string	编码格式长述名。	AAC (Advanced Audio Coding)
Channels	string	声道数。	1
NumFrames	string	总帧数。	1
Bitrate	string	码率。	62.885
CodecTagString	string	编码格式标记文本。	mp4a
StartTime	string	起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-01-11T12:00:00Z
CodecName	string	编码格式简述名。	aac
Duration	string	时长。	3.227574
CodecTag	string	编码格式标记。	0x6134706d
CodecTimeBase	string	编码时基。	1/44100
VideoStreamList	array<object>	视频流信息。
VideoStream	object	视频流详情。
Timebase	string	时基。	0.000000
Index	string	视频流序号，标识视频流在整个媒体流中的位置	1
AvgFPS	string	平均帧率。	30.0
PixFmt	string	像素格式。	yuv420p
Lang	string	语言。	und
Sar	string	编码信号分辨率比。	0:1
Height	string	视频分辨率长。	320
CodecLongName	string	编码格式长述名。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
NumFrames	string	总帧数。	0
Bitrate	string	文件码率。单位：Kbps。	500
Rotate	string	视频旋转角度，取值范围：[0，360)。	90
CodecTagString	string	编码格式标记文本。	avc1
HasBFrames	string	是否有 B 帧。	0
Profile	string	编码预置。	Main
StartTime	string	起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-01-11T12:00:00Z
Dar	string	编码显示分辨率比。	0:1
CodecName	string	编码格式简述名。	h264
Width	string	视频分辨率宽。	568
Duration	string	时长。	3.166667
Fps	string	目标帧率。	30.0
CodecTag	string	编码格式标记。	0x31637661
CodecTimeBase	string	编码时基。	1/60
Level	string	编码等级。	30
HDRType	string	视频流 HDR 类型	HDR
PlayInfoList	array<object>	音/视频播放信息（流信息）。
PlayInfo	object	音/视频详细信息。
CreationTime	string	创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2022-04-18T07:37:15Z
Status	string	媒体流状态，取值： Normal：正常状态，标记的是每种清晰度和格式的一路最新转码完成的流的状态。 Invisible：不可见状态，当每种清晰度和格式有多路重复的转码流时，除了最新的一路流会被标记为正常状态，其他流会被标记为不可见状态。	Normal
Specification	string	音视频转码输出规格。各取值及描述，请参见输出规格：Specification。	H264.LD
NarrowBandType	string	转码类型。取值： 0：普通转码。 1.0：窄带高清 1.0 转码。 2.0：窄带高清 2.0 转码。	0
Height	long	媒体流高度。单位：px。	640
Bitrate	string	媒体流码率。单位：Kbps。	450.878
ModificationTime	string	更新时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2022-04-20T06:32:19Z
WatermarkId	string	当前媒体流关联的水印模板 ID。	dgfn26457856****
Encrypt	long	媒体流是否加密流，取值： 0：否。 1：是。	1
Definition	string	视频流清晰度定义。取值： FD：流畅。 LD：标清。 SD：高清。 HD：超清 OD：原画。 2K：2K。 4K：4K。 SQ：普通音质。 HQ：高音质。 AUTO：自适应码率。	LD
EncryptType	string	媒体流加密类型。取值： AliyunVoDEncryption：阿里云视频加密。 HLSEncryption：HLS 标准加密。说明如果加密类型为 AliyunVoDEncryption，则只能使用阿里云播放器 SDK 才能正常播放。	AliyunVoDEncryption
EncryptMode	string	媒体流加密模式。取值： License：本地解密模式。说明如果加密模式为 License，则只能使用阿里云播放器 SDK 才能正常播放。	License
StreamType	string	媒体流类型。若媒体流为视频则取值：video，若是纯音频则取值：audio。	video
JobId	string	媒体流转码的作业 ID。作为媒体流的唯一标识。	80e9c6580e754a798c3c19c59b16****
Size	long	媒体流大小。单位：Byte。	418112
Width	long	媒体流宽度。单位：px。	360
Fps	string	媒体流帧率。单位：帧/每秒。	25
Duration	string	媒体流长度。单位：秒。	9.0464
PlayURL	string	视频流的播放地址。	https://example.aliyundoc.com/d52ee123f331466aabf6ab32a93d**/a777f9e24e6e47a2a942467d5c38ea37-8ee8e04293c6657fdda282bc422704**.m3u8
Format	string	媒体流格式。若媒体文件为视频则取值： mp4、 m3u8。若是纯音频则取值：mp3。	m3u8
HDRType	string	媒体流 HDR 类型。取值： HDR HDR10 HLG DolbyVision HDRVivid SDR+	HLG
BitDepth	integer	颜色位深。取值为整数。	8
JobType	integer	数字水印类型。取值： 1：溯源水印。 2：版权水印。	2
JobExt	string	版权水印的自定义水印信息。仅当`JobType`为`2`时返回该字段。	CopyrightMarkTest
CodecName	string	编码格式简述名。	h264
TemplateId	string	转码模板 ID。	a86a4338dd2e83da45154004a541****
TemplateGroupId	string	转码模板组 ID。	fb0716154b21a4ecb5b70a26ccc8****

示例

正常返回示例

JSON格式

{
  "RequestId": "9E290613-04F4-47F4-795D30732077****",
  "NonExistMediaIds": [
    "[\"bbc65bba53f6ed90de118a7849****\"]"
  ],
  "ForbiddenMediaIds": [
    "[\"bbc65bba53f6ed90de118a7849****\"]"
  ],
  "MediaInfos": [
    {
      "MediaId": "10a5fa364a5b71ef89246733a78e****",
      "MediaInfo": {
        "StorageLocation": "outin-***.oss-cn-shanghai.aliyuncs.com",
        "CreationTime": "2017-11-14T09:15:50Z",
        "Status": "Normal",
        "CateId": 0,
        "MediaId": "7753d144efd74d6c45fe0570****",
        "DownloadSwitch": "on",
        "Tags": "标签1, 标签2",
        "ModificationTime": "2017-06-26T06:38:48Z",
        "CateName": "分类名称",
        "Description": "阿里云VOD视频描述",
        "AppId": "app-****",
        "CoverURL": "https://example.aliyundoc.com/****.jpg",
        "TemplateGroupId": "b4039216985f4312a5382a4ed****",
        "Title": "阿里云VOD视频标题",
        "Snapshots": [
          "[\"http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****\",\"http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27243****\",...]"
        ],
        "StorageClass": "Standard",
        "RestoreStatus": "Success",
        "RestoreExpiration": "2023-03-30T10:14:14Z",
        "UserData": "{\"Extend\":\"xxx\",\"MessageCallback\":\"xxx\"}"
      },
      "MezzanineInfo": {
        "CreationTime": "2017-11-14T09:15:50Z",
        "Status": "Normal",
        "FileURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
        "MediaId": "1f1a6fc03ca04814031b8a6559e****",
        "Height": 540,
        "Bitrate": "771.2280",
        "FileName": "27ffc438-164h67f57ef-0005-6884-51a-1****.mp4\n",
        "Width": 960,
        "Size": 4096477,
        "Duration": "42.4930",
        "Fps": "25.0000",
        "AudioStreamList": [
          {
            "Index": "0",
            "Timebase": "0.000000",
            "SampleFmt": "fltp",
            "SampleRate": "44100",
            "ChannelLayout": "mono",
            "Lang": "und",
            "CodecLongName": "AAC (Advanced Audio Coding)\n",
            "Channels": "1",
            "NumFrames": "1",
            "Bitrate": "62.885",
            "CodecTagString": "mp4a",
            "StartTime": "2017-01-11T12:00:00Z",
            "CodecName": "aac",
            "Duration": "3.227574",
            "CodecTag": "0x6134706d",
            "CodecTimeBase": "1/44100"
          }
        ],
        "VideoStreamList": [
          {
            "Timebase": "0.000000",
            "Index": "1",
            "AvgFPS": "30.0",
            "PixFmt": "yuv420p",
            "Lang": "und",
            "Sar": "0:1",
            "Height": "320",
            "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
            "NumFrames": "0",
            "Bitrate": "500",
            "Rotate": "90",
            "CodecTagString": "avc1",
            "HasBFrames": "0",
            "Profile": "Main",
            "StartTime": "2017-01-11T12:00:00Z",
            "Dar": "0:1",
            "CodecName": "h264",
            "Width": "568",
            "Duration": "3.166667",
            "Fps": "30.0",
            "CodecTag": "0x31637661",
            "CodecTimeBase": "1/60",
            "Level": "30",
            "HDRType": "HDR"
          }
        ]
      },
      "PlayInfoList": [
        {
          "CreationTime": "2022-04-18T07:37:15Z\n",
          "Status": "Normal",
          "Specification": "H264.LD",
          "NarrowBandType": "0",
          "Height": 640,
          "Bitrate": "450.878",
          "ModificationTime": "2022-04-20T06:32:19Z",
          "WatermarkId": "dgfn26457856****",
          "Encrypt": 1,
          "Definition": "LD",
          "EncryptType": "AliyunVoDEncryption",
          "EncryptMode": "License",
          "StreamType": "video",
          "JobId": "80e9c6580e754a798c3c19c59b16****",
          "Size": 418112,
          "Width": 360,
          "Fps": "25",
          "Duration": "9.0464",
          "PlayURL": "https://example.aliyundoc.com/d52ee123f331466aabf6ab32a93d****/a777f9e24e6e47a2a942467d5c38ea37-8ee8e04293c6657fdda282bc422704****.m3u8",
          "Format": "m3u8",
          "HDRType": "HLG",
          "BitDepth": 8,
          "JobType": 2,
          "JobExt": "CopyrightMarkTest",
          "CodecName": "h264",
          "TemplateId": "a86a4338dd2e83da45154004a541****",
          "TemplateGroupId": "fb0716154b21a4ecb5b70a26ccc8****"
        }
      ]
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2025-01-08	OpenAPI 返回结构发生变更	查看变更详情