查询转码模板

最近更新时间:2019-05-10 12:35:39

接口名称

QueryTranscodeTemplate

功能说明

查询转码模板详细信息。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
definition Integer 转码模板 ID
COMMON_PARAMS 参见 公共参数

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=QueryTranscodeTemplate
&definition=10
&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码, 0: 成功, 其他值: 失败
message String 错误信息
data Object 参见 转码模板信息

data(转码模板信息)

参数名称 类型 说明
name String 转码模板的名字
container String 容器类型,例如 m4a 和 mp4 等
comment String 对该模板的描述
createTime Integer 模板创建时间(Unix 时间戳)
updateTime Integer 模板信息最近更新时间(Unix 时间戳)
isFiltrateVideo Integer 去除视频数据,1为去除,0为保留,默认为0
isFiltrateAudio Integer 去除音频数据,1为去除,0为保留,默认为0
video Object 参见 视频流配置参数,当 isFiltrateVideo 为1,则该字段将被忽略
audio Object 参见 音频流配置参数,若 isFiltrateAudio 为1,则该字段将被忽略
onPremise Integer 是否为 系统预置转码模板,1表示是,0表示否
status Integer 是否为默认模板,1表示是,0表示否

video(视频流配置参数)

参数名称 类型 说明
codec Integer 视频流的编码格式, 目前有:libx264(H.264 编码),libx265(H.265 编码)
fps Float 帧率,单位:Hz
resolutionSelfAdapting Integer 分辨率开启自适应:1为开启,0为关闭。 若为1,则 width 的值用于较长边,height 的值用于较短边, 默认为1
width Integer 视频流宽度的最大值,如果该值为0,height 非0,则按比例缩放;反之,若 height 为0,则表示同源。 单位:px
height Integer 视频流高度的最大值,如果该值为0,width 非0,则按比例缩放, 反之,若 width 为0,则表示同源。单位:px
bitrate Integer 视频流的码率,单位:kbps
minGop Integer 视频关键帧最小间隔,取值范围1 - 10,单位:秒
maxGop Integer 视频关键帧最大间隔,取值范围1 - 10,单位:秒
videoProfile String 视频编码档次,取值 baseline、main 和 high
colorSpace String 视频色度空间,取值 yuv420p 和 yuv420p10le
deinterlaced Integer 视频去隔行模式,1:去隔行,0:保持视频隔行模式
videoRateControl Integer 视频编码模式,0表示 one pass,1表示 two pass
denoise Object 视频降噪参数
denoise.enable Integer 是否启用视频降噪处理, 1:启用,0:不启用

audio(音频流配置参数)

参数名称 类型 说明
codec String 音频流的编码格式,目前有:
  • libfdk_aac(更适合 mp4 和 hls)
  • libmp3lame(更适合 flv)
  • mp2
  • bitrate Integer 音频流的码率,单位:kbps
    soundSystem String 音频通道方式,1:单通道,2:双通道,6:立体声
    sampleRate Integer 音频流的采样率。 单位:Hz
    audioResampler string 音频重新采样参数,如果音频声道数超过2个,重新采样为2声道。目前只支持 soxr
    audioDownmixMode Integer 1表示音频重新采样时,如果声道数大于4个,在重新采样的基础上,再为中央声道做增益补偿。
    audioProfile String 音频编码档次(仅当 codec 为 libfdk_aac 时有效),取值有 aac_lc、aac_he 和 aac_he_v2 三种档次。

    错误码说明

    错误码 含义说明
    4000 - 7000 参见 公共错误码
    1000 无效参数
    10702 内部错误
    10704 该模板不存在

    应答示例

    {
        "code": 0,
        "message": "",
        "codeDesc": "Success",
        "data": {
            "definition": 10,
            "name": "",
            "comment": "",
            "container": "mp4",
            "createTime": 1485156352,
            "updateTime": 1485156352,
            "isFiltrateVideo": 0,
            "isFiltrateAudio": 0,
            "video": {
                "codec": "libx264",
                "fps": 24,
                "width": 320,
                "height": 0,
                "bitrate": 256,
                "resolutionSelfAdapting": "open",
                "colorSpace": "YUV420P",
                {...}
            },
            "audio": {
                "codec": "libfdk_aac",
                "bitrate": 48,
                "sampleRate": 44100,
                "soundSystem": 2,
                {...}
            },
            "onPremise": 1,
            "status": 0
        }
    }