Queries one or more media information analysis jobs.

Usage notes

You can call this operation to query up to 10 media information analysis jobs at a time.

QPS limit

You can call this operation up to 100 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limit.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes QueryMediaInfoJobList

The operation that you want to perform. Set the value to QueryMediaInfoJobList.

MediaInfoJobIds String Yes 23ca1d184c0e4341e5b665e2a12****

The IDs of the media information analysis jobs. Separate multiple jobs with commas (,). You can query up to 10 jobs at a time.

Response parameters

Parameter Type Example Description
NonExistMediaInfoJobIds Array of String 11ce1d184c0e4341e5b665e2a12****

The IDs of the media information analysis jobs that do not exist. If all queried job IDs exist, the response does not contain this parameter.

RequestId String 46A04AA5-B119-41BB-B750-7C5327AC3E7A

The ID of the request.

MediaInfoJobList Array of String

The returned media information analysis jobs.

MediaInfoJob
CreationTime String 2014-01-10T12:00:00Z

The time when the job was created.

State String Success

The status of the job. Valid values:

  • Analyzing: The job is being run.
  • Success: The job is successful.
  • Fail: The job fails.
JobId String 23ca1d184c0e4341e5b665e2a12****

The ID of the job.

UserData String testid-001

The custom data.

Code String InvalidParameter.JsonObjectFormatInvalid

The error code returned when the job fails.

Message String The parameter "*" does not conform to the JSON Object specification

The error message returned when the job fails.

PipelineId String 88c6ca184c0e432bbf5b665e2a15****

The ID of the ApsaraVideo Media Processing (MPS) queue to which the job is added.

Async Boolean true

Indicates whether the job is in asynchronous mode.

Input Object

The information about the job input.

Object String example.mp4

The name of the input file uploaded to the Object Storage Service (OSS) bucket.

Location String oss-cn-hangzhou

The ID of the OSS region.

Bucket String example-bucket

The name of the OSS bucket to which the input file is uploaded.

MNSMessageResult Object

The message sent by Message Service (MNS) to notify the user of the job result.

MessageId String 123

The ID of the success message. This parameter is not returned if the job fails.

ErrorMessage String The parameter \"Input\" does not conform to the JSON Object specification

The error message returned when the job fails. This parameter is not returned if the job is successful.

ErrorCode String InvalidParameter.JsonObjectFormatInvalid

The error code returned when the job fails. This parameter is not returned if the job is successful.

Properties Object

The information about the media file. For more information, see AliyunProperties.

Width String 1280

The width of the video. Unit: pixel.

Height String 720

The height of the video. Unit: pixel.

Duration String 17.226000

The duration.

Fps String 25

The frame rate.

Bitrate String 1630.045

The bitrate.

FileFormat String QuickTime/MOV

The file format.

Streams Object

The stream information.

VideoStreamList Array of VideoStream

The information about video streams.

VideoStream
Sar String 1:1

The sample aspect ratio (SAR).

Height String 1080

The latter number in the video resolution. The number indicates the video height.

CodecTagString String [0][0][0][0]

The tag string of the encoding format.

NetworkCost Object

The network bandwidth consumption.

PreloadTime String 8

The amount of preload time.

AvgBitrate String 300.34

The average bitrate.

CostBandwidth String 10

The maximum bandwidth that was consumed.

Width String 1920

The former number in the video resolution. The number indicates the video width.

Index String 1

The sequence number of the video stream. The value indicates the position of the video stream in all video streams.

Timebase String 1/1000

The time base.

AvgFPS String 24000/1001

The average frame rate.

PixFmt String yuv420p

The pixel format.

Lang String eng

The language.

CodecLongName String H.264/AVC/MPEG-4 AVC/MPEG-4 part 10

The full name of the encoding format.

NumFrames String 100

The total number of frames.

Rotate String 180

The video rotation angle.

Bitrate String 30541090

The bitrate.

