AI MediaKit 的多轨道剪辑工具，支持视频、音频、图片、文字、字幕等多轨道编辑，同时支持转场、特效、花字、滤镜、裁剪、变速、音量调节等增强效果。您通过一个结构化的 `track` 时间线，配合 `canvas`（画布）、`output`（输出）等配置，以声明式的方式描述完整的剪辑意图，工具即可据此合成最终成片。任务完成后，您将获得合成产物的下载地址。多轨道剪辑适用于短视频批量合成、模板化二次创作、图文视频混排、画中画、分屏视频墙等场景。 ## 核心概念多轨道剪辑的所有参数都围绕**画布 → 轨道 → 元素 → 滤镜**这一四层模型组织。四层之间是自顶向下的包含关系：画布承载多条轨道，轨道容纳多个元素，元素再叠加滤镜。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/0c2d70ba55f14d1bbcb6fd903bedf6b5) 在时间线上，多条轨道自下而上叠放，每条轨道内的元素按 `target_time` 先后排列： ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/f67d03317d80440d911f6d6be8aa034b) |层级 |对应参数 |说明 | |---|---|---| |画布（Canvas） |`canvas` |最终输出视频的画板，定义了输出视频的宽高和背景色。所有视觉元素最终都会被渲染到这块画布上。 | |轨道（Track） |`track` |用于组织和分层不同的素材。`track` 是一个二维数组，代表多条轨道。轨道索引越大，渲染层级越高。 | |元素（Element） |`track[i][j]` |放置在轨道上的具体内容单元，如一段视频、一张图片、一段文字或一个特效。每个元素都有自己的类型 `type` 和在时间线上占据的时间段 `target_time`。 | |滤镜（Filter） |元素的 `extra` 数组 |附加在元素上的特殊效果，用于改变元素的视觉或听觉表现，例如裁剪、变换、调色、变速、转场等。 | ### 画布（Canvas）画布定义了最终输出视频的分辨率和背景色，是所有视觉元素的渲染底板。您可以通过 `canvas.width`/`canvas.height` 直接指定分辨率（单位：像素，取值范围 [160, 8192]），通过 `canvas.background_color` 指定背景色。若不传 `canvas`，系统会根据输入资源与输出配置自动确定画布。详见[自定义画布](https://docs.volcengine.com/docs/6448/2673939#%E8%87%AA%E5%AE%9A%E4%B9%89%E7%94%BB%E5%B8%83)。 ### 轨道（Track）与渲染层级 `track` 是多轨道剪辑的核心，定义了剪辑的时间线。您可以把它想象成专业剪辑软件中的多层轨道，用于在时间和空间上组织所有内容。`track` 本身是一个二维数组，格式为 `track[轨道索引][元素索引]`： * 第一维（外层数组）：代表轨道列表。索引 `[轨道索引]` 决定了轨道的渲染层级。`track` 数组中索引越大，轨道层级越高，高层轨道的视觉内容会覆盖在低层轨道之上。 * `track[0]`：最底层，通常放置背景视频或主视频。 * `track[1]`：位于 `track[0]` 之上，可放置画中画、贴纸、动态特效等。 * `track[2]`：位于 `track[1]` 之上，可放置全局文字标题或字幕，以此类推。 * 第二维（内层数组）：代表单条轨道，包含在该轨道上排列的一个或多个元素。同一轨道内的多个元素在时间上可以前后相接，但不应重叠。 ```JSON "track": [ // --- 轨道 0 (track[0])：最底层 --- [ {"type": "video", "target_time": [0, 5000], "source": "..."}, // 元素 track[0][0] {"type": "video", "target_time": [5000, 10000], "source": "..."} // 元素 track[0][1] ], // --- 轨道 1 (track[1])：叠加在轨道 0 之上 --- [ {"type": "text", "target_time": [1000, 4000], "text": "标题"} // 元素 track[1][0] ] ] ``` ### 元素（Element）类型每个元素通过 `type` 指定类型，通过 `target_time` 指定其在输出时间线上的起止位置。素材类元素通过 `source` 指定素材地址，文字类元素通过 `text` 指定文本内容。支持的元素类型如下： |`type` 取值 |分类 |说明 |必填字段 | |---|---|---|---| |`video` |核心媒体 |视频 |`type`、`target_time`、`source` | |`audio` |核心媒体 |音频 |`type`、`target_time`、`source` | |`image` |核心媒体 |图片 |`type`、`target_time`、`source` | |`text` |叠加内容 |文字（含花字），`text` 字段填文本内容 |`type`、`target_time`、`text` | |`subtitle` |叠加内容 |字幕，`text` 字段填字幕文件（如 SRT）URL |`type`、`target_time`、`text` | |`effect` |叠加内容 |特效，通过 `extra` 中的滤镜定义特效内容 |`type`、`target_time` | |`gaussian` |特殊效果 |高斯模糊，对指定资源整体做模糊 |`type`、`target_time`、`source` | |`text_roll` |特殊效果 |文字滚屏，适用于文字滚动推广视频 |`type`、`target_time`、`text` |

