功能描述

此接口用于音频片段拼接合成。您可以通过音频片段合成功能，将多个音频拼接为一个音频并转换为需要的格式。

此接口用于通过 Job 方式创建音频拼接任务。您可以将多个音频片段拼接为一个音频，并按指定容器、码率、采样率等参数输出。任务提交后异步执行，并返回任务 ID（JobId）。

注意事项

音频拼接任务仅支持异步处理，推荐使用 Job 模式。

使用子账号操作时，请先在访问控制 > 权限策略中创建或编辑自定义策略，为当前桶添加 tos:CreateMediaProcessJobs 权限，再将该策略绑定至需要使用本功能的子账号。

PreFragments 与 SurFragments 至少配置一个片段，片段总数不能超过 10 个；加上主音频后最多支持 11 个音频片段。

所有片段拼接完成后的总时长不能超过 1 小时。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
media_jobs	Query	String	是	-	代表媒体任务的请求特殊标识。
job_type	Query	String	是	AudioConcat	任务类型，音频拼接场景下取值仅为 AudioConcat。
Content-Type	Header	String	是	application/json	请求体类型。

请求元素

名称	参数类型	是否必选	示例值	说明
Input	Container	是	-	源音频。
Object	String	是	main.mp3	主音频对象名。主音频位于 PreFragments 之后、SurFragments 之前。父节点：Input
AudioConcatConfig	Container	是	-	音频拼接与输出转码配置。
ContainerFormat	String	是	mp3	输出音频容器格式，取值如下： mp3 aac m4a flac oga ac3 opus wa 父节点：AudioConcatConfig
TimeInterval	Container	否	-	主音频截取时间区间。父节点：AudioConcatConfig
Start	Integer	否	0	主音频截取起始时间，单位毫秒。默认值为 0，表示从起点开始。父节点：TimeInterval
Duration	Integer	否	0	主音频截取持续时长，单位毫秒。默认值为 0，表示截取到音频末尾。父节点：TimeInterval
BitRate	Integer	否	128000	输出音频码率，单位 bps，取值范围为 [8000, 1000000]，值为 0 时表示沿用源音频码率。父节点：AudioConcatConfig
BitRateOpt	Integer	否	0	音频码率选项，取值如下： * 0（默认值）：始终使用目标音频码率。 * 1：源音频码率小于 BitRate 时使用源音频码率。 * 2：源音频码率小于 BitRate 时返回失败。说明该参数需要与 BitRate 参数的值一同设置。父节点：AudioConcatConfig
SampleRate	Integer	否	44100	输出音频采样率，单位 Hz。取值为 0 或对应 ContainerFormat 支持的采样率，值为 0 时表示沿用源音频采样率。说明不同格式支持的采样率有所不同，详情请参见不同音频容器采样率支持情况。父节点：AudioConcatConfig
Channels	Integer	否	2	输出音频声道数。取值为 0 或对应 ContainerFormat 支持的声道数，值为 0 时表示沿用源音频声道数。说明不同格式支持的声道数有所不同，详情请参见不同音频容器参数支持情况。父节点：AudioConcatConfig
SampleFormat	String	否	fltp	输出音频采样格式，留空时表示使用所选容器格式的默认采样格式。可选值包括 fltp、s16、s16p、s32、s32p，具体支持情况取决于 ContainerFormat。说明不同格式支持的采样格式有所不同，详情请参见不同音频容器参数支持情况。父节点：AudioConcatConfig
PreFragments	Array	否	-	前置拼接片段列表，会拼接到主音频之前。PreFragments 与 SurFragments 至少配置一个片段。父节点：AudioConcatConfig
SurFragments	Array	否	-	后置拼接片段列表，会拼接到主音频之后。PreFragments 与 SurFragments 至少配置一个片段。父节点：AudioConcatConfig
Object	String	是	pre.mp3	拼接片段对象名，需与主音频位于同一 Bucket。父节点：PreFragments 或 SurFragments
Start	Integer	否	0	拼接片段截取起始时间，单位毫秒。默认值为 0，表示从片段起点开始。父节点：PreFragments 或 SurFragments
Duration	Integer	否	0	拼接片段截取持续时长，单位毫秒。默认值为 0，表示截取到片段末尾。父节点：PreFragments 或 SurFragments
Output	Container	是	-	输出音频的存储配置。
Region	String	是	cn-beijing	输出音频的存储地域。父节点：Output
Bucket	String	是	test-bucket	存储输出音频的 Bucket。当前仅支持同地域存储输出文件。父节点：Output
Object	String	是	output.mp3	输出音频对象名，建议后缀与 ContainerFormat 保持一致。父节点：Output

不同音频容器参数支持情况

容器格式	编码格式	采样率	采样格式	声道数	码率
mp3	mp3	部分支持	fltp/s16p/s32p	1、2	支持
aac	aac	支持	fltp	1、2、4、5、6、8	支持
flac	flac	支持	s16/s32	1、2、4、5、6、8	不支持
oga	vorbis	支持	fltp	2	不支持
ac3	ac3	部分支持	fltp	1、2、3、4、5、6	支持
opus	opus	部分支持	s16	1、2	支持
wav	pcm_s16le	支持	s16	1、2	不支持

不同音频容器采样率支持情况

容器格式	mp3	aac	flac	oga	ac3	opus	wav
8000	Y	Y	Y	Y	N	Y	Y
11025	Y	Y	Y	Y	N	N	Y
16000	Y	Y	Y	Y	N	Y	Y
22050	Y	Y	Y	Y	N	N	Y
24000	Y	Y	Y	Y	N	Y	Y
32000	Y	Y	Y	Y	Y	N	Y
44100	Y	Y	Y	Y	Y	N	Y
48000	Y	Y	Y	Y	Y	Y	Y
88200	N	Y	Y	Y	N	N	Y
96000	N	Y	Y	Y	N	N	Y

响应消息头

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

响应元素

名称	参数类型	示例值	说明
status	String	OK	状态码。

请求示例

响应示例

对象存储