调用QueryTemplateList查询转码模板详细信息。
使用说明
本接口一次最多可查询10个模板信息。
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | QueryTemplateList |
操作接口名,系统规定参数,取值: QueryTemplateList。 |
TemplateIds | String | 是 | 16f01ad6175e4230ac42bb5182cd****,88c6ca184c0e424d5w5b665e2a12**** |
需要查询的模板ID列表。最多一次查询10个,用半角逗号(,)分隔。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NonExistTids | Array of String | 88c6ca184c0e424d5w5b665e2a12**** |
不存在的模板列表,无数据时该参数不返回。 |
TemplateList | Array of Template |
转码模板列表。 |
|
Template | |||
Video | Object |
视频编解码配置。 |
|
Bufsize | String | 6000 |
缓冲区大小。
|
LongShortMode | String | false |
是否开启横竖屏自适应(即:长短边模式)。
|
Degrain | String | 10 |
视频质量控制度 。 |
BitrateBnd | Object |
视频平均码率范围。 |
|
Max | String | 100 |
总码率上限。单位:Kbps。 |
Min | String | 500 |
总码率下限。单位:Kbps。 |
PixFmt | String | yuv420p |
视频颜色格式。范围:yuv420p,yuvj420p等标准颜色格式。 |
Pad | String | 1280:800:0:140 |
视频贴黑边。参数格式:width:height:left:top。示例:1280:800:0:140。 |
Codec | String | H.264 |
编解码格式。默认值:H.264。 |
Height | String | 800 |
视频高。
|
Qscale | String | 1 |
独立去噪算法强度。 |
Crop | String | border |
视频画面裁切。
|
Bitrate | String | 200 |
视频平均码率。单位:Kbps。 |
Maxrate | String | 500 |
视频码率峰值。单位:Kbps。 |
MaxFps | String | 60 |
最大帧率。 |
Profile | String | high |
编码级别。
|
Crf | String | 15 |
码率-质量控制因子。
|
Remove | String | false |
是否删除视频流。
|
Gop | String | 10 |
关键帧间最大帧数。默认值:250。 |
Width | String | 256 |
宽。
|
Fps | String | 25 |
帧率。
|
Preset | String | medium |
视频算法器预置。支持veryfast(超快)、fast(快)、medium(中等)、slow(慢)、slower(超慢)。默认值:medium。 |
ScanMode | String | interlaced |
扫描模式。可选值:
|
ResoPriority | String | heightFirst |
分辨率调整优先级。支持cropFirst(裁剪优先)、widthFirst(宽度优先)、heightFirst(高度优先)。 |
TransConfig | Object |
转码通用配置。 |
|
IsCheckAudioBitrate | String | false |
是否检查音频码率。
|
TransMode | String | onepass |
转码模式。默认值:onepass。可选值:
|
IsCheckReso | String | false |
是否检查分辨率。
|
IsCheckVideoBitrateFail | String | false |
是否允许视频码率检查错误。
|
AdjDarMethod | String | none |
分辨率改写方式。默认值:none。可选值:
|
IsCheckVideoBitrate | String | false |
是否检查视频码率。
|
IsCheckResoFail | String | false |
是否检查分辨率。
|
IsCheckAudioBitrateFail | String | false |
是否允许音频码率检查错误。
|
State | String | Normal |
模板的状态。
|
MuxConfig | Object |
转码封包配置。 |
|
Webp | Object |
Webp对应的封包配置。 |
|
Loop | String | 0 |
循环次数。 |
Gif | Object |
Gif对应的封包配置。 |
|
FinalDelay | String | 0 |
终帧暂停时间。 |
DitherMode | String | sierra |
调色板颜色抖动方式。抖动算法可选值为sierra算法和bayer算法。 |
Loop | String | 0 |
循环次数。 |
IsCustomPalette | String | false |
自定义调色板功能。 |
Segment | Object |
切片配置。 |
|
Duration | String | 10 |
分片时长。单位:秒。 |
Name | String | MPS-example |
模板名称。 |
Audio | Object |
音频编解码配置。 |
|
Profile | String | aac_low |
音频编码预置。当Codec为aac时可选值:
|
Remove | String | false |
是否删除音频流。
|
Codec | String | aac |
音频编解码格式。默认值:aac。可选值:
|
Samplerate | String | 44100 |
采样率。
|
Qscale | String | 1 |
独立去噪算法强度。 |
Channels | String | 2 |
声道数。默认值:2。 |
Bitrate | String | 500 |
输出文件的音频码率。
|
Id | String | 16f01ad6175e4230ac42bb5182cd**** |
转码模板ID。 |
Container | Object |
容器。 |
|
Format | String | flv |
容器格式。可选范围flv、mp4、ts、m3u8、gif、mp3、ogg、flac。 |
RequestId | String | BC860F04-778A-472F-AB39-E1BF329C1EA8 |
请求ID。 |
示例
请求示例
http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryTemplateList
&TemplateIds=16f01ad6175e4230ac42bb5182cd****,88c6ca184c0e424d5w5b665e2a12****
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<QueryTemplateListResponse>
<NonExistTids>88c6ca184c0e424d5w5b665e2a12****</NonExistTids>
<TemplateList>
<Video>
<Bufsize>6000</Bufsize>
<LongShortMode>false</LongShortMode>
<Degrain>10</Degrain>
<BitrateBnd>
<Max>100</Max>
<Min>500</Min>
</BitrateBnd>
<PixFmt>yuv420p</PixFmt>
<Pad>1280:800:0:140</Pad>
<Codec>H.264</Codec>
<Height>800</Height>
<Qscale>1</Qscale>
<Crop>border</Crop>
<Bitrate>200</Bitrate>
<Maxrate>500</Maxrate>
<MaxFps>60</MaxFps>
<Profile>high</Profile>
<Crf>15</Crf>
<Remove>false</Remove>
<Gop>10</Gop>
<Width>256</Width>
<Fps>25</Fps>
<Preset>medium</Preset>
<ScanMode>interlaced</ScanMode>
<ResoPriority>heightFirst</ResoPriority>
</Video>
<TransConfig>
<IsCheckAudioBitrate>false</IsCheckAudioBitrate>
<TransMode>onepass</TransMode>
<IsCheckReso>false</IsCheckReso>
<IsCheckVideoBitrateFail>false</IsCheckVideoBitrateFail>
<AdjDarMethod>none</AdjDarMethod>
<IsCheckVideoBitrate>false</IsCheckVideoBitrate>
<IsCheckResoFail>false</IsCheckResoFail>
<IsCheckAudioBitrateFail>false</IsCheckAudioBitrateFail>
</TransConfig>
<State>Normal</State>
<MuxConfig>
<Webp>
<Loop>0</Loop>
</Webp>
<Gif>
<FinalDelay>0</FinalDelay>
<DitherMode>sierra</DitherMode>
<Loop>0</Loop>
<IsCustomPalette>false</IsCustomPalette>
</Gif>
<Segment>
<Duration>10</Duration>
</Segment>
</MuxConfig>
<Name>MPS-example</Name>
<Audio>
<Profile>aac_low</Profile>
<Remove>false</Remove>
<Codec>aac</Codec>
<Samplerate>44100</Samplerate>
<Qscale>1</Qscale>
<Channels>2</Channels>
<Bitrate>500</Bitrate>
</Audio>
<Id>16f01ad6175e4230ac42bb5182cd****</Id>
<Container>
<Format>flv</Format>
</Container>
</TemplateList>
<RequestId>BC860F04-778A-472F-AB39-E1BF329C1EA8</RequestId>
</QueryTemplateListResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"NonExistTids" : [ "88c6ca184c0e424d5w5b665e2a12****" ],
"TemplateList" : [ {
"Video" : {
"Bufsize" : "6000",
"LongShortMode" : "false",
"Degrain" : "10",
"BitrateBnd" : {
"Max" : "100",
"Min" : "500"
},
"PixFmt" : "yuv420p",
"Pad" : "1280:800:0:140",
"Codec" : "H.264",
"Height" : "800",
"Qscale" : "1",
"Crop" : "border",
"Bitrate" : "200",
"Maxrate" : "500",
"MaxFps" : "60",
"Profile" : "high",
"Crf" : "15",
"Remove" : "false",
"Gop" : "10",
"Width" : "256",
"Fps" : "25",
"Preset" : "medium",
"ScanMode" : "interlaced",
"ResoPriority" : "heightFirst"
},
"TransConfig" : {
"IsCheckAudioBitrate" : "false",
"TransMode" : "onepass",
"IsCheckReso" : "false",
"IsCheckVideoBitrateFail" : "false",
"AdjDarMethod" : "none",
"IsCheckVideoBitrate" : "false",
"IsCheckResoFail" : "false",
"IsCheckAudioBitrateFail" : "false"
},
"State" : "Normal",
"MuxConfig" : {
"Webp" : {
"Loop" : "0"
},
"Gif" : {
"FinalDelay" : "0",
"DitherMode" : "sierra",
"Loop" : "0",
"IsCustomPalette" : "false"
},
"Segment" : {
"Duration" : "10"
}
},
"Name" : "MPS-example",
"Audio" : {
"Profile" : "aac_low",
"Remove" : "false",
"Codec" : "aac",
"Samplerate" : "44100",
"Qscale" : "1",
"Channels" : "2",
"Bitrate" : "500"
},
"Id" : "16f01ad6175e4230ac42bb5182cd****",
"Container" : {
"Format" : "flv"
}
} ],
"RequestId" : "BC860F04-778A-472F-AB39-E1BF329C1EA8"
}
错误码
访问错误中心查看更多错误码。