视频点播 VOD-创建自定义转码模板:请求参数

时间:2024-08-29 18:57:02

请求参数

表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参数

参数

是否必选

参数类型

描述

name

String

模板组名称

is_default

Boolean

是否设置成默认转码模板,默认false不设置为默认

is_auto_encrypt

Boolean

配置是否加密输出音视频,默认false不加密。

当前只支持加密输出HLS格式的音视频流,不会对原始上传的音视频进行加密处理。非HLS转码输出的音视频格式,此字段不可配置。开启此配置前,请参考《VOD用户指南》的“HLS加密设置”章节获取密钥URL。

quality_info_list

Array of QualityInfoList objects

画质配置信息列表

common

CommonInfo object

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

watermark_template_ids

Array of strings

绑定的水印模板组ID数组

description

String

模板介绍

表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或[5,60]之间的整数。

默认为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:按设置宽高适应,为默认值。按照转码模板设置的宽高输出。

说明:
  • V1接口(已废弃)不支持设置该参数,默认按SHORT处理。V2接口默认按NONE处理,V1和V2接口默认值有差异,在调用时需要注意该参数值的设置。

  • 控制台是通过V2接口创建的转码模板,实际与V1接口创建转码模板的默认值保值一致,为SHORT。

preset

Integer

编码质量等级,取值[0,2] 0表示默认方式,1表示转码效率优先,2表示转码质量优先。

max_iframes_interval

Integer

I帧最大间隔,取值范围:[2,10]。默认值:5,单位秒。

hls_audio_separate

Boolean

转码后音频是否独立存储。

support.huaweicloud.com/api-vod/CreateTranscodeTemplate.html