修改转码模板
功能介绍
修改转码模板。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
PUT /v2/{project_id}/asset/template/transcodings
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方法请参考获取项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token,使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
Authorization |
否 |
String |
使用AK/SK方式认证时必选,携带的鉴权信息。 |
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选,请求的发生时间。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
group_id |
是 |
String |
模板组ID |
name |
否 |
String |
模板组名称 |
is_default |
否 |
Boolean |
是否是默认转码模板,默认false不设置为默认 |
is_auto_encrypt |
否 |
Boolean |
是否加密,默认false不加密 |
quality_info_list |
是 |
Array of QualityInfoList objects |
画质配置信息列表,如果不携带或者携带为空,则不更新模板中该部分数据。 |
watermark_template_ids |
否 |
Array of strings |
绑定的水印模板组ID数组 |
description |
否 |
String |
模板介绍 |
common |
是 |
CommonInfo object |
高清低码开关,编码格式多路共同参数 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
video |
否 |
VideoInfo object |
模板视频信息。video和audio至少配置一个参数。 |
audio |
否 |
AudioInfo object |
模板音频信息 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
quality |
是 |
String |
画质
|
width |
否 |
Integer |
视频宽度 |
height |
否 |
Integer |
视频高度 |
bitrate |
是 |
Integer |
码率,单位:kbit/s |
frame_rate |
是 |
Integer |
帧率,单位是帧每秒。 取值范围:0或[5,60]之间的整数。 默认为0,0代表自适应。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
sample_rate |
是 |
String |
音频采样率(有效值范围)
|
bitrate |
否 |
Integer |
音频码率(单位:Kbps) |
channels |
是 |
String |
声道数(有效值范围)
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
pvc |
是 |
Boolean |
高清低码开关 |
video_codec |
是 |
String |
视频编码格式 |
audio_codec |
否 |
String |
音频编码格式
|
is_black_cut |
否 |
Boolean |
黑边剪裁类型,默认false不开启黑边剪裁 |
format |
是 |
String |
格式 |
hls_interval |
是 |
Integer |
分片时长,范围2-10(默认为5秒) |
upsample |
否 |
Boolean |
上采样 |
adaptation |
否 |
String |
|
响应参数
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
请求示例
修改转码模板
PUT https://{endpoint}/v2/{project_id}/asset/template/transcodings Content-Type: application/json { "group_id": "f9b045e0811c482f9de0d436a5927bb6", "name": "trans_template_test", "is_default": true, "quality_info_list": [ { "video": { "width": 1280, "height": 720, "bitrate": 1000, "quality": "HD", "frame_rate": 0 }, "audio": { "sample_rate": "AUDIO_SAMPLE_AUTO", "channels": "AUDIO_CHANNELS_1", "bitrate": 0 } } ], "watermark_template_ids": [], "common": { "pvc": false, "video_codec": "H264", "audio_codec": "AAC", "format": "HLS", "hls_interval": 5 } }
响应示例
状态码: 400
处理失败返回。
{ "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }
状态码
状态码 |
描述 |
---|---|
200 |
处理成功返回。 |
400 |
处理失败返回。 |
错误码
请参见错误码。