HasBFrames String 0

Indicates whether the video stream contains bidirectional frames (B-frames). A value of 1 indicates that the video stream contains B-frames. A value of 0 indicates that the video stream does not contain B-frames.

Profile String High

The codec profile.

StartTime String 0.042000

The start time.

Dar String 16:9

The display aspect ratio (DAR).

CodecName String h264

The short name of the encoding format. Valid values:

  • h264
  • h265
  • gif
  • webp
Duration String 100

The duration.

Fps String 25

The frame rate.

CodecTag String 0x0000

The tag of the encoding format.

CodecTimeBase String 1001/48000

The codec time base.

Level String 41

The codec level.

ColorRange String 700

The color range.

ColorTransfer String R255 G83 B170

The color channel.

ColorPrimaries String 700

The level of color reconstruction.

AudioStreamList Array of AudioStream

The information about audio streams.

AudioStream
Timebase String 1/1000

The time base.

Index String 1

The sequence number of the audio stream. The value indicates the position of the audio stream in all audio streams.

SampleFmt String fltp

The sampling format.

ChannelLayout String 5.1(side)

The number of sound channels.

Lang String eng

The language. For more information, see FFmpeg documentation.

Samplerate String 48000

The sampling rate.

CodecLongName String DCA (DTS Coherent Acoustics)

The full name of the encoding format.

Channels String 2

The output layout of the sound channels.

NumFrames String 123

The total number of frames.

Bitrate String 1536000

The bitrate.

CodecTagString String [0][0][0][0]

The tag string of the encoding format.

StartTime String 0.042000

The start time.

CodecName String acc

The short name of the encoding format. Valid values:

  • acc
  • mp3
  • mp4
  • ogg
  • flac
Duration String 123

The duration.

CodecTag String 0x0000

The tag of the encoding format.

CodecTimeBase String 1/48000

The codec time base.

SubtitleStreamList Array of SubtitleStream

The information about subtitle streams.

SubtitleStream
Timebase String 1/1000

The time base.

Index String 3

The sequence number of the subtitle stream. The value indicates the position of the subtitle stream in all subtitle streams.

StartTime String 0.000000

The start time.

CodecName String ass

The short name of the encoding format. Valid values:

  • srt
  • ass
Lang String eng

The language.

CodecLongName String ASS (Advanced SSA) subtitle

The full name of the encoding format.

Duration String 1370.116000

The duration. Unit: seconds.

CodecTag String 0x0000

The tag of the encoding format.

CodecTimeBase String 0/1

The codec time base.

CodecTagString String [0][0][0][0]

The tag string of the encoding format.

Format Object

The format information.

StartTime String 0.042000

The start time.

NumPrograms String 2

The total number of program streams.

Size String 3509895

The size of the file.

NumStreams String 1

The total number of media streams.

FormatLongName String QuickTime/MOV

The full name of the container format.

Duration String 17.226000

The total duration.

Bitrate String 1630.045

The total bitrate.

FormatName String mov

The short name of the container format.

FileSize String 3509895

The size of the file.

Examples