说明

各元素类型支持的完整字段见提交多轨道剪辑任务 API。

### 滤镜（Filter）分类滤镜是附加在元素上的特殊效果，定义在元素的 `extra` 数组中。一个元素可以叠加多个滤镜。每个滤镜通过 `type` 指定类型，并携带该类型的专属字段。 |类别 |滤镜（`type` 取值） |说明 |可添加的元素类型 | |---|---|---|---| |时间与裁剪 |`trim` |时间截取，从原始素材中截取一个时间片段 |`video`、`audio` | ||`crop` |画面裁剪，从画面中裁剪出一个矩形区域 |`video`、`image` | ||`speed` |倍速，调整播放速度（范围 [0.1, 4]） |`video`、`audio` | |变换与布局 |`transform` |2D 变换，控制元素在画布上的位置、大小、旋转、透明度 |`video`、`image`、`text` | |视觉效果 |`lut_filter` |调色滤镜，应用预设调色效果 |`video`、`image`、`effect` | ||`effect_filter` |视觉特效，添加分屏、镜像等效果 |`video`、`image`、`effect` | ||`equalizer` |画面均衡，调整亮度、饱和度、色调 |`video`、`image` | ||`delogo` |局部模糊，在指定区域应用模糊（常用于遮标） |`video`、`image` | ||`gaussian` |高斯模糊，对整个元素或背景应用模糊 |`video`、`image`、`gaussian` | |动画与转场 |`transition` |转场，在同轨道相邻视频元素间创建过渡 |`video` | ||`video_animation` |视频动画，添加入场、出场或循环动画 |`video`、`image` | ||`text_animation` |文字动画，为文字添加入场、出场或循环动画 |`text` | |音频处理 |`a_fade` |音频淡入淡出 |`audio`、`video` | ||`a_volume` |音量调节（`0` 为静音） |`audio`、`video` |

说明

各滤镜的完整参数、资源 ID 取值见见提交多轨道剪辑任务 API及本文末尾资源 ID。

### 轨道布局实践您可以根据元素的性质，将它们放置在不同的轨道上，以实现复杂的视觉叠加和音频混合效果。 * 视觉轨道：包含 `video`、`image`、`text`、`effect` 等具有视觉表现的元素，在合成时遵循「上层覆盖下层」的渲染规则。常见布局实践： * 轨道 0（底层）：放置主视频片段或背景图片。 * 轨道 1（中层）：放置画中画视频、贴纸或动态特效。 * 轨道 2（顶层）：放置全局文字标题或字幕。 * `video` 和 `image` 元素可以放在同一个轨道上。 * `subtitle` 元素必须独占一个轨道，且字幕轨道总数不超过 10 条。 * 音频轨道：包含 `audio` 元素，以及 `video` 元素自带的音轨，在合成时遵循「混音」规则（而非覆盖）。您可以创建一个或多个专门放置 `audio` 元素的轨道，例如：一个轨道放全程背景音乐，另一个轨道放特定时段的旁白或音效。 ## 快速体验：合成一个含花字的视频本节将演示如何合成一段视频并在其上叠加一段花字，帮助您跑通多轨道剪辑的完整异步流程。 ### 准备工作 * **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**。 * **准备素材文件**：准备待合成的视频、音频、图片等素材，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ### 操作流程多轨道剪辑是一个异步任务，完整的调用流程如下： 1. 成功调用 `POST /api/v1/tools/multi-track-edit` 提交任务后，API 将返回一个任务 ID（`task_id`）。 2. 您可以轮询[查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532)查询任务状态，直到 `status` 变为 `completed`；或者使用[事件回调](https://docs.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，从响应的 `result` 字段中获取输出视频下载地址（`video_url`）。 #### 第 1 步：提交多轨道剪辑任务您需要调用[提交多轨道剪辑任务 API](https://docs.volcengine.com/docs/6448/2673861)。可直接复制以下 cURL 命令，提交一个多轨道剪辑任务：第一条轨道放置一段视频（0~5000 毫秒），第二条轨道叠加一段花字（0~3000 毫秒）。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "track": [ [ { "type": "video", "source": "https://example.com/clip.mp4", "target_time": [0, 5000] } ], [ { "type": "text", "text": "示例花字", "target_time": [0, 3000], "extra": [ { "type": "transform", "width": 1000, "height": 200, "pos_x": 40, "pos_y": 860 } ] } ] ], "output": { "format": "mp4", "fps": 30 } }' ```

说明

将 {Your_API_Key} 替换为您的有效 API Key。

track[][].source：替换为您自己的素材地址。

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-multi-track-edit-123456789", "request_id": "20260901130000ABCDEFG12345" } ``` #### 第 2 步：获取任务结果多轨道剪辑需要一定处理时间，您需要通过轮询[查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532)来获取最终结果，直到任务状态变为 `completed`。 ```Bash curl -X GET 'https://mediakit.cn-beijing.volces.com/api/v1/tasks/{task_id}' \ -H 'Authorization: Bearer {Your_API_Key}' ```

说明

将 URL 末尾的 {task_id} 替换为第 1 步返回的任务 ID。

任务成功完成后，您将收到如下响应。`result.video_url` 即为输出视频的下载地址（签名 URL，有效期 24 小时，请及时下载保存），同时返回输出总时长（`duration`，单位秒）与输出分辨率（`resolution`）。 ```JSON { "success": true, "task_id": "amk-tool-multi-track-edit-123456789", "request_id": "20260901130000ABCDEFG12345", "status": "completed", "result": { "video_url": "https://example.volcvideo.com/multi_track_output.mp4?auth_key=...", "duration": 5.0, "resolution": "1080p" }, "expires_at": 1777464650, "created_at": 1777291767, "finished_at": 1777291851 } ``` ## 进阶使用在跑通基础流程后，您可以通过下列参数进一步控制输出效果。 ### 控制输出封装与帧率通过 [output 对象](https://docs.volcengine.com/docs/6448/2673861#output-%E5%AF%B9%E8%B1%A1)配置可控制输出的封装格式、帧率、是否含 alpha 通道以及音视频开关。以下示例演示了如何仅输出音频，并封装为 MP3 格式。 ```JSON { "track": [ [ {"type": "audio", "source": "https://example.com/bgm.mp3", "target_time": [0, 10000]} ] ], "output": { "format": "mp3", "disable_video": true } } ``` ### 自定义画布通过 `canvas` 参数可定义最终输出视频的分辨率、背景色和比例策略： * `canvas.width` 和 `canvas.height`：直接指定画布宽高（单位：像素，取值范围 [160, 8192]），也支持表达式（见[示例 7：通过表达式指定画布宽高](https://docs.volcengine.com/docs/6448/2673939#%E7%A4%BA%E4%BE%8B-6%EF%BC%9A%E9%80%9A%E8%BF%87%E8%A1%A8%E8%BE%BE%E5%BC%8F%E6%8C%87%E5%AE%9A%E7%94%BB%E5%B8%83%E5%AE%BD%E9%AB%98)）。 * `canvas.background_color`：画布背景色（RGBA 十六进制），如 `#000000FF`。 * 按比例生成画布：配合 `output.canvas_with_ratio=true`，使用 `canvas.long`（长边）、`canvas.short`（短边，优先级高于 `long`）、`canvas.ratio`（如 `16:9`）和 `canvas.index`（对齐方向的元素索引，`MAX` 表示跟随最大分辨率资源）。 * 跟随最大分辨率：设置 `output.canvas_with_max=true`，让画布分辨率与输入资源中的最大分辨率保持一致。

说明

画布分辨率优先级（由高到低）：canvas.width/canvas.height（Int 型）\> output.canvas_with_max \> output.canvas_with_ratio \> canvas.width/canvas.height（String 表达式）。

