查询媒体-使用OSS文件地址 - 媒体处理

使用说明

本接口一次最多查询10个媒体文件。
调用本接口前，请先调用新增媒体接口新增媒体文件，再调用本接口查询媒体信息。
新上传的媒体文件，需要工作流执行完成后，通过本接口获取的文件信息才会完整。

QPS限制

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

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	QueryMediaListByURL	操作接口名，系统规定参数。取值：QueryMediaListByURL。
FileURLs	String	是	http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example.mp4	需要查询的媒体文件地址，可以登录MPS控制台，通过媒体管理 > 媒体列表找到需要查询的媒体文件，单击操作列管理，在获取转码地址页签中获取媒体文件地址。用半角逗号（,）分隔，一次最多查询10个。 URL遵循RFC 3986（UTF8编码，并对保留字符进行URLEncode。更多信息，请参见URLEncode说明），不超过3200字节。仅支持OSS HTTP地址，不支持CDN地址和HTTPS地址。
IncludePlayList	Boolean	否	true	返回结果中是否包含播放信息。取值范围：true（包含）、false（不包含）。默认值：false。
IncludeSnapshotList	Boolean	否	true	返回结果中是否包含截图信息。取值范围：true（包含）、false（不包含）。默认值：false。
IncludeMediaInfo	Boolean	否	true	返回结果中是否包含媒体信息。取值范围：true（包含）、false（不包含）。默认值：false。说明如需获取详细MediaInfo信息，请将本参数设置为true。
IncludeSummaryList	Boolean	否	true	返回结果中是否包含摘要列表。取值范围：true（是）、false（否）。默认值：false。

返回数据


