云点播
AI绘画有奖征文大赛：火热进行中> HOT
文档中心 > 云点播 > 服务端 API 文档 > 云点播 API 2017 > 转码模板管理 > 创建转码模板

创建转码模板

最近更新时间：2021-11-09 11:38:39

前往 GitHub 编辑 我的收藏

本页目录：

接口名称

CreateTranscodeTemplate

功能说明

  • 创建新的转码模板。
  • 自定义转码模板数最多为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 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=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
    }
}

    中国站