以下示例演示了如何设置一个 1080x1920、黑色背景的自定义画布。 ```JSON { "track": [ [ {"type": "video", "source": "https://example.com/clip.mp4", "target_time": [0, 5000]} ] ], "canvas": { "width": 1080, "height": 1920, "background_color": "#000000FF" } } ``` ### 注入 AIGC 元数据标识如需为生成式内容添加合规标识，可通过 [extra_param.upload 对象](https://docs.volcengine.com/docs/6448/2673861#extra-param-upload-%E5%AF%B9%E8%B1%A1)传入 AIGC 元数据的 JSON 对象字符串。其字段遵循国家《人工智能生成合成内容标识办法》相关规范，常用字段包括 `Label`、`ContentProducer`、`ProduceID` 等。 ```JSON { "track": [ [ {"type": "video", "source": "https://example.com/clip.mp4", "target_time": [0, 5000]} ] ], "extra_param": { "upload": { "aigc_meta": "{\"Label\":\"1\",\"ContentProducer\":\"multi-track-edit-test\",\"ProduceID\":\"produce-test-001\"}" } } } ``` ## 常见场景示例以下示例覆盖多轨道剪辑最常见的场景。 ### **示例 1：多个视频时域拼接并添加转场** **场景**：将多个独立的视频片段按时间顺序拼接，并在片段之间添加转场动画，使衔接更自然。 **实现要点**：转场滤镜 `transition` 用于在同一条轨道的相邻视频元素（下文称 A 和 B）之间创建过渡效果，并且必须添加在前一个元素（A）的 `extra` 数组中。根据您设置 `target_time` 的方式和所选转场资源的不同，分为非交叠转场和交叠转场两种模式。 * **交叠转场**：前后两个元素在时间线上需要有重叠部分，转场效果将在该重叠时段内发生。所有转场类型都支持此模式。 * 实现方式：设置 A 元素的 `target_time` 和 B 元素的 `target_time` 使其重叠，重叠时长应等于或大于 `transition` 的 `duration`。 * 示例：A 的 `target_time` 为 `[0, 5000]`，B 的 `target_time` 为 `[4000, 9000]`，在 A 上设置 `duration` 为 `1000` 的转场。效果将在 `[4000, 5000]` 区间内呈现。 * 示例代码（交叠转场）：以下示例将两个视频的时间线重叠 1000ms，并使用“风车”转场在重叠区域创建过渡。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "canvas": {"width": 1280, "height": 720}, "track": [ [ { "type": "video", "source": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/landscape_video_1.mp4", "target_time": [0, 5000], "extra": [ { "type": "transition", "source": "vcr://trdtb04021788232582582ep", "duration": 1000 } ] }, { "type": "video", "source": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/landscape_video_2.mp4", "target_time": [4000, 9000] } ] ] }' ``` * **非交叠转场**：前后两个元素在时间线上精确衔接，无重叠。转场效果发生在衔接点，系统会自动将 A 元素的末尾和 B 元素的开头进行重叠以应用转场。 * 实现方式：设置 A 元素的 `target_time` 结束时间等于 B 元素的 `target_time` 开始时间。 * 限制：仅当[转场 ID](https://docs.volcengine.com/docs/6448/2673939#%E8%BD%AC%E5%9C%BA-id)表格中“是否可用于非交叠转场”标记为“是”的转场资源才支持此模式。若对不支持的资源使用此模式，转场不会生效。 * 示例：A 为 `[0, 5000]`，B 为 `[5000, 10000]`，在 A 上设置 `duration` 为 `1000` 的非交叠转场。实际效果是 A 在 `4500ms` 结束，B 在 `5500ms` 开始，中间 `[4500, 5500]` 为转场动画时间。 * 示例代码：以下示例将两个视频无缝拼接，并使用“晚霞转场”进行过渡。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "canvas": {"width": 1280, "height": 720}, "track": [ [ { "type": "video", "source": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/landscape_video_1.mp4", "target_time": [0, 10000], "extra": [ { "type": "transition", "source": "vcr://trdtb20601788232583204ep", "duration": 3000 } ] }, { "type": "video", "source": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/landscape_video_2.mp4", "target_time": [10000, 20000] } ] ] }' ``` ### 示例 2：视频多段截取合成 **场景**：从一个长视频中截取多个不连续的精彩片段，重新合成为一个集锦视频。 **实现要点**： * 在同一条轨道上，为同一个源视频创建多个 `video` 元素。 * 每个元素使用 `trim` 滤镜指定从源视频中截取的原始时间段。 * 每个元素的 `target_time` 定义该截取片段在最终时间线上的新位置。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "canvas": {"width": 1280, "height": 720}, "track": [ [ { "type": "video", "source": "https://example.com/long_video.mp4", "target_time": [0, 10000], "extra": [ {"type": "trim", "start_time": 5000, "end_time": 15000} ] }, { "type": "video", "source": "https://example.com/long_video.mp4", "target_time": [10000, 20000], "extra": [ {"type": "trim", "start_time": 25000, "end_time": 35000} ] } ] ] }' ``` ### 示例 3：多视频空域拼接（分屏视频墙） **场景**：将三个独立视频在空间上垂直排列，拼接成一个更高分辨率的视频，常用于视频墙、对比展示。 **实现要点**： * 设置画布尺寸：创建一个能容纳所有视频拼接后总尺寸的画布。本例假设每个源视频为 1280×720，则最终画布宽 1280、高 720×3 = 2160。 * 使用多轨道：将每个视频元素放置在独立的轨道上。 * 精确定位：为每个视频添加 `transform` 滤镜，通过 `pos_x`、`pos_y` 设置其在画布上的左上角坐标。 * 时间对齐：所有视频元素的 `target_time` 保持一致，以确保它们同时播放。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "canvas": {"width": 1280, "height": 2160}, "track": [ [ { "type": "video", "source": "https://example.com/clip_1.mp4", "target_time": [0, 10000], "extra": [{"type": "transform", "width": 1280, "height": 720, "pos_x": 0, "pos_y": 0}] } ], [ { "type": "video", "source": "https://example.com/clip_2.mp4", "target_time": [0, 10000], "extra": [{"type": "transform", "width": 1280, "height": 720, "pos_x": 0, "pos_y": 720}] } ], [ { "type": "video", "source": "https://example.com/clip_3.mp4", "target_time": [0, 10000], "extra": [{"type": "transform", "width": 1280, "height": 720, "pos_x": 0, "pos_y": 1440}] } ] ] }' ``` ### 示例 4：画中画（小窗叠加） **场景**：在主视频之上叠加一个缩小的画中画视频（如解说小窗、双人同框）。 **实现要点**： * 主视频放在底层轨道（`track[0]`），铺满整个画布。 * 画中画视频放在上层轨道（`track[1]`），通过 `transform` 滤镜缩小尺寸并定位到画面一角（本例定位到右下角）。 * 上层轨道渲染在下层之上，因此画中画会叠加显示在主视频上方。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "canvas": {"width": 1280, "height": 720}, "track": [ [ {"type": "video", "source": "https://example.com/main_video.mp4", "target_time": [0, 10000]} ], [ { "type": "video", "source": "https://example.com/pip_video.mp4", "target_time": [0, 10000], "extra": [ {"type": "transform", "width": 400, "height": 225, "pos_x": 840, "pos_y": 455} ] } ] ] }' ``` ### 示例 5：添加背景音乐和文字标题 **场景**：为一个视频添加全程背景音乐和居中的文字标题。 **实现要点**： * 使用三条轨道，分别放置视频、音频和文字。 * 音频元素的 `target_time` 覆盖整个视频时长，并可用 `a_volume` 滤镜降低音量。 * 文字元素通过 `transform` 滤镜控制其在画布上的位置和大小，通过 `align_type` 控制文本对齐方式。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "canvas": {"width": 1920, "height": 1080}, "track": [ [ {"type": "video", "source": "https://example.com/main_video.mp4", "target_time": [0, 10000]} ], [ { "type": "audio", "source": "https://example.com/bgm.mp3", "target_time": [0, 10000], "extra": [{"type": "a_volume", "volume": 0.3}] } ], [ { "type": "text", "text": "我们的精彩旅程", "target_time": [1000, 9000], "font_type": "SY_Black", "font_size": 120, "font_color": "#FFFFFFFF", "align_type": 1, "extra": [ {"type": "transform", "width": 1800, "height": 200, "pos_x": 60, "pos_y": 440} ] } ] ] }' ``` ### 示例 6：添加字幕文件并应用滤镜 **场景**：为一个视频添加 SRT 格式字幕文件，并对整个视频应用“老友记”风格的调色滤镜。 **实现要点**： * 字幕元素（`type: "subtitle"`）必须独占一条轨道，其 `text` 字段填字幕文件的公网可访问 URL。 * 调色滤镜通过 `lut_filter` 实现，作为 `extra` 添加到视频元素上，`source` 填滤镜 ID。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "canvas": {"width": 1280, "height": 720}, "track": [ [ { "type": "video", "source": "https://example.com/video_to_filter.mp4", "target_time": [0, 20000], "extra": [ {"type": "lut_filter", "source": "vcr://trdtb01861788407632929ep", "intensity": 0.8, "target_time": [0, 20000]} ] } ], [ { "type": "subtitle", "text": "https://example.com/subtitles/sample.srt", "target_time": [0, 20000], "font_type": "ALi_PuHui", "font_size": 60, "extra": [ {"type": "transform", "width": 1200, "height": 150, "pos_x": 40, "pos_y": 550} ] } ] ] }' ``` ### 示例 7：通过表达式指定画布宽高 **场景**：让画布尺寸自动匹配某个元素的宽高，无需手动填写分辨率。 **实现要点**：`canvas` 的 `width`/`height` 支持通过表达式引用某个元素的宽高，格式为 `$轨道索引|元素索引.w`（宽）或 `.h`（高）。以下示例让画布宽高自动取 `track[0][0]` 元素的宽和高。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "track": [ [ {"type": "video", "source": "https://example.com/clip.mp4", "target_time": [0, 5000]} ] ], "canvas": { "width": "$0|0.w", "height": "$0|0.h" } }' ``` ### 示例 8：添加高斯模糊背景 **场景**：将一个较小的视频居中放置，并让其背景呈现高斯模糊效果。 **实现要点**：在 `video` 元素上同时添加 `transform`（定位与缩放）和 `gaussian`（背景模糊）滤镜。若画布分辨率与素材分辨率不一致，系统会自动等比缩放并居中裁剪原视频，然后将模糊后的版本作为背景。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "canvas": {"width": 1280, "height": 720}, "track": [ [ { "type": "video", "source": "https://example.com/test.mp4", "target_time": [0, 10000], "extra": [ {"type": "transform", "width": 640, "height": 360, "pos_x": 0, "pos_y": 0}, {"type": "gaussian", "radius": 30, "sigma": 30, "target_time": [0, 10000]} ] } ] ] }' ``` ### 示例 9：对元素进行高斯模糊 **场景**：对整个元素本身进行高斯模糊处理。 **实现要点**：使用 `gaussian` 元素类型，并为其添加 `gaussian` 滤镜。这与示例 7 不同，此方法不是生成模糊背景，而是将 `source` 指向的资源本身整体模糊化。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "canvas": {"width": 1280, "height": 720}, "track": [ [ { "type": "gaussian", "source": "https://example.com/test.mp4", "target_time": [0, 10000], "extra": [ {"type": "transform", "width": 640, "height": 360, "pos_x": 0, "pos_y": 0}, {"type": "gaussian", "radius": 30, "sigma": 30, "target_time": [0, 10000]} ] } ] ] }' ``` ### 示例 10：为视频与文字添加入场/出场动画 **场景**：为画面元素添加入场、出场动画，提升视觉表现力。 **实现要点**： * 视频/图片元素通过 `video_animation` 滤镜添加动画，`anim_res` 填视频动画 ID，并用 `anim_start_time`/`anim_end_time` 指定动画在元素内的作用时段（相对元素、单位毫秒）。 * 文字元素通过 `text_animation` 滤镜添加动画，可分别指定入场（`anim_in_res` + `anim_in_duration`）、出场（`anim_out_res` + `anim_out_duration`）。入场与出场时长之和须小于文字展示时长。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/multi-track-edit' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "canvas": {"width": 1280, "height": 720}, "track": [ [ { "type": "video", "source": "https://example.com/clip.mp4", "target_time": [0, 8000], "extra": [ {"type": "video_animation", "anim_res": "1180337", "anim_start_time": 0, "anim_end_time": 1000} ] } ], [ { "type": "text", "text": "精彩瞬间", "target_time": [1000, 7000], "font_type": "SY_Black", "font_size": 100, "font_color": "#FFFFFFFF", "align_type": 1, "extra": [ {"type": "transform", "width": 1200, "height": 200, "pos_x": 40, "pos_y": 260}, {"type": "text_animation", "anim_in_res": "1181434", "anim_in_duration": 800, "anim_out_res": "1181498", "anim_out_duration": 800} ] } ] ] }' ``` ## 参考信息 ### 计费说明多轨道剪辑按输出视频时长（结合输出分辨率的计费换算系数）计费。关于详细的计费规则与价格，请参阅[剪辑工具计费](https://docs.volcengine.com/docs/6448/2486459)。 ### 资源 ID 调色滤镜（`lut_filter`）、视觉特效（`effect_filter`）、转场（`transition`）、视频/文字动画（`video_animation`/`text_animation`）以及文字元素的花字（`text_res`）、字体（`font_type`）等，均通过资源 ID 引用预设素材。 #### 滤镜 ID 用于 `lut_filter` 滤镜的 `source` 字段。 |滤镜 ID |滤镜名称 |示例图 |描述 | |---|---|---|---| |`vcr://trdtb01861788407632929ep` |老友记 |

