调用GetMezzanineInfo获取音视频的源文件信息,包括文件地址、分辨率、码率等。
接口说明
使用说明
当一路视频或音频流转码完成后才可以获取到完整的源文件信息。
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
VideoId | string | 是 | 音/视频ID。可通过以下方式获取:
| 1f1a6fc03ca04814031b8a6559e**** |
AuthTimeout | Long | 否 | FileURL(源文件地址)签名过期时间。单位:秒。默认值为1800,支持设置最小值为1。
| 3600 |
OutputType | string | 否 | 输出地址类型。取值:
说明当源文件所在的bucket类型为in时,只返回OSS地址。 | oss |
AdditionType | string | 否 | 附加信息类型。多个使用半角逗号(,)分隔,默认只返回基本信息。取值:
| video |
返回参数
示例
请求示例
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 返回结构发生变更 | |||
|
接口错误码
下表列举了本接口特有的错误码。
错误代码 | 错误信息 | HTTP 状态码 | 说明 |
---|---|---|---|
InvalidVideo.NotFound | The video does not exist. | 404 | 视频ID不存在。 |
InvalidFile.NotFound | The file does not exist. | 404 | 视频文件不存在。 |