文档中心

对象存储

视频转码

CreateConcatJob

CreateConcatJob

功能描述

此接口用于创建音视频拼接任务。您可以将多个音视频片段按指定顺序拼接为一个输出文件。

注意事项

音视频拼接任务仅支持异步处理。

输出文件后缀必须与 Format 参数保持一致。

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

请求消息样式

请求参数和消息头

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

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

请求元素

名称	参数类型	是否必选	示例值	说明
Input	Container	是	-	源文件。
Object	String	是	sample-1.mp4	源音视频文件名称。父节点：Input。
ConcatConfig	Container	是	-	音视频拼接任务具体配置。
ConcatFragments	Array of Object	是	-	待拼接片段列表。父节点：ConcatConfig。
Object	String	是	sample-1.mp4	当前片段对象名称。父节点：ConcatFragments。
FragmentIndex	Integer	是	0	当前片段顺序编号，取值必须大于等于 0。父节点：ConcatFragments。
StartTime	Integer	否	0	当前片段截取起始时间，单位毫秒。父节点：ConcatFragments。
EndTime	Integer	否	10000	当前片段截取结束时间，单位毫秒。父节点：ConcatFragments。
Container	Container	是	-	输出容器配置。父节点：ConcatConfig。
Format	String	是	mp4	输出封装格式，支持 mp4、mkv、avi、ts、mp3、aac 和 flac 格式。父节点：Container。
Video	Container	否	-	视频编码参数，字段含义与 CreateTranscodeJob 中 Video 参数一致。父节点：ConcatConfig。
Audio	Container	否	-	音频编码参数，字段含义与 CreateTranscodeJob 中 Audio 参数一致。父节点：ConcatConfig。
Output	Container	是	-	拼接后文件的存储配置。
Region	String	是	cn-beijing	拼接后文件的存储地域。父节点：Output。
Bucket	String	是	testbkt	拼接后文件所在 Bucket。父节点：Output。
Object	String	是	output.mp4	拼接后文件名称，后缀必须与 Format 参数保持一致。父节点：Output。

响应消息头

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

响应元素

名称	参数类型	示例值	说明
Code	String	OK	状态码。
Message	String	Success	请求状态信息。
JobId	String	187919df106a49aa402300013e6ba5bf0593	音视频拼接任务 ID。

请求示例

响应示例

最近更新时间：2026.09.16 11:14:21

这个页面对您有帮助吗？

有用

有用

无用

无用