名称	类型	示例值	描述
MediaList	Array of Media		媒体列表。
Media
CreationTime	String	2021-07-14T13:05:00Z	创建时间。
CateId	Long	123	类目ID。
Height	String	360	查询到的媒体文件的高。
CensorState	String	Initiated	视频审核状态。取值： Initiated：初始（上传成功审核未完成）。 Pass：通过（上传成功审核已通过）。
Tags	Array of String	tag1,tag2	标签列表。
PlayList	Array of Play		播放列表。
Play
Encryption	String	1	加密。取值： 0：未加密。 1：已加密。
Height	String	10	高。
Bitrate	String	25.067	码率。
File	Object		播放文件。
State	String	Normal	文件状态。取值范围： Normal：正常。 Deleted：已删除。
URL	String	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4l-test/in/1.mp4	播放文件的输入OSS Bucket。
MediaWorkflowId	String	6cc3aa66d1cb4bb2adf14e726c0a****	产生播放文件的工作流ID。
Width	String	11	宽。
Size	String	100	大小。
Fps	String	25.0	帧率。
Duration	String	7.965000	时长。
ActivityName	String	test name	媒体工作流活动名称。
Format	String	mov	编码格式。支持mov、mp4、m4a、3gp、3g2、mj2。
MediaWorkflowName	String	example-mediaworkflow-****	产生播放文件的工作流。
Bitrate	String	593.192	码率。
MediaId	String	52d7e98b05e648199612290bb819****	媒体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	Gif	摘要类型。取值范围： 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-****.o	输入文件的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	360	视频分辨率高。
CodecTagString	String	avc1	编码格式标记文本。
NetworkCost	Object		网络带宽消耗。
PreloadTime	String	0.01	预加载时间。
AvgBitrate	String	2659.326	平均码率。
CostBandwidth	String	100	最大消耗带宽。
Width	String	640	视频分辨率宽，数字，不能为负数。
Index	String	5	视频流序号，标识视频流在整个媒体流中的位置。
Timebase	String	1/15360	时基。
AvgFPS	String	15.0	平均帧率。
PixFmt	String	yuv420p	像素格式。
Lang	String	und	语言。更多信息，请参见FFmpeg语言定义。
CodecLongName	String	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10	编码格式长述名。
NumFrames	String	12	总帧数。
Rotate	String	90	视频旋转角度。
Bitrate	String	512.701	码率。
HasBFrames	String	2	是否有B帧。1表示有，2表示没有。
Profile	String	High	编码预置。
StartTime	String	0.046029	起始时间。
Dar	String	16:9	编码显示分辨率比。
CodecName	String	H264	编码格式简述名。支持H264、mov、aac、avc、mpeg。
Duration	String	79.200000	时长。
Fps	String	15.0	帧率。
CodecTag	String	0x31637661	编码格式标记。
CodecTimeBase	String	1/30	编码时基。
Level	String	31	编码等级。
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	76.356	码率。
CodecTagString	String	mp4a	编码格式标记文本。
StartTime	String	0.000000	起始时间。
CodecName	String	aac	编码格式简述名。支持H264、mov、aac、avc、mpeg。
Duration	String	79.203265	时长。
CodecTag	String	0x6134706d	编码格式标记。
CodecTimeBase	String	1/44100	编码时基。
SubtitleStreamList	Array of SubtitleStream		字幕流列表。
SubtitleStream
Index	String	1	字幕流序号，标识字幕流在整个媒体流中的位置。
Lang	String	und	语言。参考FFmpeg语言定义。
Format	Object		格式信息。
StartTime	String	0.000000	开始时间。
NumPrograms	String	0	节目流总数。
Size	String	5872904	大小。
NumStreams	String	2	媒体流总数。
FormatLongName	String	QuickTime/MOV	编码格式长述名。
Duration	String	79.204000	时长。
Bitrate	String	593.192	码率。
FormatName	String	mov	容器/封装格式简述名，支持mov，mp4，m4a，3gp，3g2，mj2。
Description	String	This is description ****	描述。
Size	String	5872904	文件大小。
Width	String	640	宽。
CoverURL	String	http://example-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example-**.png	封面的OSS Bucket。
SnapshotList	Array of Snapshot		截图列表。
Snapshot
Type	String	Single	截图类型。取值范围： Single：单张。 Sequence：序列。
MediaWorkflowId	String	6cc3aa66d1cb4bb2adf14e726c0a****	产生截图文件的工作流ID。
ActivityName	String	example-activity1-****	产生截图文件的工作流活动名称。
Count	String	3	截图张数。此值只在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	9343bd0e7bb54ae19228529908e5****	媒体工作流ID列表。
Duration	String	79.204000	时长。
Fps	String	15.0	帧率。
Title	String	kled.mp4	标题。
Format	String	mov	编码格式。支持mov，mp4，m4a，3gp，3g2，mj2。
NonExistFileURLs	Array of String	null	不存在的媒体ID，无数据时此参数不返回。
RequestId	String	1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42	请求ID。

示例

请求示例

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryMediaListByURL
&FileURLs=http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example.mp4
&IncludePlayList=true
&IncludeSnapshotList=true
&IncludeMediaInfo=true
&IncludeSummaryList=true
&<公共请求参数>

正常返回示例

XML格式

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

