Queries the information about the mezzanine file of an audio or video. The information includes the mezzanine file URL, resolution, and bitrate of the audio or video.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | GetMezzanineInfo |
The operation that you want to perform. Set the value to GetMezzanineInfo. |
VideoId | String | Yes | 1f1a6fc03ca04*****814031b8a6559e |
The ID of the video. |
AuthTimeout | Long | No | 3600 |
The validity period of the mezzanine file URL. Unit: seconds. Default value: 1800. Minimum value: 1.
|
OutputType | String | No | oss |
The type of the mezzanine file URL. Valid values:
Note If the mezzanine file is stored in a bucket of the in type, only an OSS URL is returned.
|
AdditionType | String | No | video |
The type of additional information. Separate multiple values with commas (,). By default, only the basic information is returned. Valid values:
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 25818875-5F78-4A*****F6-D7393642CA58 |
The ID of the request. |
Mezzanine | Struct |
The information about the mezzanine file. |
|
AudioStreamList | Array of AudioStream |
The information about the audio stream. |
|
Bitrate | String | 62.885 |
The bitrate. |
ChannelLayout | String | mono |
The output layout of the sound channels. Valid values:
|
Channels | String | 1 |
The number of sound channels. |
CodecLongName | String | AAC (Advanced Audio Coding) |
The full name of the codec format. |
CodecName | String | aac |
The short name of the codec format. |
CodecTag | String | 0x6134706d |
The tag of the codec format. |
CodecTagString | String | mp4a |
The tag string of the codec format. |
CodecTimeBase | String | 1/44100 |
The codec time base. |
Duration | String | 3.227574 |
The duration of the audio stream. |
Index | String | 0 |
The sequence number of the audio stream, which specifies the position of the audio stream in all audio streams. |
Lang | String | und |
The language. |
NumFrames | String | 1 |
The total number of frames. |
SampleFmt | String | fltp |
The sampling format. |
SampleRate | String | 44100 |
The sample rate. |
StartTime | String | 2017-01-11T12:00:00Z |
The beginning of the time range that was queried. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC. |
Timebase | String | 0.000000 |
The time base. |
Bitrate | String | 771.2280 |
The bitrate of the file. Unit: Kbit/s. |
CreationTime | String | 2017-11-14T09:15:50Z |
The time when the file was created. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC. |
Duration | String | 42.4930 |
The duration of the file. Unit: seconds. |
FileName | String | cbf317e6c908cd1a224bd85d46978****.mp4 |
The name of the file. |
FileURL | String | http://example.com/customerTrans/e2bf0614af0254c744a6422806ad8cff/457D396A-15FB9D03164-1389-0829-084-****.mp4?Expires=1513173337&OSSAccessKeyId=LTAIJ1n*****7cAL&Signature=ngisNAr27V%2FXBtNysLbt9ebYhzU%3D |
The URL of the file. |
Fps | String | 25.0000 |
The frame rate of the file. Unit: frames per second. |
Height | Long | 540 |
The height of the file. Unit: pixel. |
OutputType | String | oss |
The type of the mezzanine file URL. Valid values:
Note If you specify an OSS URL for the video stream, the video stream must be in the MP4
format.
|
Size | Long | 4096477 |
The size of the file. Unit: byte. |
Status | String | Normal |
The status of the file. Valid values:
|
VideoId | String | 73ad78c6a6cb446*****0f24c0e24d65 |
The ID of the video. |
VideoStreamList | Array of VideoStream |
The information about the video stream. |
|
AvgFPS | String | 30.0 |
The average frame rate. |
Bitrate | String | 500 |
The bitrate of the file. Unit: Kbit/s. |
CodecLongName | String | H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 |
The full name of the codec format. |
CodecName | String | h264 |
The short name of the codec format. |
CodecTag | String | 0x31637661 |
The tag of the codec format. |
CodecTagString | String | avc1 |
The tag string of the codec format. |
CodecTimeBase | String | 1/60 |
The codec time base. |
Dar | String | 0:1 |
The display aspect ratio. |
Duration | String | 3.166667 |
The duration of the video stream. |
Fps | String | 30.0 |
The target frame rate. |
HasBFrames | String | 0 |
Indicates whether the video stream contains bidirectional frames (B-frames). |
Height | String | 320 |
The height of the video resolution. |
Index | String | 1 |
The sequence number of the video stream, which indicates the position of the video stream in all video streams. |
Lang | String | und |
The language. |
Level | String | 30 |
The codec level. |
NumFrames | String | 0 |
The total number of frames. |
PixFmt | String | yuv420p |
The pixel format. |
Profile | String | Main |
The codec profile. |
Rotate | String | 90 |
The rotation angle of the video. Valid values: [0, 360). |
Sar | String | 0:1 |
The sample aspect ratio. |
StartTime | String | 2017-01-11T12:00:00Z |
The beginning of the time range that was queried. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC. |
Timebase | String | 0.000000 |
The time base. |
Width | String | 568 |
The width of the video resolution. |
Width | Long | 960 |
The width of the file. Unit: pixel. |
Examples
Sample requests
https://vod.{ApiRegion}.aliyuncs.com/?Action=GetMezzanineInfo
&VideoId=1f1a6fc03ca04*****814031b8a6559e
&<Common request parameters>
Sample success responses
XML
format
<GetMezzanineInfoResponse>
<RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
<Mezzanine>
<Status>Normal</Status>
<VideoId>73ad78c6a6cb446*****0f24c0e24d65</VideoId>
<CRC64>461bb6d0f24c0e24d65</CRC64>
<Size>4096477</Size>
<FileName>cbf317e6c908cd1a224bd85d46978****.mp4</FileName>
<Fps>25.0000</Fps>
<Duration>42.4930</Duration>
<VideoStreamList>
<CodecTag>0x31637661</CodecTag>
<CodecTimeBase>1/60</CodecTimeBase>
<Rotate>90</Rotate>
<Sar>0:1</Sar>
<StartTime>2017-01-11T12:00:00Z</StartTime>
<Fps>30.0</Fps>
<Lang>und</Lang>
<Duration>3.166667</Duration>
<Index>1</Index>
<PixFmt>yuv420p</PixFmt>
<Bitrate>500</Bitrate>
<CodecName>h264</CodecName>
<AvgFPS>30.0</AvgFPS>
<Profile>Main</Profile>
<Timebase>0.000000</Timebase>
<HasBFrames>0</HasBFrames>
<CodecTagString>avc1</CodecTagString>
<Dar>0:1</Dar>
<CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
<Level>30</Level>
<Height>320</Height>
<NumFrames>0</NumFrames>
<Width>568</Width>
</VideoStreamList>
<AudioStreamList>
<CodecTag>0x6134706d</CodecTag>
<CodecTimeBase>1/44100</CodecTimeBase>
<ChannelLayout>mono</ChannelLayout>
<StartTime>2017-01-11T12:00:00Z</StartTime>
<Lang>und</Lang>
<Duration>3.227574</Duration>
<Index>0</Index>
<SampleFmt>fltp</SampleFmt>
<Bitrate>62.885</Bitrate>
<CodecName>aac</CodecName>
<Channels>1</Channels>
<Timebase>0.000000</Timebase>
<CodecTagString>mp4a</CodecTagString>
<SampleRate>44100</SampleRate>
<CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
<NumFrames>1</NumFrames>
</AudioStreamList>
<Bitrate>771.2280</Bitrate>
<PreprocessStatus>UnPreprocess</PreprocessStatus>
<FileURL>http://example.com/customerTrans/e2bf0614af0254c744a6422806ad8cff/457D396A-15FB9D03164-1389-0829-084-****.mp4?Expires=1513173337&OSSAccessKeyId=LTAIJ1n*****7cAL&Signature=ngisNAr27V%2FXBtNysLbt9ebYhzU%3D</FileURL>
<CreationTime>2017-11-14T09:15:50Z</CreationTime>
<Height>540</Height>
<Width>960</Width>
<OutputType>oss</OutputType>
</Mezzanine>
</GetMezzanineInfoResponse>
JSON
format
{
"RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
"Mezzanine": {
"Status": "Normal",
"VideoId": "73ad78c6a6cb446*****0f24c0e24d65",
"CRC64": "461bb6d0f24c0e24d65",
"Size": "4096477",
"FileName": "cbf317e6c908cd1a224bd85d46978****.mp4",
"Fps": "25.0000",
"Duration": "42.4930",
"VideoStreamList": [{
"CodecTag": "0x31637661",
"CodecTimeBase": "1/60",
"Rotate": "90",
"Sar": "0:1",
"StartTime": "2017-01-11T12:00:00Z",
"Fps": "30.0",
"Lang": "und",
"Duration": "3.166667",
"Index": "1",
"PixFmt": "yuv420p",
"Bitrate": "500",
"CodecName": "h264",
"AvgFPS": "30.0",
"Profile": "Main",
"Timebase": "0.000000",
"HasBFrames": "0",
"CodecTagString": "avc1",
"Dar": "0:1",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"Level": "30",
"Height": "320",
"NumFrames": "0",
"Width": "568"
}],
"AudioStreamList": [{
"CodecTag": "0x6134706d",
"CodecTimeBase": "1/44100",
"ChannelLayout": "mono",
"StartTime": "2017-01-11T12:00:00Z",
"Lang": "und",
"Duration": "3.227574",
"Index": "0",
"SampleFmt": "fltp",
"Bitrate": "62.885",
"CodecName": "aac",
"Channels": "1",
"Timebase": "0.000000",
"CodecTagString": "mp4a",
"SampleRate": "44100",
"CodecLongName": "AAC (Advanced Audio Coding)",
"NumFrames": "1"
}],
"Bitrate": "771.2280",
"PreprocessStatus": "UnPreprocess",
"FileURL": "http://example.com/customerTrans/e2bf0614af0254c744a6422806ad8cff/457D396A-15FB9D03164-1389-0829-084-****.mp4?Expires=1513173337&OSSAccessKeyId=LTAIJ1n*****7cAL&Signature=ngisNAr27V%2FXBtNysLbt9ebYhzU%3D",
"CreationTime": "2017-11-14T09:15:50Z",
"Height": "540",
"Width": "960",
"OutputType": "oss"
}
}
Error codes
For a list of error codes, visit the API Error Center.
Common errors
The following table describes the common errors that this operation can return.
Error code |
Error message |
HTTP status code |
Description |
---|---|---|---|
InvalidVideo.NotFound |
The video does not exist. |
404 |
The error message returned because the specified video ID does not exist. |
InvalidFile.NotFound |
The file does not exist. |
404 |
The error message returned because the specified video mezzanine file does not exist. |
SDK examples
We recommend that you use a server SDK to call this operation. For more information about the sample code that is used to call this operation in various languages, see the following topics: