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

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

接口说明

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

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
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

示例

正常返回示例

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"
          }
        ]
      }
    }
  ]
}

错误码

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