文档首页> 媒体处理 MPC> API参考> 自定义转码模板接口> 更新转码模板
更新时间：2022-03-17 GMT+08:00
查看PDF
分享

更新转码模板

功能介绍

更新转码模板。

调试

您可以在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

是

Long

转码模板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，则视频高度值自适应。

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

响应示例

状态码： 403

更新转码模板失败。

{
  "error_code" : "MPC.10202",
  "error_msg" : "Invalid request parameter."
}

状态码

状态码

描述

204

更新转码模板成功。

403

更新转码模板失败。

错误码

请参见错误码。

分享：

    相关文档

    相关产品

关闭导读