Getting Media File Information

Terakhir diperbarui:2024-06-12 15:27:03
Overview
This API is used to get media file information.
﻿
Request
Sample request
GET /for-test.mp4?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).
Request headers
This API only uses common request headers. For more information, see Common Request Headers.
Request parameters
The parameters are as described below:
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 specific data is 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. For common error messages, see Error Codes.
Use Cases
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>
﻿
tencent cloud

Recent Pages

Getting Media File Information

Overview

Request

Sample request

Request headers

Request parameters

Request body

Response

Response headers

Response body

Error codes

Use Cases

Request

Response

Apakah halaman ini membantu?

Apakah halaman ini membantu?

Node Name (Keyword)	Parent Node	Description	Type	Required
ci-process	None	Operation type, which is fixed at `videoinfo`.	String	Yes
tencent cloud

Daftar

Login

Recent Pages

Getting Media File Information

Overview

Request

Sample request

Request headers

Request parameters

Request body

Response

Response headers

Response body

Error codes

Use Cases

Request

Response

Apakah halaman ini membantu?

Apakah halaman ini membantu?
