tencent cloud

$0 14-Day TrialExperience EdgeOne for acceleration and security protection!

Feedback

Cloud Infinite
DocumentationCloud Infinite
DocumentationCloud Infinite

Getting Media File Information

Last updated: 2024-02-28 11:21:56

Feature Description

This API (GetMediainfo) is used to get the information of a media file.


Request

Sample request

GET /<ObjectKey>?ci-process=videoinfo HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Note:
Authorization: Auth String (for more information, see Request Signature).
When this feature is used by a sub-account, relevant permissions must be granted as instructed in Authorization Granularity Details.

Request headers

This API only uses common request headers. For more information, see Common Request Headers.

Request parameters

The parameters are described as follows:
Node Name (Keyword)
Parent Node
Description
Type
Required
ci-process
None
Operation type, which is fixed at videoinfo.
String
Yes

Request body

This request does not have a request body.

Response

Response headers

This API only returns common response headers. For more information, see Common Response Headers.

Response body

The response body returns application/xml data. The following contains all the nodes:
<Response>
<MediaInfo>
<Stream>
<Video>
<Index></Index>
<CodecName></CodecName>
<CodecLongName></CodecLongName>
<CodecTimeBase></CodecTimeBase>
<CodecTagString></CodecTagString>
<CodecTag></CodecTag>
<ColorPrimaries></ColorPrimaries>
<ColorRange></ColorRange>
<ColorTransfer></ColorTransfer>
<Profile></Profile>
<Width></Width>
<Height></Height>
<HasBFrame></HasBFrame>
<RefFrames></RefFrames>
<Sar></Sar>
<Dar></Dar>
<PixFormat></PixFormat>
<FieldOrder></FieldOrder>
<Level></Level>
<Fps></Fps>
<AvgFps></AvgFps>
<Timebase></Timebase>
<StartTime></StartTime>
<Duration></Duration>
<Bitrate></Bitrate>
<NumFrames></NumFrames>
<Language></Language>
</Video>
<Audio>
<Index></Index>
<CodecName></CodecName>
<CodecLongName></CodecLongName>
<CodecTimeBase></CodecTimeBase>
<CodecTagString></CodecTagString>
<CodecTag></CodecTag>
<SampleFmt></SampleFmt>
<SampleRate></SampleRate>
<Channel></Channel>
<ChannelLayout></ChannelLayout>
<Timebase></Timebase>
<StartTime></StartTime>
<Duration></Duration>
<Bitrate></Bitrate>
<Language></Language>
</Audio>
<Subtitle>
<Index></Index>
<Language></Language>
</Subtitle>
</Stream>
<Format>
<NumStream></NumStream>
<NumProgram></NumProgram>
<FormatName></FormatName>
<FormatLongName></FormatLongName>
<StartTime></StartTime>
<Duration></Duration>
<Bitrate></Bitrate>
<Size></Size>
</Format>
</MediaInfo>
</Response>

