服务端 API 文档

查询转码模板

最近更新时间:2019-07-09 19:54:35

接口名称

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
        }
    }
    目录