调用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 |
返回结果中是否包含播放信息。
|
IncludeSnapshotList | Boolean | 否 | true |
返回结果中是否包含截图信息。
|
IncludeMediaInfo | Boolean | 否 | true |
返回结果中是否包含媒体信息。
|
IncludeSummaryList | Boolean | 否 | true |
返回结果中是否包含摘要。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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 |
视频审核状态。取值:
|
Tags | Array of String | tag1,tag2 |
标签列表。 |
PlayList | Array of Play |
播放列表。 |
|
Play | |||
Encryption | String | 0 |
加密。取值:
|
Height | String | 1080 |
高。 |
Bitrate | String | 2659.326 |
码率。 |
File | Object |
播放文件。 |
|
State | String | Normal |
文件状态。取值:
|
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 |
状态。取值:
|
URL | String | http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4 |
输入文件的OSS Bucket。 |
SummaryList | Array of Summary |
视频摘要列表。 |
|
Summary | |||
Type | String | Video |
摘要类型。取值:
|
MediaWorkflowId | String | 93ab850b4f6f44eab54b6e91d24d**** |
产生摘要的工作流ID。 |
ActivityName | String | example-activity-**** |
媒体工作流活动名称。 |
MediaWorkflowName | String | example-mediaworkflow-**** |
产生摘要的工作流名称。 |
File | Object |
输入文件信息。 |
|
State | String | Normal |
文件状态。范围:
|
URL | String | http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4 |
输入文件的OSS Bucket。 |
PublishState | String | Published |
媒体发布状态,表示是否对外发布媒体。取值:
|
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 |
截图类型。取值:
|
MediaWorkflowId | String | 6cc3aa66d1cb4bb2adf14e726c0a**** |
产生截图文件的工作流ID。 |
ActivityName | String | example-activity1-**** |
产生截图文件的工作流活动名称。 |
Count | String | 5 |
截图张数。此值只在Type为Sequence时有意义。 |
MediaWorkflowName | String | example-workflow-**** |
产生截图文件的工作流。 |
File | Object |
截图文件。 |
|
State | String | Normal |
文件状态。取值:
|
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"
}
错误码
访问错误中心查看更多错误码。