调用QueryMediaList使用媒体ID查询媒体。

使用说明

本接口一次最多查询10个媒体文件。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String QueryMediaList

操作接口名,系统规定参数。取值:QueryMediaList

MediaIds String 3e1cd21131a94525be55acf65888****,e26cfa29e784402388463f61dbec****

需要查询的媒体文件ID列表,可以登录MPS控制台,通过媒体管理 > 媒体列表获取。用半角逗号(,)分隔,一次最多查询10个。

IncludePlayList Boolean true

返回结果中是否包含播放信息。

  • 取值:true(是)、false(否)。
  • 默认值:false
IncludeSnapshotList Boolean true

返回结果中是否包含截图信息。

  • 取值:true(是)、false(否)。
  • 默认值:false
IncludeMediaInfo Boolean true

返回结果中是否包含媒体信息。

  • 取值:true(是)、false(否)。
  • 默认值:false
IncludeSummaryList Boolean true

返回结果中是否包含摘要。

  • 取值:true(是)、false(否)。
  • 默认值:false

返回数据

名称 类型 示例值 描述
NonExistMediaIds Array of String {"MediaId":[e26cfa29e784402388463f61dbec****]}

不存在的媒体ID。无数据时此参数不返回。

MediaList Array of Media

媒体列表。

Media
CreationTime String 2016-09-14T08:30:33Z

创建时间。

CateId Long 1

类目ID。

Height String 1080

媒体文件高。

CensorState String Initiated

视频审核状态。取值:

  • Initiated:初始(上传成功审核未完成)。
  • Pass:通过(上传成功审核已通过)。
Tags Array of String tag1,tag2

标签列表。

PlayList Array of Play

播放列表。

Play
Encryption String 0

加密。取值:

  • 0:未加密。
  • 1:已加密。
Height String 1080

高。

Bitrate String 2659.326

码率。

File Object

播放文件。

State String Normal

文件状态。取值:

  • Normal:正常。
  • Deleted:已删除。
URL String http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4

输出文件的OSS Bucket。

MediaWorkflowId String 93ab850b4f6f44eab54b6e91d24d****

产生播放文件的工作流ID。

Width String 760

媒体文件宽。

Size String 2647692

文件大小。

Fps String 25.0

帧率。

Duration String 7.965000

时长。

ActivityName String example-activity-****

媒体工作流活动名称。

Format String mp4

编码格式。支持mov、mp4、m4a、3gp、3g2、mj2。

MediaWorkflowName String example-mediaworkflow-****

产生播放文件的工作流。

Bitrate String 2659.326

码率。

MediaId String 3e1cd21131a94525be55acf65888****

媒体ID。

File Object

输入文件详细信息。

State String Normal

状态。取值:

  • Normal:正常。
  • Deleted:已删除。
URL String http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4

输入文件的OSS Bucket。

SummaryList Array of Summary

视频摘要列表。

Summary
Type String Video

摘要类型。取值:

  • Video:视频类型。
  • Gif:动态图像类型。
MediaWorkflowId String 93ab850b4f6f44eab54b6e91d24d****

产生摘要的工作流ID。

ActivityName String example-activity-****

媒体工作流活动名称。

MediaWorkflowName String example-mediaworkflow-****

产生摘要的工作流名称。

File Object

输入文件信息。

State String Normal

文件状态。范围:

  • Normal:正常。
  • Deleted:已删除。
URL String http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4

输入文件的OSS Bucket。

PublishState String Published

媒体发布状态,表示是否对外发布媒体。取值:

  • Initiated:初始。
  • UnPublish:未发布,OSS播放文件权限为Private。
  • Published:已发布,OSS播放文件权限为Default。
  • Deleted:已删除。
MediaInfo Object

媒体信息。

Streams Object

流信息。

VideoStreamList Array of VideoStream

视频流列表。

VideoStream
Sar String 1:1

编码信号分辨率比。

Height String 1080

视频分辨率高。

CodecTagString String avc1

编码格式标记文本。

NetworkCost Object

网络带宽消耗。

PreloadTime String 0.01

预加载时间。

AvgBitrate String 2659.326

平均码率。

CostBandwidth String 100

最大消耗带宽。

Width String 100

视频分辨率宽。

Index String 5

视频流序号。标识视频流在整个媒体流中的位置。

Timebase String 1/30000

时基。

AvgFPS String 29.97003

平均帧率。

PixFmt String yuv420p

像素格式。

Lang String und

语言。更多信息,请参见FFmpeg语言定义

CodecLongName String QuickTime/MOV

编码格式长述名。

