调用SearchTemplate搜索指定状态的自定义模板。

调试

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

请求参数

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

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

PageSize Long 10

分页查询时设置的每页大小。

  • 上限值:100
  • 默认值:10
PageNumber Long 1

当前页号。默认值:1

State String Normal

转码模板状态:

  • All(默认值)表示所有
  • Normal表示正常
  • Deleted表示已删除

返回数据

名称 类型 示例值 描述
TotalCount Long 1

总条数。

TemplateList Array of Template

转码模板列表。

Template
Video Object

视频编解码配置。

Bufsize String 6000

缓冲区大小。

  • 取值范围:[1000,128000]
  • 单位:Kb
  • 默认值:6000
LongShortMode String false

是否开启横竖屏自适应(即:长短边模式)

  • 转码输出的宽对应输入片源的长边(竖屏为片源的高),高对应输入视频的短边(竖屏为片源的宽)
  • true表示开启
  • false表示关闭
  • 默认值:false
Degrain String 10

视频质量控制度,取值:1~31

BitrateBnd Object

视频平均码率范围。

Max String 500

总码率上限,

  • 取值范围:[10,50000]
  • 单位:Kbps
Min String 100

总码率下限。

  • 取值范围:[10,50000]
  • 单位: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、H.265
  • 默认值:H.264
Height String 800

高。

  • 取值范围:[128,4096]
  • 单位:px
  • 默认值:视频原始高度
Qscale String 1

独立去噪算法强度,取值[1,9]

Crop String border

视频画面裁切。

  • 支持2种方式。
  • 自动检测黑边并裁切,设置为“border”
  • 自定义裁切,参数格式:width:height:left:top。
  • 示例:1280:800:0:140
Bitrate String 200

视频平均码率。

  • 取值范围:[10,50000]
  • 单位:Kbps
Maxrate String 500

视频码率峰值。

  • 取值范围:[10,50000]
  • 单位:Kbps
MaxFps String 60

最大帧率。

Profile String high

编码级别。

  • 支持baseline、main、high。
  • baseline:针对移动设备
  • main:针对标准分辨率设备
  • high:针对高分辨率设备
  • 默认值:high
Crf String 15

码率-质量控制因子。

  • 取值范围:[0,51]
  • 默认值:26
  • 如果设置了Crf,则Bitrate的设置失效。
Remove String false

是否删除视频流。

  • true表示删除
  • false表示保留
  • 默认值:false
Gop String 10

关键帧间最大帧数。

  • 取值范围:[1,1080000]
  • 默认值:250
Width String 256

宽。

  • 取值范围:[128,4096]
  • 单位:px
  • 默认值:视频原始宽度
Fps String 25

帧率。

  • 取值范围:0~60
  • 当输入文件帧率超过60时取60
  • 默认值:取输入文件帧率
Preset String medium

视频算法器预置。

  • 支持veryfast、fast、medium、slow、slower
  • 默认值:medium
ScanMode String interlaced

扫描模式。

支持interlaced、progressive

TransConfig Object

转码通用配置。

IsCheckAudioBitrate String false

是否检查音频码率。

  • 如果音频输出码率大于音频输入码率,则音频输出码率等于音频输入码率。
  • true表示检查
  • false表示不检查
  • 默认值:false
TransMode String onepass

转码模式。

  • 可选范围onepass、twopass、CBR
  • 默认值:onepass
IsCheckReso String false

是否检查分辨率。

  • 如果输出分辨率大于输入分辨率(判断条件是宽或高),则输出分辨率等于输入分辨率。
  • true表示检查
  • false表示不检查
  • 默认值:false
IsCheckVideoBitrateFail String false

当输出视频码率大于媒体源视频码率时

  • true表示不进行转码
  • false表示不检查
  • 默认值:false
  • 此值优先级大于IsCheckVideoBitrate。
AdjDarMethod String none

分辨率改写方式。

  • 默认值:none
  • 可选范围rescale、crop、pad、none。
IsCheckVideoBitrate String false

是否检查视频码率。

  • 如果视频输出码率大于视频输入码率,则视频输出码率等于视频输入码率。
  • true表示检查
  • false表示不检查
  • 默认值:false
IsCheckResoFail String false

是否检查分辨率。

  • 如果输出分辨率大于输入分辨率(判断条件是宽或高),则返回转码失败。
  • true表示检查
  • false表示不检查
  • 默认值:false
IsCheckAudioBitrateFail String false

当输出音频码率大于媒体源音频码率时

  • true表示不进行转码
  • false表示不检查
  • 默认值:false
  • 此值优先级大于IsCheckAudioBitrate。
State String Normal

模板的状态,分为Normal、Deleted。

MuxConfig Object

转码封包配置。