<QueryMediaListByURLResponse>
    <MediaList>
        <CreationTime>2021-07-14T13:05:00Z</CreationTime>
        <CateId>123</CateId>
        <Height>360</Height>
        <CensorState>Initiated</CensorState>
        <Tags>tag1,tag2</Tags>
        <PlayList>
            <Encryption>1</Encryption>
            <Height>10</Height>
            <Bitrate>25.067</Bitrate>
            <File>
                <State>Normal</State>
                <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4l-test/in/1.mp4</URL>
            </File>
            <MediaWorkflowId>6cc3aa66d1cb4bb2adf14e726c0a****</MediaWorkflowId>
            <Width>11</Width>
            <Size>100</Size>
            <Fps>25.0</Fps>
            <Duration>7.965000</Duration>
            <ActivityName>test name</ActivityName>
            <Format>mov</Format>
            <MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
        </PlayList>
        <Bitrate>593.192</Bitrate>
        <MediaId>52d7e98b05e648199612290bb819****</MediaId>
        <File>
            <State>Normal</State>
            <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
        </File>
        <SummaryList>
            <Type>Gif</Type>
            <MediaWorkflowId>93ab850b4f6f44eab54b6e91d24d****</MediaWorkflowId>
            <ActivityName>example-activity-****</ActivityName>
            <MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
            <File>
                <State>Normal</State>
                <URL>http://example-bucket-****.o</URL>
            </File>
        </SummaryList>
        <PublishState>Published</PublishState>
        <MediaInfo>
            <Streams>
                <VideoStreamList>
                    <Sar>1:1</Sar>
                    <Height>360</Height>
                    <CodecTagString>avc1</CodecTagString>
                    <NetworkCost>
                        <PreloadTime>0.01</PreloadTime>
                        <AvgBitrate>2659.326</AvgBitrate>
                        <CostBandwidth>100</CostBandwidth>
                    </NetworkCost>
                    <Width>640</Width>
                    <Index>5</Index>
                    <Timebase>1/15360</Timebase>
                    <AvgFPS>15.0</AvgFPS>
                    <PixFmt>yuv420p</PixFmt>
                    <Lang>und</Lang>
                    <CodecLongName>H.264/AVC/MPEG-4 AVC/MPEG-4 part 10</CodecLongName>
                    <NumFrames>12</NumFrames>
                    <Rotate>90</Rotate>
                    <Bitrate>512.701</Bitrate>
                    <HasBFrames>2</HasBFrames>
                    <Profile>High</Profile>
                    <StartTime>0.046029</StartTime>
                    <Dar>16:9</Dar>
                    <CodecName>H264</CodecName>
                    <Duration>79.200000</Duration>
                    <Fps>15.0</Fps>
                    <CodecTag>0x31637661</CodecTag>
                    <CodecTimeBase>1/30</CodecTimeBase>
                    <Level>31</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>76.356</Bitrate>
                    <CodecTagString>mp4a</CodecTagString>
                    <StartTime>0.000000</StartTime>
                    <CodecName>aac</CodecName>
                    <Duration>79.203265</Duration>
                    <CodecTag>0x6134706d</CodecTag>
                    <CodecTimeBase>1/44100</CodecTimeBase>
                </AudioStreamList>
                <SubtitleStreamList>
                    <Index>1</Index>
                    <Lang>und</Lang>
                </SubtitleStreamList>
            </Streams>
            <Format>
                <StartTime>0.000000</StartTime>
                <NumPrograms>0</NumPrograms>
                <Size>5872904</Size>
                <NumStreams>2</NumStreams>
                <FormatLongName>QuickTime/MOV</FormatLongName>
                <Duration>79.204000</Duration>
                <Bitrate>593.192</Bitrate>
                <FormatName>mov</FormatName>
            </Format>
        </MediaInfo>
        <Description>This is description ****</Description>
        <Size>5872904</Size>
        <Width>640</Width>
        <CoverURL>http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png</CoverURL>
        <SnapshotList>
            <Type>Single</Type>
            <MediaWorkflowId>6cc3aa66d1cb4bb2adf14e726c0a****</MediaWorkflowId>
            <ActivityName>example-activity1-****</ActivityName>
            <Count>3</Count>
            <MediaWorkflowName>example-workflow-****</MediaWorkflowName>
            <File>
                <State>Normal</State>
                <URL>http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png</URL>
            </File>
        </SnapshotList>
        <RunIdList>9343bd0e7bb54ae19228529908e5****</RunIdList>
        <Duration>79.204000</Duration>
        <Fps>15.0</Fps>
        <Title>kled.mp4</Title>
        <Format>mov</Format>
    </MediaList>
    <NonExistFileURLs>null</NonExistFileURLs>
    <RequestId>1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42</RequestId>
</QueryMediaListByURLResponse>

JSON格式

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

