创建转码模板

最近更新时间:2019-05-10 12:31:54

接口名称

CreateTranscodeTemplate

功能说明

  1. 创建新的转码模板。
  2. 自定义转码模板数最多为16个。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
name String 转码模板的名字,长度必须小于64字节。 默认为空字符串。
container String 封装格式,支持 mp4、flv 和 hls。
comment String 对该模板的描述,长度必须小于256字节。 默认为空字符串。
isFiltrateVideo Integer 去除视频数据,1为去除,0为保留,默认为0。
isFiltrateAudio Integer 去除音频数据,1为去除,0为保留,默认为0。
video Object 参考 视频流配置参数(当 isFiltrateVideo 为1时,则该字段的值将被忽略)。
audio Object 参考 音频流配置参数(当 isFiltrateAudio 为1时,则该字段的值将被忽略)。
COMMON_PARAMS 参见 公共参数

video(视频流配置参数)

参数名称 必填 类型 说明
codec String 视频流的编码格式,可填 libx264(H.264 编码),libx265(H.265 编码),目前 H.265 编码必须指定分辨率,并且需要在640 * 480以内。
fps Float 视频帧率,单位:Hz。当 fps 不为0时,可以取的值有24、25、30等(在[1, 60]区间)。当 fps 为0时,表示帧率和原始视频保持一致。
resolutionSelfAdapting String 分辨率开启自适应:open 为开启,close 为关闭。 若为 open,则 width 的值用于较长边,height 的值用于较短边(长边的值不得短于短边), 默认为 open。
width Integer 视频流宽度(或长边)的最大值。当 width 不填(或者填0)时,若 height 非0,则 width 按比例缩放,若 height 也为0,则表示 width 同源。 如果 width 不为0时,该值最小128,最大4096,单位:px。
height Integer 视频流高度(或短边)的最大值。当 height 不填(或者填0)时,若 width 非0,则 height 按比例缩放,若 width 也为0,则表示 height 同源。 如果 height 不为0时,该值最小128,最大4096,单位:px。
bitrate Integer 视频流的码率,单位:kbps。当 bitrate 不为0时,可以取的值在[128, 35000]区间。当 bitrate 为0时,表示视频码率和原始视频保持一致。
minGop Integer 视频关键帧最小间隔,取值范围1 - 10,单位:秒。
maxGop Integer 视频关键帧最大间隔,取值范围1 - 10,单位:秒。
videoProfile String 视频编码档次(仅当 codec 为 libx264 时有效),可填 baseline、main 和 high 三种档次,默认为 high。
colorSpace String 视频色度空间,H.264 只支持 yuv420p,H.265 支持 yuv420p 和 yuv420p10le。
deinterlaced Integer 视频去隔行模式,1:去隔行,0:保持视频隔行模式。
videoRateControl Integer 视频压缩模式,0:one pass,1:two pass。

audio(音频流配置参数)

参数名称 必填 类型 说明
codec String 音频流的编码格式,目前有:
  • libfdk_aac(更适合 mp4 和 hls)
  • libmp3lame(更适合 flv)
  • mp2
  • bitrate Integer 音频流的码率,单位:kbps。当 bitrate 不为0时,可以取的值在[26, 256]区间。当 bitrate 为0时,表示音频码率和原始音频保持一致。
    soundSystem Integer 音频通道方式,可填 1:单通道,2:双通道,6:立体声。默认为双通道。
    sampleRate Integer 音频流的采样率,可填32000、44100和48000三个值,单位:Hz。
    audioProfile String 音频编码档次(仅当 codec 为 libfdk_aac 时有效),可填 aac_lc、aac_he 和 aac_he_v2 三种档次,默认为 aac_lc。

    注意:

    • 分辨率开启自适应的情况下,长边的值(width)不得短于短边(height)。
    • video 中的 fps、bitrate、width 和 height,以及 audio 中的 bitrate 和 sampleRate,这些字段支持填入负数,表示该字段禁止低转高。例如,video.bitrate 赋值为-512的模板表示,若原视频码率低于512k,转码后视频码率将不会提升(即原视频码率为256k,则转码后视频码率仍为256k;如果原视频码率为1024k,则转码后视频码率为512k)。

    请求示例

    https://vod.api.qcloud.com/v2/index.php?Action=CreateTranscodeTemplate
    &name=highDefinition
    &container=mp4
    &comment=commDefinition
    &video.codec=libx264
    &video.fps=45
    &video.width=564
    &video.height=123
    &video.bitrate=256
    &audio.codec=libfdk_aac
    &audio.bitrate=512
    &audio.soundSystem=2
    &audio.sampleRate=200
    &COMMON_PARAMS
    

    接口应答

    参数说明

    参数名称 类型 说明
    code Integer 错误码, 0: 成功, 其他值: 失败。
    message String 错误信息。
    data Object 返回的数据信息。
    data.definition Integer 转码模板 ID。

    错误码说明

    错误码 含义说明
    4000 - 7000 参见 公共错误码
    1000 参数非法
    10700 内部错误
    10730 请求中的 container 参数无效
    10731 请求中的 video.fps 参数无效
    10732 请求中的 video.codec 参数无效
    10733 请求中的 video.bitrate 参数无效
    10734 分辨率非法
    10754 请求中的 audio.codec 参数无效
    10755 请求中的 audio.sampleRate 参数无效
    10756 请求中的 audio.bitrate 参数无效
    10757 请求中的 audio.soundSystem 参数无效
    10736 请求中的 isFiltrateVideo 参数无效
    10737 请求中的 isFiltrateAudio 参数无效
    10738 请求中的 video.minGop 参数无效
    10739 请求中的 video.maxGop 参数无效
    10740 请求中的 video.profile 参数无效
    10741 请求中的 video.colorSpace 参数无效
    10742 请求中的 video.deinterlaced 参数无效
    10743 请求中的 video.videoRateControl 参数无效
    10745 请求中的 denoise 参数无效
    10758 请求中的 audio.audioResampler 参数无效
    10759 请求中的 audio.audioDownmixMode

    应答示例

    {
        "code": 0,
        "message": "",
        "data": {
            "definition": 1005
        }
    }