Sample requests

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryMediaInfoJobList
&MediaInfoJobIds=23ca1d184c0e4341e5b665e2a12****
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<QueryMediaInfoJobListResponse>
    <NonExistMediaInfoJobIds>11ce1d184c0e4341e5b665e2a12****</NonExistMediaInfoJobIds>
    <RequestId>46A04AA5-B119-41BB-B750-7C5327AC3E7A</RequestId>
    <MediaInfoJobList>
        <CreationTime>2014-01-10T12:00:00Z</CreationTime>
        <State>Success</State>
        <JobId>23ca1d184c0e4341e5b665e2a12****</JobId>
        <UserData>testid-001</UserData>
        <PipelineId>88c6ca184c0e432bbf5b665e2a15****</PipelineId>
        <Async>true</Async>
        <Input>
            <Object>example.mp4</Object>
            <Location>oss-cn-hangzhou</Location>
            <Bucket>example-bucket</Bucket>
        </Input>
        <MNSMessageResult>
            <MessageId>123</MessageId>
        </MNSMessageResult>
        <Properties>
            <Width>1280</Width>
            <Height>720</Height>
            <Duration>17.226000</Duration>
            <Fps>25</Fps>
            <Bitrate>1630.045</Bitrate>
            <FileFormat>QuickTime/MOV</FileFormat>
            <Streams>
                <VideoStreamList>
                    <Sar>1:1</Sar>
                    <Height>1080</Height>
                    <CodecTagString>[0][0][0][0]</CodecTagString>
                    <NetworkCost>
                        <PreloadTime>8</PreloadTime>
                        <AvgBitrate>300.34</AvgBitrate>
                        <CostBandwidth>10</CostBandwidth>
                    </NetworkCost>
                    <Width>1920</Width>
                    <Index>1</Index>
                    <Timebase>1/1000</Timebase>
                    <AvgFPS>24000/1001</AvgFPS>
                    <PixFmt>yuv420p</PixFmt>
                    <Lang>eng</Lang>
                    <CodecLongName>H.264/AVC/MPEG-4 AVC/MPEG-4 part 10</CodecLongName>
                    <NumFrames>100</NumFrames>
                    <Rotate>180</Rotate>
                    <Bitrate>30541090</Bitrate>
                    <HasBFrames>0</HasBFrames>
                    <Profile>High</Profile>
                    <StartTime>0.042000</StartTime>
                    <Dar>16:9</Dar>
                    <CodecName>h264</CodecName>
                    <Duration>100</Duration>
                    <Fps>25</Fps>
                    <CodecTag>0x0000</CodecTag>
                    <CodecTimeBase>1001/48000</CodecTimeBase>
                    <Level>41</Level>
                    <ColorRange>700</ColorRange>
                    <ColorTransfer>R255 G83 B170</ColorTransfer>
                    <ColorPrimaries>700</ColorPrimaries>
                </VideoStreamList>
                <AudioStreamList>
                    <Timebase>1/1000</Timebase>
                    <Index>1</Index>
                    <SampleFmt>fltp</SampleFmt>
                    <ChannelLayout>5.1(side)</ChannelLayout>
                    <Lang>eng</Lang>
                    <Samplerate>48000</Samplerate>
                    <CodecLongName>DCA (DTS Coherent Acoustics)</CodecLongName>
                    <Channels>2</Channels>
                    <NumFrames>123</NumFrames>
                    <Bitrate>1536000</Bitrate>
                    <CodecTagString>[0][0][0][0]</CodecTagString>
                    <StartTime>0.042000</StartTime>
                    <CodecName>acc</CodecName>
                    <Duration>123</Duration>
                    <CodecTag>0x0000</CodecTag>
                    <CodecTimeBase>1/48000</CodecTimeBase>
                </AudioStreamList>
                <SubtitleStreamList>
                    <Timebase>1/1000</Timebase>
                    <Index>3</Index>
                    <StartTime>0.000000</StartTime>
                    <CodecName>ass</CodecName>
                    <Lang>eng</Lang>
                    <CodecLongName>ASS (Advanced SSA) subtitle</CodecLongName>
                    <Duration>1370.116000</Duration>
                    <CodecTag>0x0000</CodecTag>
                    <CodecTimeBase>0/1</CodecTimeBase>
                    <CodecTagString>[0][0][0][0]</CodecTagString>
                </SubtitleStreamList>
            </Streams>
            <Format>
                <StartTime>0.042000</StartTime>
                <NumPrograms>2</NumPrograms>
                <Size>3509895</Size>
                <NumStreams>1</NumStreams>
                <FormatLongName>QuickTime/MOV</FormatLongName>
                <Duration>17.226000</Duration>
                <Bitrate>1630.045</Bitrate>
                <FormatName>mov</FormatName>
            </Format>
            <FileSize>3509895</FileSize>
        </Properties>
    </MediaInfoJobList>
</QueryMediaInfoJobListResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
    "NonExistMediaInfoJobIds": [
        "11ce1d184c0e4341e5b665e2a12****"
    ],
    "RequestId": "46A04AA5-B119-41BB-B750-7C5327AC3E7A",
    "MediaInfoJobList": [
        {
            "CreationTime": "2014-01-10T12:00:00Z",
            "State": "Success",
            "JobId": "23ca1d184c0e4341e5b665e2a12****",
            "UserData": "testid-001",
            "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
            "Async": true,
            "Input": {
                "Object": "example.mp4",
                "Location": "oss-cn-hangzhou",
                "Bucket": "example-bucket"
            },
            "MNSMessageResult": {
                "MessageId": "123",
            },
            "Properties": {
                "Width": "1280",
                "Height": "720",
                "Duration": "17.226000",
                "Fps": "25",
                "Bitrate": "1630.045",
                "FileFormat": "QuickTime/MOV",
                "Streams": {
                    "VideoStreamList": [
                        {
                            "Sar": "1:1",
                            "Height": "1080",
                            "CodecTagString": "[0][0][0][0]",
                            "NetworkCost": {
                                "PreloadTime": "8",
                                "AvgBitrate": "300.34",
                                "CostBandwidth": "10"
                            },
                            "Width": "1920",
                            "Index": "1",
                            "Timebase": "1/1000",
                            "AvgFPS": "24000/1001",
                            "PixFmt": "yuv420p",
                            "Lang": "eng",
                            "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
                            "NumFrames": "100",
                            "Rotate": "180",
                            "Bitrate": "30541090",
                            "HasBFrames": "0",
                            "Profile": "High",
                            "StartTime": "0.042000",
                            "Dar": "16:9",
                            "CodecName": "h264",
                            "Duration": "100",
                            "Fps": "25",
                            "CodecTag": "0x0000",
                            "CodecTimeBase": "1001/48000",
                            "Level": "41",
                            "ColorRange": "700",
                            "ColorTransfer": "R255 G83 B170",
                            "ColorPrimaries": "700"
                        }
                    ],
                    "AudioStreamList": [
                        {
                            "Timebase": "1/1000",
                            "Index": "1",
                            "SampleFmt": "fltp",
                            "ChannelLayout": "5.1(side)",
                            "Lang": "eng",
                            "Samplerate": "48000",
                            "CodecLongName": "DCA (DTS Coherent Acoustics)",
                            "Channels": "2",
                            "NumFrames": "123",
                            "Bitrate": "1536000",
                            "CodecTagString": "[0][0][0][0]",
                            "StartTime": "0.042000",
                            "CodecName": "acc",
                            "Duration": "123",
                            "CodecTag": "0x0000",
                            "CodecTimeBase": "1/48000"
                        }
                    ],
                    "SubtitleStreamList": [
                        {
                            "Timebase": "1/1000",
                            "Index": "3",
                            "StartTime": "0.000000",
                            "CodecName": "ass",
                            "Lang": "eng",
                            "CodecLongName": "ASS (Advanced SSA) subtitle",
                            "Duration": "1370.116000",
                            "CodecTag": "0x0000",
                            "CodecTimeBase": "0/1",
                            "CodecTagString": "[0][0][0][0]"
                        }
                    ]
                },
                "Format": {
                    "StartTime": "0.042000",
                    "NumPrograms": "2",
                    "Size": "3509895",
                    "NumStreams": "1",
                    "FormatLongName": "QuickTime/MOV",
                    "Duration": "17.226000",
                    "Bitrate": "1630.045",
                    "FormatName": "mov"
                },
                "FileSize": "3509895"
            }
        }
    ]
}

Error codes

For a list of error codes, visit the API Error Center.