## 功能描述此接口用于创建音视频拼接任务。您可以将多个音视频片段按指定顺序拼接为一个输出文件。 ## 注意事项 * 音视频拼接任务仅支持异步处理。 * 输出文件后缀必须与 `Format` 参数保持一致。 * 使用子账号操作时，请先在[访问控制](https://console.volcengine.com/iam/identitymanage/user) ** \> 权限策略**中创建或编辑**自定义策略**，为当前桶添加 `CreateMediaProcessJobs` 权限，再将该策略绑定至需要使用本功能的子账号。 ## 请求消息样式 ```JSON POST /?job_type=Concat&media_jobs= HTTP/1.1 Host: {BucketName}.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Content-Type: application/json Content-Length: Authorization: authorization string { "Input": { "Object": "sample-1.mp4" }, "ConcatConfig": { "ConcatFragments": [ { "Object": "sample-1.mp4", "FragmentIndex": 0, "StartTime": 0, "EndTime": 10000 }, { "Object": "sample-2.mp4", "FragmentIndex": 1, "StartTime": 0, "EndTime": 10000 } ], "Container": { "Format": "mp4" }, "Video": { "Codec": "h264", "Width": 1280, "Height": 720, "PixFmt": "yuv420p" }, "Audio": { "Codec": "aac", "SampleRate": 44100, "Channels": 2 } }, "Output": { "Region": "cn-beijing", "Bucket": "testbkt", "Object": "output.mp4" } } ``` ## 请求参数和消息头该请求使用的公共请求消息头，请参见[公共参数](https://docs.volcengine.com/docs/6349/75044)。 |名称 |位置 |参数类型 |是否必选 |示例值 |说明 | |---|---|---|---|---|---| |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 ](https://docs.volcengine.com/docs/6349/2129095)[ ](https://docs.volcengine.com/docs/6349/2129095)中 `Video` 参数一致。

父节点：`ConcatConfig`。 | |Audio |Container |否 |\- |音频编码参数，字段含义与 [CreateTranscodeJob ](https://docs.volcengine.com/docs/6349/2129095)[ ](https://docs.volcengine.com/docs/6349/2129095)中 `Audio` 参数一致。

父节点：`ConcatConfig`。 | |Output |Container |是 |\- |拼接后文件的存储配置。 | |Region |String |是 |cn\-beijing |拼接后文件的存储地域。

父节点：`Output`。 | |Bucket |String |是 |testbkt |拼接后文件所在 `Bucket`。

父节点：`Output`。 | |Object |String |是 |output.mp4 |拼接后文件名称，后缀必须与 `Format` 参数保持一致。

父节点：`Output`。 | ## 响应消息头该请求返回的公共响应消息头，请参见[公共参数](https://docs.volcengine.com/docs/6349/75044)。 ## 响应元素 |名称 |参数类型 |示例值 |说明 | |---|---|---|---| |Code |String |OK |状态码。 | |Message |String |Success |请求状态信息。 | |JobId |String |187919df106a49aa402300013e6ba5bf0593 |音视频拼接任务 ID。 | ## 请求示例 ```JSON POST /?job_type=Concat&media_jobs= HTTP/1.1 Host: {BucketName}.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Content-Type: application/json Content-Length: Authorization: authorization string { "Input": { "Object": "sample-1.mp4" }, "ConcatConfig": { "ConcatFragments": [ { "Object": "sample-1.mp4", "FragmentIndex": 0 }, { "Object": "sample-2.mp4", "FragmentIndex": 1 } ], "Container": { "Format": "mp4" } }, "Output": { "Region": "cn-beijing", "Bucket": "testbkt", "Object": "output.mp4" } } ``` ## 响应示例 ```JSON HTTP/1.1 200 OK x-tos-id-2: f91b0c03a01300c1-a444ed0 x-tos-request-id: f91b0c03a01300c1-a444ed0 Date: Fri, 30 Jul 2021 06:45:39 GMT server: TosServer Content-Length: 80 { "Code": "OK", "Message": "Success", "JobId": "187919df106a49aa402300013e6ba5bf0593" } ```

对象存储