GetMezzanineInfo - 获取源文件信息 - 视频点播

调用GetMezzanineInfo获取音视频的源文件信息，包括文件地址、分辨率、码率等。

接口说明

使用说明

当一路视频或音频流转码完成后才可以获取到完整的源文件信息。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
VideoId	string	是	音/视频ID。可通过以下方式获取：通过控制台上传的音/视频，可登录点播控制台，选择媒资库 > 音/视频查看视频ID。通过获取视频上传地址和凭证接口获取上传地址和凭证时，音/视频ID为返回参数VideoId的值。视频上传后，可通过搜索媒体信息接口查询音/视频ID，为请求后返回参数VideoId的值。	1f1a6fc03ca04814031b8a6559e****
AuthTimeout	Long	否	FileURL（源文件地址）签名过期时间。单位：秒。默认值为1800，支持设置最小值为1。如果OutputType取值为cdn：只有开启了URL鉴权，FileURL才会定期失效，否则会永久有效。最小值：1。最大值：无限制。默认值：未设置时，取值为URL鉴权中设置的默认有效时长。如果OutputType取值为oss：只有存储权限为私有，FileURL才会定期失效，否则会永久有效。最小值：1。最大值：为降低源站安全风险，最大值为2592000（即30天）。默认值：未设置时，取值为3600。	3600
OutputType	string	否	输出地址类型。取值： oss：回源地址。 cdn（默认）：加速地址。说明当源文件所在的bucket类型为in时，只返回OSS地址。	oss
AdditionType	string	否	附加信息类型。多个使用半角逗号（,）分隔，默认只返回基本信息。取值： video：视频流信息。 audio：音频流信息。	video

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求ID。	25818875-5F78-4AF6-D7393642CA58****
Mezzanine	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
VideoId	string	视频ID。	1f1a6fc03ca04814031b8a6559e****
Height	Long	文件高度。单位：px。	540
Bitrate	string	文件码率。单位：Kbps。	771.2280
FileName	string	文件名称。	27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
OutputType	string	输出地址类型。取值范围： oss：回源地址。 cdn（默认）：加速地址。说明仅支持播放格式为MP4的OSS地址。	oss
Width	Long	文件宽度。单位：px。	960
Size	Long	文件大小。单位：Byte。	4096477
Duration	string	文件时长。单位：秒。	42.4930
Fps	string	文件帧率，每秒多少帧。	25.0000
AudioStreamList	array	音频流信息。
	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	视频流详情。
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

示例

请求示例

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=GetMezzanineInfo
&VideoId=1f1a6fc03ca04814031b8a6559e****
&AuthTimeout=3600
&OutputType=oss
&AdditionType=video
&公共请求参数

正常返回示例

JSON格式

{
    "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
    "Mezzanine": {
        "CreationTime": "2017-11-14T09:15:50Z",
        "Status": "Normal",
        "FileURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
        "VideoId": "1f1a6fc03ca04814031b8a6559e****",
        "Height": 540,
        "Bitrate": "771.2280",
        "FileName": "27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
        "OutputType": "oss",
        "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)",
                "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"
            }
        ]
    }
}

XML格式

<GetMezzanineInfoResponse>
    <RequestId>25818875-5F78-4AF6-D7393642CA58****</RequestId>
    <Mezzanine>
        <CreationTime>2017-11-14T09:15:50Z</CreationTime>
        <Status>Normal</Status>
        <FileURL>http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4</FileURL>
        <VideoId>1f1a6fc03ca04814031b8a6559e****</VideoId>
        <Height>540</Height>
        <Bitrate>771.2280</Bitrate>
        <FileName>27ffc438-164h67f57ef-0005-6884-51a-1****.mp4</FileName>
        <OutputType>oss</OutputType>
        <Width>960</Width>
        <Size>4096477</Size>
        <Duration>42.4930</Duration>
        <Fps>25.0000</Fps>
        <AudioStreamList>
            <Index>0</Index>
            <Timebase>0.000000</Timebase>
            <SampleFmt>fltp</SampleFmt>
            <SampleRate>44100</SampleRate>
            <ChannelLayout>mono</ChannelLayout>
            <Lang>und</Lang>
            <CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
            <Channels>1</Channels>
            <NumFrames>1</NumFrames>
            <Bitrate>62.885</Bitrate>
            <CodecTagString>mp4a</CodecTagString>
            <StartTime>2017-01-11T12:00:00Z</StartTime>
            <CodecName>aac</CodecName>
            <Duration>3.227574</Duration>
            <CodecTag>0x6134706d</CodecTag>
            <CodecTimeBase>1/44100</CodecTimeBase>
        </AudioStreamList>
        <VideoStreamList>
            <Timebase>0.000000</Timebase>
            <Index>1</Index>
            <AvgFPS>30.0</AvgFPS>
            <PixFmt>yuv420p</PixFmt>
            <Lang>und</Lang>
            <Sar>0:1</Sar>
            <Height>320</Height>
            <CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
            <NumFrames>0</NumFrames>
            <Bitrate>500</Bitrate>
            <Rotate>90</Rotate>
            <CodecTagString>avc1</CodecTagString>
            <HasBFrames>0</HasBFrames>
            <Profile>Main</Profile>
            <StartTime>2017-01-11T12:00:00Z</StartTime>
            <Dar>0:1</Dar>
            <CodecName>h264</CodecName>
            <Width>568</Width>
            <Duration>3.166667</Duration>
            <Fps>30.0</Fps>
            <CodecTag>0x31637661</CodecTag>
            <CodecTimeBase>1/60</CodecTimeBase>
            <Level>30</Level>
            <HDRType>HDR</HDRType>
        </VideoStreamList>
    </Mezzanine>
</GetMezzanineInfoResponse>

错误码

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

变更历史

变更时间

变更内容概要

操作

2021-11-16

OpenAPI 返回结构发生变更

变更项	变更内容
出参	OpenAPI 返回结构发生变更

接口错误码

下表列举了本接口特有的错误码。

错误代码	错误信息	HTTP 状态码	说明
InvalidVideo.NotFound	The video does not exist.	404	视频ID不存在。
InvalidFile.NotFound	The file does not exist.	404	视频文件不存在。