|粉色樱花调滤镜，浪漫春日，适合春天、人像、情感类内容。 | #### 转场 ID 用于 `transition` 滤镜的 `source` 字段。 |转场 ID |转场名称 |是否可用于非交叠转场 |示例图 |描述 | |---|---|---|---|---| |`vcr://trdtb04021788232582582ep` |风车 |否 |

|模拟时钟指针旋转扫过画面，逐区域揭示下一段内容，适合时间主题、倒计时类视频。 | |`vcr://trdtb35781788232582409ep` |水滴 |否 |

|水滴滴落扩散的波纹效果，以涟漪方式渐入下一段素材，适合清新、自然风格的画面过渡。 | |`vcr://trdtb50121788232582880ep` |飞眼 |是 |

|两个圆形交替出现覆盖画面，实现节奏分明的切换，适合快节奏、动感的内容衔接。 | |`vcr://trdtb56921788232582239ep` |风吹 |否 |

|从对角线方向逐步擦除当前画面，显露下一段素材，简洁利落的几何过渡效果。 | |`vcr://trdtb65351788232582724ep` |六角形 |是 |

|通用遮罩层覆盖过渡，通过形状遮罩实现两段画面的平滑切换，适配多种场景。 | |`vcr://trdtb76971788232581919ep` |百叶窗 |否 |