{
  "MediaList" : [ {
    "CreationTime" : "2021-07-14T13:05:00Z",
    "CateId" : 123,
    "Height" : "360",
    "CensorState" : "Initiated",
    "Tags" : [ "tag1,tag2" ],
    "PlayList" : [ {
      "Encryption" : "1",
      "Height" : "10",
      "Bitrate" : "25.067",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4l-test/in/1.mp4"
      },
      "MediaWorkflowId" : "6cc3aa66d1cb4bb2adf14e726c0a****",
      "Width" : "11",
      "Size" : "100",
      "Fps" : "25.0",
      "Duration" : "7.965000",
      "ActivityName" : "test name",
      "Format" : "mov",
      "MediaWorkflowName" : "example-mediaworkflow-****"
    } ],
    "Bitrate" : "593.192",
    "MediaId" : "52d7e98b05e648199612290bb819****",
    "File" : {
      "State" : "Normal",
      "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
    },
    "SummaryList" : [ {
      "Type" : "Gif",
      "MediaWorkflowId" : "93ab850b4f6f44eab54b6e91d24d****",
      "ActivityName" : "example-activity-****",
      "MediaWorkflowName" : "example-mediaworkflow-****",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example-bucket-****.o"
      }
    } ],
    "PublishState" : "Published",
    "MediaInfo" : {
      "Streams" : {
        "VideoStreamList" : [ {
          "Sar" : "1:1",
          "Height" : "360",
          "CodecTagString" : "avc1",
          "NetworkCost" : {
            "PreloadTime" : "0.01",
            "AvgBitrate" : "2659.326",
            "CostBandwidth" : "100"
          },
          "Width" : "640",
          "Index" : "5",
          "Timebase" : "1/15360",
          "AvgFPS" : "15.0",
          "PixFmt" : "yuv420p",
          "Lang" : "und",
          "CodecLongName" : "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
          "NumFrames" : "12",
          "Rotate" : "90",
          "Bitrate" : "512.701",
          "HasBFrames" : "2",
          "Profile" : "High",
          "StartTime" : "0.046029",
          "Dar" : "16:9",
          "CodecName" : "H264",
          "Duration" : "79.200000",
          "Fps" : "15.0",
          "CodecTag" : "0x31637661",
          "CodecTimeBase" : "1/30",
          "Level" : "31"
        } ],
        "AudioStreamList" : [ {
          "Timebase" : "1/44100",
          "Index" : "1",
          "SampleFmt" : "fltp",
          "ChannelLayout" : "stereo",
          "Lang" : "und",
          "Samplerate" : "44100",
          "CodecLongName" : "AAC (Advanced Audio Coding)",
          "Channels" : "2",
          "NumFrames" : "100",
          "Bitrate" : "76.356",
          "CodecTagString" : "mp4a",
          "StartTime" : "0.000000",
          "CodecName" : "aac",
          "Duration" : "79.203265",
          "CodecTag" : "0x6134706d",
          "CodecTimeBase" : "1/44100"
        } ],
        "SubtitleStreamList" : [ {
          "Index" : "1",
          "Lang" : "und"
        } ]
      },
      "Format" : {
        "StartTime" : "0.000000",
        "NumPrograms" : "0",
        "Size" : "5872904",
        "NumStreams" : "2",
        "FormatLongName" : "QuickTime/MOV",
        "Duration" : "79.204000",
        "Bitrate" : "593.192",
        "FormatName" : "mov"
      }
    },
    "Description" : "This is description ****",
    "Size" : "5872904",
    "Width" : "640",
    "CoverURL" : "http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png",
    "SnapshotList" : [ {
      "Type" : "Single",
      "MediaWorkflowId" : "6cc3aa66d1cb4bb2adf14e726c0a****",
      "ActivityName" : "example-activity1-****",
      "Count" : "3",
      "MediaWorkflowName" : "example-workflow-****",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png"
      }
    } ],
    "RunIdList" : [ "9343bd0e7bb54ae19228529908e5****" ],
    "Duration" : "79.204000",
    "Fps" : "15.0",
    "Title" : "kled.mp4",
    "Format" : "mov"
  } ],
  "NonExistFileURLs" : [ "null" ],
  "RequestId" : "1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42"
}

错误码

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