NumFrames String 12

总帧数。

Rotate String 90

视频旋转角度。

Bitrate String 2659.326

码率。

HasBFrames String 2

是否有B帧。1表示有,2表示没有。

Profile String High

编码预置。

StartTime String 0.000000

开始时间。

Dar String 16:9

编码显示分辨率比。

CodecName String mov

编码格式简述名。支持mov、mp4、m4a、3gp、3g2、mj2。

Duration String 182.683000

时长。

Fps String 29.97003

帧率。

CodecTag String 0x31637661

编码格式标记。

CodecTimeBase String 1001/60000

编码时基。

Level String 40

编码等级。

AudioStreamList Array of AudioStream

音频流列表。

AudioStream
Timebase String 1/44100

时基。

Index String 1

音频流序号,标识音频流在整个媒体流中的位置。

SampleFmt String fltp

采样格式。

ChannelLayout String stereo

声道输出样式。

Lang String und

语言。更多信息,请参见FFmpeg语言定义

Samplerate String 44100

采样率。

CodecLongName String AAC(Advanced Audio Coding)

编码格式长述名。

Channels String 2

声道数。

NumFrames String 100

总帧数。

Bitrate String 160.008

码率。

CodecTagString String mp4a

编码格式标记文本。

StartTime String 0.000000

开始时间。

CodecName String mov

编码格式简述名。支持H264、mov、aac、avc、mpeg。

Duration String 182.591995

时长。

CodecTag String 0x6134706d

编码格式标记。

CodecTimeBase String 1/44100

编码时基。

SubtitleStreamList Array of SubtitleStream

字幕流列表。

SubtitleStream
Index String 3

字幕流序号,标识字幕流在整个媒体流中的位置。

Lang String und

语言。更多信息,请参见FFmpeg语言定义

Format Object

格式信息。

StartTime String 0.000000

起始时间。

NumPrograms String 2

节目流总数。

Size String 2647692

文件大小。

NumStreams String 2

媒体流总数。

FormatLongName String QuickTime/MOV

容器/封装格式长述名。

Duration String 7.965000

总时长。

Bitrate String 2659.326

码率。

FormatName String mov

容器/封装格式简述名,支持mov,mp4,m4a,3gp,3g2,mj2。

Description String This is description ****

描述。

Size String 2647692

文件大小。

Width String 1920

宽。

CoverURL String http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png

封面的OSS Bucket。

SnapshotList Array of Snapshot

截图列表。

Snapshot
Type String Sequence

截图类型。取值:

  • Single:单张。
  • Sequence:序列。
MediaWorkflowId String 6cc3aa66d1cb4bb2adf14e726c0a****

产生截图文件的工作流ID。

ActivityName String example-activity1-****

产生截图文件的工作流活动名称。

Count String 5

截图张数。此值只在TypeSequence时有意义。

MediaWorkflowName String example-workflow-****

产生截图文件的工作流。

File Object

截图文件。

State String Normal

文件状态。取值:

  • Normal:正常。
  • Deleted:已删除。
URL String http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png

截图文件的OSS Bucket。

RunIdList Array of String {"RunId":["47b42486019c4f688bf144c1a6ba****"]}

实例ID。

Duration String 7.965000

时长。

Fps String 25.0

帧率。

Title String example-title-****

标题。

Format String mov

编码格式。支持mov,mp4,m4a,3gp,3g2,mj2。

RequestId String 283DC68C-146F-4489-A2A1-2F88F1472A56

请求ID。

示例

请求示例

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=AddMedia
&MediaIds=3e1cd21131a94525be55acf65888****,e26cfa29e784402388463f61dbec****
&IncludePlayList=true
&IncludeSnapshotList=true
&IncludeMediaInfo=true
&IncludeSummaryList=true
&<公共请求参数>

正常返回示例

XML格式

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

<QueryMediaListResponse>
    <NonExistMediaIds>{"MediaId":[e26cfa29e784402388463f61dbec****]}</NonExistMediaIds>
    <MediaList>
        <CreationTime>2016-09-14T08:30:33Z</CreationTime>
        <CateId>1</CateId>
        <Height>1080</Height>
        <CensorState>Initiated</CensorState>
        <Tags>tag1,tag2</Tags>
        <PlayList>
            <Encryption>0</Encryption>
            <Height>1080</Height>
            <Bitrate>2659.326</Bitrate>
            <File>
                <State>Normal</State>
                <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
            </File>
            <MediaWorkflowId>93ab850b4f6f44eab54b6e91d24d****</MediaWorkflowId>
            <Width>760</Width>
            <Size>2647692</Size>
            <Fps>25.0</Fps>
            <Duration>7.965000</Duration>
            <ActivityName>example-activity-****</ActivityName>
            <Format>mp4</Format>
            <MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
        </PlayList>
        <Bitrate>2659.326</Bitrate>
        <MediaId>3e1cd21131a94525be55acf65888****</MediaId>
        <File>
            <State>Normal</State>
            <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
        </File>
        <SummaryList>
            <Type>Video</Type>
            <MediaWorkflowId>93ab850b4f6f44eab54b6e91d24d****</MediaWorkflowId>
            <ActivityName>example-activity-****</ActivityName>
            <MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
            <File>
                <State>Normal</State>
                <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
            </File>
        </SummaryList>
        <PublishState>Published</PublishState>
        <MediaInfo>
            <Streams>
                <VideoStreamList>
                    <Sar>1:1</Sar>
                    <Height>1080</Height>
                    <CodecTagString>avc1</CodecTagString>
                    <NetworkCost>
                        <PreloadTime>0.01</PreloadTime>
                        <AvgBitrate>2659.326</AvgBitrate>
                        <CostBandwidth>100</CostBandwidth>
                    </NetworkCost>
                    <Width>100</Width>
                    <Index>5</Index>
                    <Timebase>1/30000</Timebase>
                    <AvgFPS>29.97003</AvgFPS>
                    <PixFmt>yuv420p</PixFmt>
                    <Lang>und</Lang>
                    <CodecLongName>QuickTime/MOV</CodecLongName>
                    <NumFrames>12</NumFrames>
                    <Rotate>90</Rotate>
                    <Bitrate>2659.326</Bitrate>
                    <HasBFrames>2</HasBFrames>
                    <Profile>High</Profile>
                    <StartTime>0.000000</StartTime>
                    <Dar>16:9</Dar>
                    <CodecName>mov</CodecName>
                    <Duration>182.683000</Duration>
                    <Fps>29.97003</Fps>
                    <CodecTag>0x31637661</CodecTag>
                    <CodecTimeBase>1001/60000</CodecTimeBase>
                    <Level>40</Level>
                </VideoStreamList>
                <AudioStreamList>
                    <Timebase>1/44100</Timebase>
                    <Index>1</Index>
                    <SampleFmt>fltp</SampleFmt>
                    <ChannelLayout>stereo</ChannelLayout>
                    <Lang>und</Lang>
                    <Samplerate>44100</Samplerate>
                    <CodecLongName>AAC(Advanced Audio Coding)</CodecLongName>
                    <Channels>2</Channels>
                    <NumFrames>100</NumFrames>
                    <Bitrate>160.008</Bitrate>
                    <CodecTagString>mp4a</CodecTagString>
                    <StartTime>0.000000</StartTime>
                    <CodecName>mov</CodecName>
                    <Duration>182.591995</Duration>
                    <CodecTag>0x6134706d</CodecTag>
                    <CodecTimeBase>1/44100</CodecTimeBase>
                </AudioStreamList>
                <SubtitleStreamList>
                    <Index>3</Index>
                    <Lang>und</Lang>
                </SubtitleStreamList>
            </Streams>
            <Format>
                <StartTime>0.000000</StartTime>
                <NumPrograms>2</NumPrograms>
                <Size>2647692</Size>
                <NumStreams>2</NumStreams>
                <FormatLongName>QuickTime/MOV</FormatLongName>
                <Duration>7.965000</Duration>
                <Bitrate>2659.326</Bitrate>
                <FormatName>mov</FormatName>
            </Format>
        </MediaInfo>
        <Description>This is descirption ****</Description>
        <Size>2647692</Size>
        <Width>1920</Width>
        <CoverURL>http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png</CoverURL>
        <SnapshotList>
            <Type>Sequence</Type>
            <MediaWorkflowId>6cc3aa66d1cb4bb2adf14e726c0a****</MediaWorkflowId>
            <ActivityName>example-activity1-****</ActivityName>
            <Count>5</Count>
            <MediaWorkflowName>example-workflow-****</MediaWorkflowName>
            <File>
                <State>Normal</State>
                <URL>http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png</URL>
            </File>
        </SnapshotList>
        <RunIdList>{"RunId":["47b42486019c4f688bf144c1a6ba****"]}</RunIdList>
        <Duration>7.965000</Duration>
        <Fps>25.0</Fps>
        <Title>example-title-****</Title>
        <Format>mov</Format>
    </MediaList>
    <RequestId>283DC68C-146F-4489-A2A1-2F88F1472A56</RequestId>
</QueryMediaListResponse>

JSON格式

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

{
  "NonExistMediaIds" : [ "{\"MediaId\":[e26cfa29e784402388463f61dbec****]}" ],
  "MediaList" : [ {
    "CreationTime" : "2016-09-14T08:30:33Z",
    "CateId" : 1,
    "Height" : "1080",
    "CensorState" : "Initiated",
    "Tags" : [ "tag1,tag2" ],
    "PlayList" : [ {
      "Encryption" : "0",
      "Height" : "1080",
      "Bitrate" : "2659.326",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
      },
      "MediaWorkflowId" : "93ab850b4f6f44eab54b6e91d24d****",
      "Width" : "760",
      "Size" : "2647692",
      "Fps" : "25.0",
      "Duration" : "7.965000",
      "ActivityName" : "example-activity-****",
      "Format" : "mp4",
      "MediaWorkflowName" : "example-mediaworkflow-****"
    } ],
    "Bitrate" : "2659.326",
    "MediaId" : "3e1cd21131a94525be55acf65888****",
    "File" : {
      "State" : "Normal",
      "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
    },
    "SummaryList" : [ {
      "Type" : "Video",
      "MediaWorkflowId" : "93ab850b4f6f44eab54b6e91d24d****",
      "ActivityName" : "example-activity-****",
      "MediaWorkflowName" : "example-mediaworkflow-****",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
      }
    } ],
    "PublishState" : "Published",
    "MediaInfo" : {
      "Streams" : {
        "VideoStreamList" : [ {
          "Sar" : "1:1",
          "Height" : "1080",
          "CodecTagString" : "avc1",
          "NetworkCost" : {
            "PreloadTime" : "0.01",
            "AvgBitrate" : "2659.326",
            "CostBandwidth" : "100"
          },
          "Width" : "100",
          "Index" : "5",
          "Timebase" : "1/30000",
          "AvgFPS" : "29.97003",
          "PixFmt" : "yuv420p",
          "Lang" : "und",
          "CodecLongName" : "QuickTime/MOV",
          "NumFrames" : "12",
          "Rotate" : "90",
          "Bitrate" : "2659.326",
          "HasBFrames" : "2",
          "Profile" : "High",
          "StartTime" : "0.000000",
          "Dar" : "16:9",
          "CodecName" : "mov",
          "Duration" : "182.683000",
          "Fps" : "29.97003",
          "CodecTag" : "0x31637661",
          "CodecTimeBase" : "1001/60000",
          "Level" : "40"
        } ],
        "AudioStreamList" : [ {
          "Timebase" : "1/44100",
          "Index" : "1",
          "SampleFmt" : "fltp",
          "ChannelLayout" : "stereo",
          "Lang" : "und",
          "Samplerate" : "44100",
          "CodecLongName" : "AAC(Advanced Audio Coding)",
          "Channels" : "2",
          "NumFrames" : "100",
          "Bitrate" : "160.008",
          "CodecTagString" : "mp4a",
          "StartTime" : "0.000000",
          "CodecName" : "mov",
          "Duration" : "182.591995",
          "CodecTag" : "0x6134706d",
          "CodecTimeBase" : "1/44100"
        } ],
        "SubtitleStreamList" : [ {
          "Index" : "3",
          "Lang" : "und"
        } ]
      },
      "Format" : {
        "StartTime" : "0.000000",
        "NumPrograms" : "2",
        "Size" : "2647692",
        "NumStreams" : "2",
        "FormatLongName" : "QuickTime/MOV",
        "Duration" : "7.965000",
        "Bitrate" : "2659.326",
        "FormatName" : "mov"
      }
    },
    "Description" : "This is descirption ****",
    "Size" : "2647692",
    "Width" : "1920",
    "CoverURL" : "http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png",
    "SnapshotList" : [ {
      "Type" : "Sequence",
      "MediaWorkflowId" : "6cc3aa66d1cb4bb2adf14e726c0a****",
      "ActivityName" : "example-activity1-****",
      "Count" : "5",
      "MediaWorkflowName" : "example-workflow-****",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png"
      }
    } ],
    "RunIdList" : [ "{\"RunId\":[\"47b42486019c4f688bf144c1a6ba****\"]}" ],
    "Duration" : "7.965000",
    "Fps" : "25.0",
    "Title" : "example-title-****",
    "Format" : "mov"
  } ],
  "RequestId" : "283DC68C-146F-4489-A2A1-2F88F1472A56"
}

错误码

访问错误中心查看更多错误码。