Gif Object

Gif对应的封包配置。

FinalDelay String 0

终帧暂停时间,取值范围[0, 60000](厘秒)。

DitherMode String sierra

调色板颜色抖动方式,取值sierra, bayer

Loop String 0

循环次数,取值范围[-1, 1000]

IsCustomPalette String false

自定义调色板功能

Segment Object

切片配置。

Duration String 10

分片时长。

  • 取值范围:[1,60]
  • 单位:秒
Name String MTS-example

模板名称。

Audio Object

音频编解码配置。

Profile String aac_low

音频编码预置。

当Codec为aac时可以设置如下范围中的值:aac_low、aac_he、aac_he_v2、aac_ld、aac_eld

Remove String false

是否删除音频流。

  • true表示删除
  • false表示保留
  • 默认值:false
Codec String aac

音频编解码格式。

  • 支持aac、mp3、vorbis、flac,
  • 默认值:aac
Samplerate String 44100

采样率。

  • 支持22050、32000、44100、48000、96000
  • 单位:Hz
  • 默认值:44100
Qscale String 1

独立去噪算法强度。取值:1~9

Channels String 2

声道数。

  • 支持1、2、3、4、5、6、7、8
  • 默认值:2
Bitrate String 500

输出文件的音频码率。

  • 取值范围:[8,1000]
  • 单位:Kbps
  • 默认值:128
Id String 88c6ca184c0e4*****5b665e2a126799

转码模板ID。

Container Object

容器。

Format String mp4

容器格式。

  • 可选范围flv、mp4、ts、m3u8、gif、mp3、ogg、flac
PageSize Long 3

分页查询时设置的每页大小。

RequestId String 3E767BAD-9F4C-4F*****AE-E3F4A639066B

请求ID。

PageNumber Long 1

当前页码。

示例

请求示例

http(s)://[Endpoint]/?AccessKeyId=xxx
&Action=SearchTemplate
&ResourceOwnerAccount=xxx
&PageSize=10
&PageNumber=1
&State=Normal
&OwnerAccount=xxx
&公共请求参数

正常返回示例

XML格式

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

<SearchTemplateResponse>
    <TotalCount>1</TotalCount>
    <TemplateList>
        <Video>
            <Bufsize>6000</Bufsize>
            <LongShortMode>false</LongShortMode>
            <Degrain>10</Degrain>
            <BitrateBnd>
                <Max>500</Max>
                <Min>100</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>
        </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>
            <Gif>
                <FinalDelay>0</FinalDelay>
                <DitherMode>sierra</DitherMode>
                <Loop>0</Loop>
                <IsCustomPalette>false</IsCustomPalette>
            </Gif>
            <Segment>
                <Duration>10</Duration>
            </Segment>
        </MuxConfig>
        <Name>MTS-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>88c6ca184c0e4*****5b665e2a126799</Id>
        <Container>
            <Format>mp4</Format>
        </Container>
    </TemplateList>
    <PageSize>3</PageSize>
    <RequestId>3E767BAD-9F4C-4F*****AE-E3F4A639066B</RequestId>
    <PageNumber>1</PageNumber>
</SearchTemplateResponse>

JSON格式

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

{
  "TotalCount" : 1,
  "TemplateList" : {
    "Video" : {
      "Bufsize" : 6000,
      "LongShortMode" : false,
      "Degrain" : 10,
      "BitrateBnd" : {
        "Max" : 500,
        "Min" : 100
      },
      "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"
    },
    "TransConfig" : {
      "IsCheckAudioBitrate" : false,
      "TransMode" : "onepass",
      "IsCheckReso" : false,
      "IsCheckVideoBitrateFail" : false,
      "AdjDarMethod" : "none",
      "IsCheckVideoBitrate" : false,
      "IsCheckResoFail" : false,
      "IsCheckAudioBitrateFail" : false
    },
    "State" : "Normal",
    "MuxConfig" : {
      "Gif" : {
        "FinalDelay" : 0,
        "DitherMode" : "sierra",
        "Loop" : 0,
        "IsCustomPalette" : false
      },
      "Segment" : {
        "Duration" : 10
      }
    },
    "Name" : "MTS-example",
    "Audio" : {
      "Profile" : "aac_low",
      "Remove" : false,
      "Codec" : "aac",
      "Samplerate" : 44100,
      "Qscale" : 1,
      "Channels" : 2,
      "Bitrate" : 500
    },
    "Id" : "88c6ca184c0e4*****5b665e2a126799",
    "Container" : {
      "Format" : "mp4"
    }
  },
  "PageSize" : 3,
  "RequestId" : "3E767BAD-9F4C-4F*****AE-E3F4A639066B",
  "PageNumber" : 1
}

错误码

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