更新转码模板

更新时间：2020/10/15 GMT+08:00

功能介绍

更新转码模板。

调试

您可以在API Explorer中调试该接口。

URI

PUT /v1/{project_id}/template/transcodings

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方法请参考获取项目ID

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
Authorization	否	String	使用AK/SK方式认证时必选，携带的鉴权信息。
X-Project_Id	否	String	使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。
X-Sdk-Date	否	String	使用AK/SK方式认证时必选，请求的发生时间。

表3 请求Body参数
参数	是否必选	参数类型	描述
template_id	是	Integer	转码模板ID
template_name	是	String	转码模板名称。
video	否	Video object	视频信息
audio	否	Audio object	音频信息
common	是	Common object	通用信息

表4 Video
参数	是否必选	参数类型	描述
output_policy	否	String	输出策略。取值如下： discard transcode 说明：当视频参数中的“output_policy”为"discard"，且音频参数中的“output_policy”为“transcode”时，表示只输出音频。当视频参数中的“output_policy”为"transcode"，且音频参数中的“output_policy”为“discard”时，表示只输出视频。同时为"discard"时不合法。同时为“transcode”时，表示输出音视频。
codec	否	Integer	视频编码格式。取值如下： 1：表示H.264。 2：表示H.265。
bitrate	否	Integer	输出平均码率。取值范围：0或[40,30000]之间的整数。单位：kbit/s 若设置为0，则输出平均码率为自适应值。
profile	否	Integer	编码档次，建议设为3。取值如下： 1：VIDEO_PROFILE_H264_BASE 2：VIDEO_PROFILE_H264_MAIN 3：VIDEO_PROFILE_H264_HIGH 4：VIDEO_PROFILE_H265_MAIN
level	否	Integer	编码级别。取值如下： 1：VIDEO_LEVEL_1_0 2：VIDEO_LEVEL_1_1 3：VIDEO_LEVEL_1_2 4：VIDEO_LEVEL_1_3 5：VIDEO_LEVEL_2_0 6：VIDEO_LEVEL_2_1 7：VIDEO_LEVEL_2_2 8：VIDEO_LEVEL_3_0 9：VIDEO_LEVEL_3_1 10：VIDEO_LEVEL_3_2 11：VIDEO_LEVEL_4_0 12：VIDEO_LEVEL_4_1 13：VIDEO_LEVEL_4_2 14：VIDEO_LEVEL_5_0 15：VIDEO_LEVEL_5_1
preset	否	Integer	编码质量等级。取值如下： 1：VIDEO_PRESET_HSPEED2 2：VIDEO_PRESET_HSPEED 3：VIDEO_PRESET_NORMAL 说明：值越大，表示编码的质量越高，转码耗时也越长。
ref_frames_count	否	Integer	最大参考帧数。取值范围： H264：[1，8] H265：固定值4 单位：帧。
max_iframes_interval	否	Integer	I帧最大间隔取值范围：[2，10]。默认值：5。单位：秒。
bframes_count	否	Integer	最大B帧间隔。取值范围： H264：[0，7]，默认值为4。 H265：[0，7]，默认值为7。单位：帧。
frame_rate	否	Integer	帧率。取值范围：0或[5,60]之间的整数。单位：帧每秒。说明：若设置的帧率不在取值范围内，则自动调整为0，若设置的帧率高于片源帧率，则自动调整为片源帧率。
width	否	Integer	视频宽度。取值范围： H.264：0或[32,4096]间2的倍数。 H.265：0或[160,4096]间4的倍数。单位：像素。说明：若视频宽度设置为0，则视频宽度值自适应。
height	否	Integer	视频高度。 H.264：0或[32,2880]且必须为2的倍数。 H.265：0或[96,2880]且必须为4的倍数。单位：像素。说明：若视频高度设置为0，则视频高度值自适应。
aspect_ratio	否	Integer	纵横比，图像缩放方式。取值如下： 0：自适应，保持原有宽高比 1：补黑边（16:9） 2：裁黑边（18:9）
black_cut	否	Integer	黑边剪裁类型。取值如下： 0：不开启黑边剪裁。 1：开启黑边剪裁，低复杂度算法，针对长视频（>5分钟）。 2：开启黑边剪裁，高复杂度算法，针对短视频（<=5分钟）。

表5 Audio
参数	是否必选	参数类型	描述
output_policy	否	String	输出策略。取值如下： discard transcode 说明：当视频参数中的“output_policy”为"discard"，且音频参数中的“output_policy”为“transcode”时，表示只输出音频。当视频参数中的“output_policy”为"transcode"，且音频参数中的“output_policy”为“discard”时，表示只输出视频。同时为"discard"时不合法。同时为“transcode”时，表示输出音视频。
codec	是	Integer	音频编码格式。取值如下： 1：AAC格式。 2：HEAAC1格式。 3：HEAAC2格式。 4：MP3格式。
sample_rate	是	Integer	音频采样率。取值如下： 1：AUDIO_SAMPLE_AUTO 2：AUDIO_SAMPLE_22050（22050Hz） 3：AUDIO_SAMPLE_32000（32000Hz） 4：AUDIO_SAMPLE_44100（44100Hz） 5：AUDIO_SAMPLE_48000（48000Hz） 6：AUDIO_SAMPLE_96000（96000Hz）
bitrate	否	Integer	音频码率。取值范围：0或[8,1000]。单位：kbit/s。
channels	是	Integer	声道数。取值如下： 1：AUDIO_CHANNELS_1 2：AUDIO_CHANNELS_2 6：AUDIO_CHANNELS_5_1

表6 Common
参数	是否必选	参数类型	描述
PVC	是	Boolean	是否开启高清低码功能。取值如下： false：关闭。 true：开启。
hls_interval	是	Integer	HLS分片间隔，仅封装类型“pack_type”取值为1或3时，该参数生效。取值范围：[2，10]。单位：秒。
dash_interval	是	Integer	DASH间隔，仅封装类型“pack_type”取值为2或3时，该参数生效。取值范围：[2，10]。单位：秒。
pack_type	是	Integer	封装类型。取值如下： 1：HLS 2：DASH 3：HLS+DASH 4：MP4 5：MP3 6：ADTS 说明： pack_type设置为5和6时，不能设置视频参数。

响应参数

状态码为 403 时：

表7 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。

请求示例

PUT https://{endpoint}/v1/{project_id}/template/transcodings/
{
    "templated_id":1001,
    "template_name":"MP4_H.264_1920x1080_6000_HEAAC_PVC",
    "video":{
        "codec":1,
        "bitrate":6000,
        "profile":3,
        "level":15,
        "preset":3,
        "ref_frames_count":4,
        "max_iframes_interval":5,
        "bframes_count":4,
        "frame_rate":1,
        "width":1920,
        "height":1080,
        "aspect_ratio":0
    },
    "audio":{
        "codec":1,
        "sample_rate":4,
        "bitrate":128,
        "channels":2
    },
    "common":{
        "PVC":1,
        "hls_interval":5,
        "dash_interval":5,
        "pack_type":1
    }
}

响应示例

无

状态码

状态码	描述
204	更新转码模板成功。
403	更新转码模板失败。

错误码

请参见错误码。

父主题： 自定义转码模板接口

上一篇：新建转码模板

下一篇：删除转码模板

更新转码模板

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

相关产品

文档是否有解决您的问题？