|圆形从中心向外扩大打开，平滑显露下一段画面，经典通用的聚焦式过渡效果。 | #### 特效 ID 用于 `effect_filter` 滤镜的 `source` 字段。 |特效 ID |特效名称 |示例图 |描述 | |---|---|---|---| |`vcr://trdtb06761788268503426ep` |六分屏 |

|画面2×2四宫格分割，四画面同屏展示，适合多场景、多角色内容。 | #### 视频动画 ID 用于 `video_animation` 滤镜的 `anim_res` 字段。 **入场动画** |分类 |ID |效果展示 | |---|---|---| |圆形扫开 |1180355 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_dae02469013b0125aa142775d53f6d10.gif) | |向右滑入 |1180331 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_758606a2e74c33f5189cc76998bc7106.gif) | |向左滑入 |1180332 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d1be342fd228eebca3f2de7bb6f34f89.gif) | |向下滑入 |1180333 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5b75f1ce1a0faaba45badebb97d4dac3.gif) | |向上滑入 |1180334 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_eb487a1b02a4c96b079a92de47c55bfc.gif) | |缩小 |1180335 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_963a9eaf2fdb3b76b54167a62bd8bb56.gif) | |溶解显示 |1180336 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_98532f40c271e368fd3f10c27c10954b.gif) | |渐显 |1180337 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_11a2c1ca446008a59e309a130307fb26.gif) | |放大 |1180338 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5ddebf5664e05b22543e4f7ddca422e2.gif) | |向右擦开 |1180339 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_de8cbef6e4b2c6bf669561a006fa67b1.gif) | |向左擦开 |1180340 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4a86351d43d583f6dafcb6a3f023d3d1.gif) | |向下擦开 |1180341 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f1ef6441dc1f38a915ac787bad14aafb.gif) | |向上擦开 |1180342 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f4c126446e74a4f3389bbe10cb97a04c.gif) | **出场动画** |分类 |ID |效果展示 | |---|---|---| |圆形扫除 |1180375 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ecf5b25c6875366c437c9548c6e145d5.gif) | |向左滑出 |1180376 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cb827a398f088e253ee8cd37d3d03f07.gif) | |向右滑出 |1180377 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a8fd753a4e0b0aa42c6d2e6cdf0498d0.gif) | |向下滑出 |1180378 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f017b4cd096987e09c59dfc4724ab0f4.gif) | |向上滑出 |1180379 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_22bb5235728bbfee9c14c56d7ad78b01.gif) | |缩小消失 |1180380 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_49f436b4f60f5d695b9fcd4689442cde.gif) | |溶解消失 |1180381 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_fcb906ffd59cd03a7bfe893ec5ed66e4.gif) | |渐隐 |1180382 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c4fa72a4179134e4ec34a64c66b9e9c5.gif) | |向左擦除 |1180383 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_177fd7b2df107541582552c0a8aab0e8.gif) | |向右擦除 |1180384 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_fdefdcb984d4499acc6aa512017e9ef2.gif) | |向下擦除 |1180385 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a687d5998ef20add7abe7b807bb4f085.gif) | |向上擦除 |1180386 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e38ee94a98554113b3f2e63c944c3b55.gif) | |翻转 |1180403 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c60ca80966f0143d139a02a19d751895.gif) | #### 文字动画 ID 用于 `text_animation` 滤镜的 `anim_in_res`（入场）、`anim_out_res`（出场）、`anim_loop_res`（循环）字段。 **入场动画** |分类 |ID |效果展示 | |---|---|---| |圆形扫开 |1181455 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6d2b015e1a3fddc50ec95e83d9732839.gif) | |溶解显示 |1181425 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_82c723659ae475a8b60f61852dd9d902.gif) | |向右擦开 |1181426 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4e2efde0312d6da9f4c9773e153df3b4.gif) | |向左擦开 |1181427 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d59133d0d40a52b5fc797641484aa94d.gif) | |向下擦开 |1181428 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_63fddfbcaebf6905b0391d3b237d874f.gif) | |向上擦开 |1181429 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5ad48991a3a34f76071a7d1379f7241e.gif) | |向左滑入 |1181430 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e9a59172052bbe0d956638c68469bb33.gif) | |向右滑入 |1181431 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_54d05c35b689d2d2c054d47ef619cb28.gif) | |向下滑入 |1181432 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e097a9842c5390114cdd8dbdda8e0aef.gif) | |向上滑入 |1181433 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_490ba7e045ced53c90a64f69ff94b172.gif) | |渐显 |1181434 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5378927478a5bcb61757112f44e52e31.gif) | |放大 |1181435 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2b6f6c95ee6fe94662e712fc2d294826.gif) | |羽化向下擦开 |1181436 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7191466f351d7c33ece4e6973959ec14.gif) | |羽化向左擦开 |1181437 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d723e09b0cdfcf77c16c5aebd3043c7a.gif) | |羽化向上擦开 |1181438 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5db9f4e9808f1ed19c4cd27cbc6b034f.gif) | |羽化向右擦开 |1181439 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_975c97f5ac6ad4a73ad7001b78ec2c9c.gif) | **出场动画** |分类 |ID |效果展示 | |---|---|---| |向右擦除 |1181497 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c7543133bde9f7bf5f72a08367e4a4af.gif) | |向左擦除 |1181498 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d79db13deb45ed7fcd6c5ec2455633ef.gif) | |向下擦除 |1181499 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3839f2a90b6906e075e9fb1425ebc3a6.gif) | |向上擦除 |1181500 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2698e64c6b59acdcb55aa845a612ae9b.gif) | |渐隐 |1181501 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0ad64cd76ead4e77696873bee8c63061.gif) | |圆形扫除 |1181502 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_228ad1cde869748d5a11b37d3e703186.gif) | |溶解消失 |1181503 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d9b355dba07cd12c35e9ab57bcccbbcc.gif) | |缩小消失 |1181504 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a1fd1ebe2d4b671810958f74d8b3c650.gif) | |向右滑出 |1181505 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c2da18ca38cdc7a0b6813b915b726cb1.gif) | |向左滑出 |1181506 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_58db38880c203832e31a3ccd80bc0252.gif) | |向下滑出 |1181507 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3a6bde5de1b7b6f3cb2be5d99369ec5d.gif) | |向上滑出 |1181508 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8a569b85983b7f2b17a60300c33447de.gif) | |羽化向下擦除 |1181509 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b5efb1a96a1d21356b9670df1e8ce1f8.gif) | |羽化向左擦除 |1181510 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_90e9ba6f088140de0d21a3f6fc75064a.gif) | |羽化向右擦除 |1181511 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d4db2c9f6f65c8c6731d8bb6c3729464.gif) | |羽化向上擦除 |1181512 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_99fb2558d0d78c1159e189f7557a1fb9.gif) | **循环动画** |分类 |ID |效果展示 | |---|---|---| |波浪 |1181555 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_536fdcd5319efe3625a6391e086be10d.gif) | |翻转 |1181551 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f3e31236c518328ac187a7c34c21ef82.gif) | #### 字体 ID 用于文字/字幕元素的 `font_type` 字段。除了使用下表中的预设字体 ID，您还可以通过为 `font_type` 字段传入 TTF/OTF 格式字体文件的公网可访问 URL 来使用自定义字体。

