更新时间:2024-04-15 GMT+08:00
分享

修改转码模板

功能介绍

修改转码模板。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

PUT /v2/{project_id}/asset/template/transcodings

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参考获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Authorization

String

使用AK/SK方式认证时必选,携带的鉴权信息。

X-Sdk-Date

String

使用AK/SK方式认证时必选,请求的发生时间。

表3 请求Body参数

参数

是否必选

参数类型

描述

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

高清低码开关,编码格式多路共同参数

表4 QualityInfoList

参数

是否必选

参数类型

描述

video

VideoInfo object

模板视频信息。video和audio至少配置一个参数。

audio

AudioInfo object

模板音频信息

表5 VideoInfo

参数

是否必选

参数类型

描述

quality

String

画质

  • 4K默认分辨率3840*2160,码率8000kbit/s

  • 2K默认分辨率2560*1440,码率7000kbit/s

  • FULL_HD默认分辨率1920*1080,码率3000kbit/s

  • HD默认分辨率1280*720,码率1000kbit/s

  • SD默认分辨率854*480,码率600kbit/s

  • FLUENT默认分辨率480*270,码率300kbit/s

width

Integer

视频宽度

height

Integer

视频高度

bitrate

Integer

码率,单位:kbit/s

frame_rate

Integer

帧率(默认为0,0代表自适应,单位是帧每秒)

表6 AudioInfo

参数

是否必选

参数类型

描述

sample_rate

String

音频采样率(有效值范围)

  • AUDIO_SAMPLE_AUTO (default),

  • AUDIO_SAMPLE_22050:22050Hz

  • AUDIO_SAMPLE_32000:32000Hz

  • AUDIO_SAMPLE_44100:44100Hz

  • AUDIO_SAMPLE_48000:48000Hz

  • AUDIO_SAMPLE_96000:96000Hz

bitrate

Integer

音频码率(单位:Kbps)

channels

String

声道数(有效值范围)

  • AUDIO_CHANNELS_1:单声道

  • AUDIO_CHANNELS_2:双声道

  • AUDIO_CHANNELS_5_1:5.1声道

表7 CommonInfo

参数

是否必选

参数类型

描述

pvc

Boolean

高清低码开关

video_codec

String

视频编码格式

audio_codec

String

音频编码格式

  • AAC:AAC格式 (default)

  • HEAAC1:HEAAC1格式

  • HEAAC2:HEAAC2格式

  • MP3:MP3格式

is_black_cut

Boolean

黑边剪裁类型,默认false不开启黑边剪裁

format

String

格式

hls_interval

Integer

分片时长,范围2-10(默认为5秒)

upsample

Boolean

上采样

adaptation

String

  • SHORT:短边自适应

  • LONG:长边自适应

  • NONE:宽高自适应

响应参数

状态码: 400

表8 响应Body参数

参数

参数类型

描述

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

处理失败返回。

错误码

请参见错误码

分享:

    相关文档

    相关产品