SearchTemplate - 搜索自定义转码模板 - 媒体处理

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

接口说明

本接口通过搜索转码模板状态搜索自定义模板。

QPS限制

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

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
PageSize	long	否	结果分页查询时设置的每页大小。上限值：100。默认值：10。	10
PageNumber	long	否	当前页号。默认值：1。	1
State	string	否	需要搜索的转码模板状态。 All表示所有。 Normal表示正常。 Deleted表示已删除。默认值：All。	Normal

返回参数

名称	类型	描述	示例值
	object	返回参数。
TotalCount	long	搜索结果总条数。	1
TemplateList	array	转码模板列表。
	object	转码模板。
Video	object	视频编解码配置。
Bufsize	string	缓冲区大小。单位：Kb。默认值：6000。	6000
LongShortMode	string	是否开启横竖屏自适应（即：长短边模式）。转码输出的宽对应输入片源的长边（竖屏为片源的高），高对应输入视频的短边（竖屏为片源的宽）。 true表示开启。 false表示关闭。默认值：false。	false
Degrain	string	视频质量控制度。	10
BitrateBnd	object	视频平均码率范围。
Max	string	总码率上限。单位：Kbps。	500
Min	string	总码率下限。单位：Kbps。	100
PixFmt	string	视频颜色格式。范围：yuv420p，yuvj420p等标准颜色格式。	yuv420p
Pad	string	视频贴黑边。参数格式：width:height:left:top。示例：1280:800:0:140。	1280:800:0:140
Codec	string	编解码格式。可选值H.264、H.265。默认值：H.264。	H.264
Height	string	视频高。单位：px。默认值：视频原始高度。	800
Qscale	string	独立去噪算法强度。	1
Crop	string	视频画面裁切。自动检测黑边并裁切：设置为“border”。自定义裁切：自定义参数并裁剪。参数格式：width:height:left:top。示例：1280:800:0:140。	border
Bitrate	string	视频平均码率。单位：Kbps。	200
Maxrate	string	视频码率峰值。单位：Kbps。	500
MaxFps	string	最大帧率。	60
Profile	string	编码级别。 baseline：针对移动设备。 main：针对标准分辨率设备。 high：针对高分辨率设备。默认值：high。	high
Crf	string	码率-质量控制因子。默认值：编码格式为H264，默认值为23。编码格式为H265，默认值为26。如果设置了Crf，则Bitrate的设置失效。	15
Remove	string	是否删除视频流。 true表示删除。 false表示保留。默认值：false。	false
Gop	string	关键帧间最大帧数。默认值：250。	10
Width	string	视频宽。取值范围：[128,4096]。单位：px。默认值：视频原始宽度。	256
Fps	string	帧率。当输入文件帧率超过60时取60。默认值：取输入文件帧率。	25
Preset	string	视频算法器预置。默认值：medium。可选值： veryfast：超快。 fast：快。 medium：中等。 slow：慢。 slower：超慢。	medium
ScanMode	string	扫描模式。可选值： interlaced：交叉扫描。 progressive：顺序扫描。	interlaced
TransConfig	object	转码通用配置。
IsCheckAudioBitrate	string	是否检查音频码率。当输出音频码率大于媒体源音频码率时，则视为输出音频码率等于媒体源音频码率，即设置的音频码率参数不会生效。此值优先级小于IsCheckAudioBitrateFail。 true表示检查。 false表示不检查。默认值：参数为空，并且codec和输入源不一样：false。参数为空，并且codec和输入源一样：true。	false
TransMode	string	转码模式。默认值：onepass。可选值： onepass twopass CBR	onepass
IsCheckReso	string	是否检查分辨率。如果输出分辨率大于输入分辨率（判断条件是宽或高），则输出分辨率等于输入分辨率。 true表示检查。 false表示不检查。默认值：false。	false
IsCheckVideoBitrateFail	string	是否允许视频码率检查错误。此值优先级大于IsCheckVideoBitrate。 true表示检查出错时不进行转码。 false表示不检查。默认值：false。	false
AdjDarMethod	string	分辨率改写方式。默认值：none。可选值： rescale：范围拉伸。 crop：批量裁剪。 none：不改变。	none
IsCheckVideoBitrate	string	是否检查视频码率。如果视频输出码率大于视频输入码率，则视频输出码率等于视频输入码率。 true表示检查。 false表示不检查。默认值：false。	false
IsCheckResoFail	string	是否检查分辨率。如果输出分辨率大于输入分辨率（判断条件是宽或高），则返回转码失败。 true表示检查。 false表示不检查。默认值：false。	false
IsCheckAudioBitrateFail	string	是否允许音频码率检查错误。此值优先级大于IsCheckAudioBitrate。 true表示检查出错时不进行转码。 false表示不检查。默认值：false。	false
State	string	模板的状态。 Normal：正常。 Deleted：已删除。	Normal
MuxConfig	object	转码封包配置。
Gif	object	Gif对应的封包配置。
FinalDelay	string	终帧暂停时间，单位厘秒（cs）。	0
DitherMode	string	调色板颜色抖动方式。可选的抖动算法为sierra算法和bayer算法。	sierra
Loop	string	循环次数。	0
IsCustomPalette	string	自定义调色板功能。	false
Segment	object	切片配置。
Duration	string	分片时长。单位：秒。	10
Name	string	模板名称。	MPS-example
Audio	object	音频编解码配置。
Profile	string	音频编码预置。当Codec为aac时可选值： aac_low aac_he aac_he_v2 aac_ld aac_eld	aac_low
Remove	string	是否删除音频流。 true表示删除。 false表示保留。默认值：false。	false
Codec	string	音频编解码格式。默认值：aac。可选值： aac mp3 vorbis flac	aac
Samplerate	string	采样率。单位：Hz。默认值：44100。	44100
Qscale	string	独立去噪算法强度。取值：[1,9]。	1
Channels	string	声道数。默认值：2。	2
Bitrate	string	输出文件的音频码率。单位：Kbps。默认值：128。	500
Id	string	转码模板ID。	16f01ad6175e4230ac42bb5182cd****
Container	object	容器。
Format	string	容器格式。可选值： flv mp4 ts m3u8 gif mp3 ogg flac	mp4
PageSize	long	分页查询时设置的每页大小。	10
RequestId	string	请求ID。	BC860F04-778A-472F-AB39-E1BF329C****
PageNumber	long	当前页码。	1

示例

正常返回示例

JSON格式

{
  "TotalCount": 1,
  "TemplateList": {
    "Template": [
      {
        "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": "MPS-example",
        "Audio": {
          "Profile": "aac_low",
          "Remove": "false",
          "Codec": "aac",
          "Samplerate": "44100",
          "Qscale": "1",
          "Channels": "2",
          "Bitrate": "500"
        },
        "Id": "16f01ad6175e4230ac42bb5182cd****",
        "Container": {
          "Format": "mp4"
        }
      }
    ]
  },
  "PageSize": 10,
  "RequestId": "BC860F04-778A-472F-AB39-E1BF329C****",
  "PageNumber": 1
}

错误码

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