文档中心

对象存储

音频转码

PutAudioConvertTemplate

PutAudioConvertTemplate

功能描述

此接口用于创建音频转码模板。

注意事项

单条规则 body 最大不超过 20KB，最多允许配置 300 条自定义模板。

通过子账号使用时，需要授予当前桶的 PutDataProcessTemplate 权限。

请求消息样式

请求参数和消息头

参数名称	参数类型	是否必填	示例值	说明
process_template	String	是	-	创建音频转码模版标识。
Tag	String	是	AudioConvert	任务类型，音频转码场景下取值仅为 AudioConvert 。

请求元素

参数名称	参数类型	是否必填	示例值	说明
Name	String	是	name	自定义模板名称：仅支持 a-z、A-Z、0-9、_、-和 .，长度不超过 64，开头和结尾字符必须是 a-z、A-Z、0-9。多条规则不能重复。
AudioConvertConfig	Container	是	-	音频转码模板详情信息。
TimeInterval	Container	否	-	指定转码时长。父节点：AudioConvertConfig。
ContainerFormat	String	是	wav	指定转码容器格式，取值列表如下： wav。 mp3。 aac。 flac。 oga ac3 opus m4a 父节点：AudioConvertConfig。
BitRate	Integer	否	128000	音频码率，取值范围[8000, 1000000]，为 0 时使用原音频码率，部分容器不支持指定码率。说明不同格式支持的声道数有所不同，详情请参见不同音频容器参数支持情况。父节点：AudioConvertConfig。
BitRateOpt	Integer	否	0	音频码率选项。取值： 0（默认值）：始终使用目标音频码率。 1：源音频码率小于BitRate时使用源音频码率。 2：源音频码率小于BitRate时返回失败。父节点：AudioConvertConfig。
SampleFormat	String	否	fltp	音频采样格式，不同容器取值范围不同。父节点：AudioConvertConfig。说明不同格式支持的采样率有所不同，详情请参见不同音频容器采样率支持情况。
SampleRate	Integer	否	48000	音频采样率，不同容器取值范围不同。父节点：AudioConvertConfig。说明不同格式支持的采样率有所不同，详情请参见不同音频容器采样率支持情况。
Channels	Integer	否	2	音频声道数，不同容器取值范围不同。父节点：AudioConvertConfig。说明不同格式支持的声道数有所不同，详情请参见不同音频容器参数支持情况。
Start	Integer	否	0	开始时间，单位毫秒，默认值为 0。父节点：TimeInterval 。
Duration	Integer	否	10000	持续时间，单位毫秒，默认值为 0 表示视频时长。父节点：TimeInterval 。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

参数名称	参数类型	示例值	说明
template_id	String	393161343761366633396119012ee2450b08	创建音频转码模板的唯一 ID。

请求示例

响应示例

最近更新时间：2026.08.03 15:17:35

这个页面对您有帮助吗？

有用

有用

无用

无用