创建转码模板--慢直播-火山引擎

文档中心

立即注册

导航

创建转码模板

最近更新时间：2023.05.22 16:16:31首次发布时间：2023.05.22 16:16:31

创建转码模板。

请求方式

使用 POST 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表，参考「公共参数」。

字段	位置	类型	必填	说明	值
Action	Query	String	是	公共参数，OpenAPI 接口名称	CreateTransTemplate
Version	Query	String	是	公共参数，OpenAPI 接口版本	2021-01-01

Body 参数

字段	类型	必填	说明
TemplateName	String	是	模板名称，支持汉字、大小写字母、数字、中划线
Trans	Array of objects	是	转码配置，参考以下转码配置结构说明

转码配置结构说明

字段	类型	必填	说明
SuffixName	String	是	转码流后缀名。支持10个字符以内的大小写字母、下划线和中划线，注意后缀名不可包含 _uhd、_hd、_sd、_ld、或 _or4，且不可重复使用例如：配置的转码流后缀名为 _flv，则拉转码流时转码的流名为 `stream-123456789_flv`
VideoBitrate	Int	否	视频码率，单位为 bps，取值范围为 [0,30000000]，默认值为 1000000；取 0 时表示使用源流码率
Vcodec	String	是	视频编码格式： h264：使用 H.264 编码格式 h265：使用 H.265 编码格式 copy：不进行转码，所有视频编码参数不生效
AudioBitrate	Int	否	音频码率，单位为 kbps
Acodec	String	否	音频编码格式，默认格式为 acc，支持以下 3 种类型： aac：使用 aac 编码格式 copy：不进行转码，所有音频编码参数不生效 opus：使用 Opus 编码格式
FPS	Int	否	视频帧率，单位为 fps，取值范围为 [0,60]，默认值为 25；帧率越大，画面越流畅
GOP	Int	否	IDR 帧之间的最大间隔，单位为 s，取值范围为 [0,1000]，默认值为 0
Width	Int	否	视频宽度，取值范围为 [0,8192]，默认值为 0 说明：当 As 的取值为 0 时，参数生效，反之则不生效当 As 的取值为 0 时，如果 Width 和 Height 任意取值为 0，表示保持源流尺寸
Height	Int	否	视频高度，取值范围为 [0,8192]，默认值为 0 说明：当 As 的取值为 0 时，参数生效，反之则不生效当 As 的取值为 0 时，如果 Width 和 Height 任意取值为 0，表示保持源流尺寸
As	String	否	宽高自适应模式开关，默认值为 0，支持的取值包括： 0：关闭宽高自适应，按照 Width 和 Height 的取值进行拉伸 1：开启宽高自适应，按照 ShortSide 或 LongSide 等比缩放
ShortSide	Int	否	短边长度，默认值为 0： Roi 取 false 时，取值范围为 [0,4096] Roi 取 true 时，取值范围为 [0,1080] 说明：当 As 的取值为 1 时，参数生效，反之则不生效当 As 的取值为 1 时，如果 LongSide 和 ShortSide 同时取 0，表示保持源流尺寸当 As 的取值为 1 时，如果同时配置 LongSide 和 ShortSide 的值，则按照 ShortSide 进行等比缩放
LongSide	Int	否	长边长度，默认值为 0： Roi 取 false 时，取值范围为 [0,8192] Roi 取 true 时，取值范围为 [0,1920] 说明：当 As 的取值为 1 时，参数生效，反之则不生效当 As 的取值为 1 时，如果 LongSide 和 ShortSide 同时取 0，表示保持源流尺寸当 As 的取值为 1 时，如果同时配置 LongSide 和 ShortSide 的值，则按照 ShortSide 进行等比缩放
BFrames	Int	否	2 个参考帧之间的最大 B 帧数，不同编码格式的取值存在差异： H.264：取值范围为 [0,7]，默认值为 3 H.265：取值范围为 [0,1,2,3,7,15]，默认值为 7 BFrames 取 0 时，表示去 B 帧
Roi	Bool	否	是否高清低码转码： true：高清低码 false：标准转码（默认）

返回结果

返回参数说明

通用返回参数，请参考 ResponseMetadata 结构体说明。

Result 字段包含以下参数：

字段	类型	说明
ID	String	创建成功的转码模板 ID

示例

请求示例

POST https://open.volcengineapi.com?Action=CreateTransTemplate
&Version=2021-01-01
&<公共请求参数>
{
    "TemplateName": "trans-template-01",
    "Trans": {
        "SuffixName": "_flv",
        "VideoBitrate": 2000000,
        "Vcodec": "h264",
        "AudioBitrate": 320,
        "Acodec": "aac",
        "FPS": 25,
        "AudioBitrate": 320,
        "GOP": 100,
        "Width": 720,
        "Height": 1280,
        "As": "1",
        "ShortSide": 1080,
        "LongSide": 1920,
        "BFrames": 3,
        "Roi": true
    }
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023051811194280A4C0C428675B103F05",
        "Action": "CreateTransTemplate",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "ID": "86a8b8ad-cbf8-425d-b662-7e8709xxxxxx"
    }
}