文档首页 > > API参考> 自定义转码模板组接口> 新建转码模板组

新建转码模板组

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

功能介绍

新建转码模板组,最多支持一进六出。

调试

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

URI

POST /v1/{project_id}/template_group/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参数

参数

是否必选

参数类型

描述

name

String

模板组名称

videos

Array of VideoObj objects

视频信息列表

audio

Audio object

音频信息

video_common

VideoCommon object

视频通用信息

common

Common object

通用信息

表4 VideoObj

参数

是否必选

参数类型

描述

width

Integer

视频宽度(单位:像素)

  • H264:范围[32,4096],必须为2的倍数

  • H265:范围[320,4096],必须是4的倍数

height

Integer

视频高度(单位:像素)

  • H264:范围[32,2880],必须为2的倍数

  • H265:范围[240,2880],必须是4的倍数

bitrate

Integer

输出平均码率。

取值范围:0或[40,30000]之间的整数。

单位:kbit/s

若设置为0,则输出平均码率为自适应值。

表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 VideoCommon

参数

是否必选

参数类型

描述

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。

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],默认值为4 。

  • 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表示自适应

单位:帧每秒

aspect_ratio

Integer

纵横比,图像缩放方式

black_cut

Integer

黑边剪裁类型

取值如下:

  • 0:不开启黑边剪裁

  • 1:开启黑边剪裁,低复杂度算法,针对长视频(>5分钟)

  • 2:开启黑边剪裁,高复杂度算法,针对短视频(<=5分钟)

表7 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时,不能设置视频参数。

响应参数

状态码为 201 时:

表8 响应Body参数

参数

参数类型

描述

template_group

TemplateGroup object

模板组信息。

表9 TemplateGroup

参数

参数类型

描述

group_id

String

模板组id

name

String

模板组名称

template_ids

Array of integers

模板组模板ID

videos

Array of VideoAndTemplate objects

视频信息列表

audio

Audio object

音频信息

video_common

VideoCommon object

视频通用信息

common

Common object

通用信息

表10 VideoAndTemplate

参数

参数类型

描述

template_id

Integer

模板ID

width

Integer

视频宽度(单位:像素)

  • H264:范围[32,4096],必须为2的倍数

  • H265:范围[320,4096],必须是4的倍数

height

Integer

视频高度(单位:像素)

  • H264:范围[32,2880],必须为2的倍数

  • H265:范围[240,2880],必须是4的倍数

bitrate

Integer

输出平均码率。

取值范围:0或[40,30000]之间的整数。

单位:kbit/s

若设置为0,则输出平均码率为自适应值。

表11 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

表12 VideoCommon

参数

参数类型

描述

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。

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],默认值为4 。

  • 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表示自适应

单位:帧每秒

aspect_ratio

Integer

纵横比,图像缩放方式

black_cut

Integer

黑边剪裁类型

取值如下:

  • 0:不开启黑边剪裁

  • 1:开启黑边剪裁,低复杂度算法,针对长视频(>5分钟)

  • 2:开启黑边剪裁,高复杂度算法,针对短视频(<=5分钟)

表13 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时,不能设置视频参数。

状态码为 400 时:

表14 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

```
POST https://{endpoint}/v1/{project_id}/template_group/transcodings
{
  "name" : "test_group",
  "videos" : [{
          "width" : "480",
          "height" : "270",
          "bitrate" : "200"
      }
  ],
  "audio" : {
      "codec" : 1,
      "sample_rate" : 1,
      "channels" : 2,
      "bitrate" : 0
  },
  "video_common" : {
      "codec" : 1,
      "black_cut" : 0,
      "aspect_ratio" : 0,
      "profile" : 3,
      "level" : 15,
      "preset" : 3,
      "ref_frames_count" : 4,
      "max_iframes_interval" : 5,
      "bframes_count" : 4,
      "frame_rate" : 0
  },
  "common" : {
      "PVC" : 0,
      "pack_type" : 1,
      "hls_interval" : 5,
      "dash_interval" : 5
  }
}
```

响应示例

状态码

状态码

描述

201

新建转码模板组成功。

400

新建转码模板组失败。

错误码

请参见错误码

分享:

    相关文档

    相关产品

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

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问