The nodes are as described below:
Node Name (Keyword)
Parent Node
Description
Type
Response
None
Response container
Container
Response has the following sub-nodes:
Node Name (Keyword)
Parent Node
Description
Type
MediaInfo
Response
Media details.
Container
MediaInfo has the following sub-nodes:
Node Name (Keyword)
Parent Node
Description
Type
Stream
Response.MediaInfo
Stream information.
Container
Format
Response.MediaInfo
Format information.
Container
Stream has the following sub-nodes:
Node Name (Keyword)
Parent Node
Description
Type
Video
Response.MediaInfo.Stream
Video information.
Container
Audio
Response.MediaInfo.Stream
Audio information.
Container
Subtitle
Response.MediaInfo.Stream
Subtitle information.
Container
Format has the following sub-nodes (certain nodes may not be returned during video information query):
Node Name (Keyword)
Parent Node
Description
Type
NumStream
Response.MediaInfo.Format
Number of streams (including videos, audios, and subtitles).
Int
NumProgram
Response.MediaInfo.Format
Number of programs.
Int
FormatName
Response.MediaInfo.Format
Container format name.
String
FormatLongName
Response.MediaInfo.Format
Detailed name of the container format.
String
StartTime
Response.MediaInfo.Format
Start time in seconds.
Float
Duration
Response.MediaInfo.Format
Duration in seconds.
Float
Bitrate
Response.MediaInfo.Format
Bitrate in kbps.
Int
Size
Response.MediaInfo.Format
Size in bytes.
Int
Video has the following sub-nodes (certain nodes may not be returned during video information query):
Node Name (Keyword)
Parent Node
Description
Type
Index
Response.MediaInfo.Stream.Video
Stream number.
Int
CodecName
Response.MediaInfo.Stream.Video
Codec format name.
String
CodecLongName
Response.MediaInfo.Stream.Video
Detailed name of the codec format.
String
CodecTimeBase
Response.MediaInfo.Stream.Video
Codec timebase.
String
CodecTagString
Response.MediaInfo.Stream.Video
Codec tag name.
String
CodecTag
Response.MediaInfo.Stream.Video
Codec tag.
String
ColorPrimaries
Response.MediaInfo.Stream.Video
Color primaries.
String
ColorRange
Response.MediaInfo.Stream.Video
Color range.
String
ColorTransfer
Response.MediaInfo.Stream.Video
Color channel.
String
Profile
Response.MediaInfo.Stream.Video
Video codec profile.
String
Height
Response.MediaInfo.Stream.Video
Video height in px.
Int
Width
Response.MediaInfo.Stream.Video
Video width in px.
Int
HasBFrame
Response.MediaInfo.Stream.Video
Whether B-frames exist. 1: Yes; 0: No.
Int
RefFrames
Response.MediaInfo.Stream.Video
Number of reference frames for video codec.
Int
Sar
Response.MediaInfo.Stream.Video
Sample aspect ratio.
String
Dar
Response.MediaInfo.Stream.Video
Display aspect ratio.
String
PixFormat
Response.MediaInfo.Stream.Video
Pixel format.
String
FieldOrder
Response.MediaInfo.Stream.Video
Field order.
String
Level
Response.MediaInfo.Stream.Video
Video codec level.
Int
Fps
Response.MediaInfo.Stream.Video
Video frame rate.
Float
AvgFps
Response.MediaInfo.Stream.Video
Average frame rate.
String
Timebase
Response.MediaInfo.Stream.Video
Timebase.
String
StartTime
Response.MediaInfo.Stream.Video
Video start time in seconds.
Float
Duration
Response.MediaInfo.Stream.Video
Video duration in seconds.
Float
Bitrate
Response.MediaInfo.Stream.Video
Bitrate in kbps.
Float
NumFrames
Response.MediaInfo.Stream.Video
Total number of frames.
Int
Language
Response.MediaInfo.Stream.Video
Language.
String
Audio has the following sub-nodes (certain nodes may not be returned during video information query):
Node Name (Keyword)
Parent Node
Description
Type
Index
Response.MediaInfo.Stream.Audio
Stream number.
Int
CodecName
Response.MediaInfo.Stream.Audio
Codec format name.
String
CodecLongName
Response.MediaInfo.Stream.Audio
Detailed name of the codec format.
String
CodecTimeBase
Response.MediaInfo.Stream.Audio
Codec timebase.
String
CodecTagString
Response.MediaInfo.Stream.Audio
Codec tag name.
String
CodecTag
Response.MediaInfo.Stream.Audio
Codec tag.
String
SampleFmt
Response.MediaInfo.Stream.Audio
Sample format.
String
SampleRate
Response.MediaInfo.Stream.Audio
Sample rate.
Int
Channel
Response.MediaInfo.Stream.Audio
Number of channels.
Int
ChannelLayout
Response.MediaInfo.Stream.Audio
Channel layout.
String
Timebase
Response.MediaInfo.Stream.Audio
Timebase.
String
StartTime
Response.MediaInfo.Stream.Audio
Audio start time in seconds.
Float
Duration
Response.MediaInfo.Stream.Audio
Audio duration in seconds.
Float
Bitrate
Response.MediaInfo.Stream.Audio
Bitrate in kbps.
Float
Language
Response.MediaInfo.Stream.Audio
Language.
String
Subtitle has the following sub-nodes:
Node Name (Keyword)
Parent Node
Description
Type
Index
Response.MediaInfo.Stream.Subtitle
Stream number.
Int
Language
Response.MediaInfo.Stream.Subtitle
Language. und indicates no query result.
String

Error codes

There are no special error messages for this request operation. For common error messages, see Error Codes.

Samples

Request

GET /for-test.mp4?ci-process=videoinfo HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2016 09:45:46 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfG****-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=dcc1eb2022b79cb2a780bf062d3a40e120b4****
Content-Length: 0

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 666
Connection: keep-alive
Date: Fri, 10 Mar 2016 09:45:46 GMT
Server: tencent-cos
x-cos-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZmNw==



<Response>
<MediaInfo>
<Format>
<Bitrate>1014.950000</Bitrate>
<Duration>10.125000</Duration>
<FormatLongName>QuickTime / MOV</FormatLongName>
<FormatName>mov,mp4,m4a,3gp,3g2,mj2</FormatName>
<NumProgram>0</NumProgram>
<NumStream>2</NumStream>
<Size>1284547</Size>
<StartTime>0.000000</StartTime>
</Format>
<Stream>
<Audio>
<Bitrate>70.451000</Bitrate>
<Channel>1</Channel>
<ChannelLayout>mono</ChannelLayout>
<CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
<CodecName>aac</CodecName>
<CodecTag>0x6134706d</CodecTag>
<CodecTagString>mp4a</CodecTagString>
<CodecTimeBase>1/44100</CodecTimeBase>
<Duration>0.440294</Duration>
<Index>1</Index>
<Language>und</Language>
<SampleFmt>fltp</SampleFmt>
<SampleRate>44100</SampleRate>
<StartTime>0.000000</StartTime>
<Timebase>1/44100</Timebase>
</Audio>
<Subtitle/>
<Video>
<AvgFps>24/1</AvgFps>
<Bitrate>938.164000</Bitrate>
<CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
<CodecName>h264</CodecName>
<CodecTag>0x31637661</CodecTag>
<CodecTagString>avc1</CodecTagString>
<CodecTimeBase>1/12288</CodecTimeBase>
<ColorPrimaries>unknown</ColorPrimaries>
<ColorRange>unknown</ColorRange>
<ColorTransfer>unknown</ColorTransfer>
<Dar>40:53</Dar>
<Duration>0.124416</Duration>
<Fps>24.500000</Fps>
<HasBFrame>2</HasBFrame>
<Height>1280</Height>
<Index>0</Index>
<Language>und</Language>
<Level>32</Level>
<NumFrames>243</NumFrames>
<PixFormat>yuv420p</PixFormat>
<Profile>High</Profile>
<RefFrames>1</RefFrames>
<Sar>25600:25599</Sar>
<StartTime>0.000000</StartTime>
<Timebase>1/12288</Timebase>
<Width>966</Width>
</Video>
</Stream>
</MediaInfo>
</Response>


Catalog

In The Article

Getting Media File Information

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon