调用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	截图张数。此值只在Type为Sequence时有意义。
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"
}

错误码

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