说明

火山引擎不提供方正系列字体的商业授权，如需商用，您必须自行联系方正公司获取，以免产生侵权风险。除方正系列字体外，其余均为开源字体，可放心商用。

|分类 |ID |效果展示 | |---|---|---| |站酷意大利体 |1187225 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e5dbdb74f44eb7a46a7a92594a16c221.jpeg)

该字体不支持中文。 | |站酷仓耳渔阳体 |1187223 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a3be2c7315c670ce1bb2d571be0eed8d.jpeg) | |站酷高端黑 |1187221 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e9a617c782e929098d4348e7ab5d8fd2.jpeg) | |站酷酷黑体 |1187219 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6492633dc080cd71b17c9f929143beb5.jpeg) | |站酷快乐体 |1187217 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f8991433faf8d5b3e559f323f0c52eb0.jpeg) | |站酷文艺体 |1187213 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_16f62b1d3fd670ef2ef7d3966c05f179.jpeg) | |站酷小薇 LOGO 体 |1187211 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e62a37ef4826aa69a3d62abefe78888a.jpeg) | |思源黑体 |SY_Black |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/dfc615c3691d47fbad990550721a5dfa~tplv-goo7wpa0wc-image.image)

| |阿里巴巴普惠体 |ALi_PuHui |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8bc5efde3a8b493c8ed379c770fa6829~tplv-goo7wpa0wc-image.image)

| |庞门正道标题体 |PM_ZhengDao |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/aabc23aba33d45d18718ba272740a0a1~tplv-goo7wpa0wc-image.image)

| #### 花字 ID 用于文字元素的 `text_res` 字段。 |花字 ID |花字名称 |示例图 |描述 | |---|---|---|---| |`vcr://trdtb14471788233563490ep` |蓝色阴影泛光 |

|蓝色发光边框文字，冷调科技感，适合科技、商务、数据类视频。 | ## 相关 API 文档 * [提交多轨道剪辑任务 API](https://docs.volcengine.com/docs/6448/2673861) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)