更新转码模板

最近更新时间:2019-07-09 19:21:01

接口名称

UpdateTranscodeTemplate

功能说明

更新转码模板。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

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

video(视频流配置参数)

参数名称 必填 类型 说明
codec String 视频流的编码格式,可填 libx264(H.264 编码)或 libx265(H.265 编码),目前 H.265 编码必须指定分辨率,并且需要在640 x 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=UpdateTranscodeTemplate
    &definition=1003
    &container=mp4
    &comment=comm_definition
    &video.codec=libx264
    &video.fps=45
    &video.width=564
    &video.height=123
    &video.bitrate=256
    &audio.codec=libfdk_aac
    &audio.bitrate=512
    &audio.soundSystem=dual-channel
    &audio.sampleRate=200
    &COMMON_PARAMS
    

    接口应答

    参数说明

    参数名称 类型 说明
    code Integer 错误码,0:成功;其他值:失败。
    message String 错误信息。

    错误码说明

    错误码 含义说明
    4000 - 7000 请参见 公共错误码
    1000 无效参数。
    10701 内部错误。
    10702 内部错误。
    10704 该模板不存在。
    10730 请求中的 container 参数无效。
    10731 请求中的 video.fps 参数无效。
    10732 请求中的 video.codec 参数无效。
    10733 请求中的 video.bitrate 参数无效。
    10734 分辨率非法。
    10735 请求中 definition 非法。
    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": ""
    }