音视频合并算子，基于 FFmpeg 对输入的视频和音频素材进行顺序拼接、时长调整和最终合成。算子支持 1 对 1、1 对多、多对 1、多对多等多种输入组合；当视频和音频总时长不一致时，会根据配置自动选择变速对齐或按较短时长裁剪，并将结果视频与处理映射文件上传到 TOS。 # 算子介绍 > 算子 ID : las_video_audio_merge ## 核心能力 * 支持多段视频、多段音频顺序拼接。 * 支持视频、音频分别按目标时长预处理后再合成。 * 支持自动选择对齐策略：优先变速，超出阈值时自动裁剪。 * 支持输出最终视频文件和映射文件，便于追踪每次合并的输入、时长和对齐策略。 * 输出目录自动按账号、请求链路和输入哈希隔离，避免不同任务结果互相覆盖。 ## 效果展示 * 输入视频 [video](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c8e5b80dd2ad4761a20bef5c8e9879a2~tplv-goo7wpa0wc-image.image) * 输入音频 [audio](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/151ef9122ffd4f3087eb51a3b854b1b6~tplv-goo7wpa0wc-image.image) [下载旁白.MP3](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/151ef9122ffd4f3087eb51a3b854b1b6~tplv-goo7wpa0wc-image.image) * 合并后视频 [video](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/35e656a841a040bf81774fd741861699~tplv-goo7wpa0wc-image.image) * 音视频合并映射文件 [output_1782101516_mapping.json](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b564ed2102b24e0fa08fe15bb68c147b~tplv-goo7wpa0wc-image.image) ——用于记录输入素材、解析后时长和最终对齐策略。 ## 支持的地域 * 北京：cn\-beijing * 上海：cn\-shanghai * 广州：cn\-guangzhou ## 算子性能 |细分项 |性能影响说明 | |---|---| |最大 RPM |600 | |最大并发数 |10 | |耗时 |* 输入视频时长、重编码、变速和裁剪策略可能影响处理耗时。

* 多段素材且需要时长调整时通常会触发重编码，耗时高于简单拼接。 | # 输入与输出要求 ## 输入要求 |细分 |详细要求 | |---|---| |支持的输入数据模态 |* 视频

* 音频 | |输入格式：视频 |* 格式：.mp4, .mov, .mkv, .avi, .webm, .m4v

* 其他：`video_urls` 和 `audio_urls` 都必须传入，且都不能为空。 | |输入格式：音频 |* 格式：.mp3, .wav, .aac, .m4a, .flac, .ogg

* 其他：`video_urls` 和 `audio_urls` 都必须传入，且都不能为空。 | |输入路径要求 |通过请求参数 `video_urls`、 `audio_urls`提供给算子输入数据，按数组顺序拼接，当前支持公网 URL、TOS 路径这两种方式。

* 公网 URL：公网可访问的视频 URL，格式为 `http/https`。

* TOS 路径：将待处理数据上传至与当前 LAS 服务同主账号、同地域的 TOS Bucket后，可提供 TOS 路径，格式为`tos://bucket_name/demo`。 | ## 输出要求 |细分 |详细要求 | |---|---| |输出数据模态 |* 视频 | |输出路径：TOS |通过请求参数`output_tos_path` 指定算子输出结果的存储路径，当前支持设置为 TOS 路径。

* TOS 路径：与LAS服务同主账号、同地域下，有可写权限的 TOS Bucket 目录。 | # 计费说明 * 计费标准 |细分项 |计费标准说明 | |---|---| |计费项 |基于**输入视频的时长**统计用量进行计费。 | |计费类型 |按量计费，单位：`元/分钟`，按实际的计费用量每小时出账。计费精度：毫秒级精度，四舍五入 | |单价 |0.02 元/分钟 | * 计费详情计费公式：`总费用 = 单价 * 用量` # 注意与前提 |细分项 |注意与前提 | |---|---| |开通 LAS |* 如果您是一个全新的火山引擎用户，此前未开通过 LAS 产品，您可先开通 LAS，不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见[准备工作](https://docs.volcengine.com/docs/6492/1264537)。

* 开通完成后可查看算子介绍文档，了解算子能力、上手引导等，详情可参见：[LAS 智能数据处理算子](https://docs.volcengine.com/docs/6492/1798368)。 | |费用 |调用算子前，您需先了解使用算子时的模型调用费用，详情请参见[大模型调用计费](https://www.volcengine.com/docs/6492/1544808)。 | |鉴权（API Key） |调用算子前，您需要先生成算子调用的API Key，并建议将API Key配置为环境变量，便于更安全地调用算子，详情请参见[获取 API Key 并配置](https://docs.volcengine.com/docs/6492/2191994)。 | |BaseURL |调用算子前，您需要先根据您当前使用的LAS服务所在地域，了解算子调用的BaseURL，用于配置算子调用路径参数取值。

详情请参见[获取 Base URL](https://docs.volcengine.com/docs/6492/2191993)，下文中的调用示例仅作为参考，实际调用时需替换为您对应地域的路径取值。 | # **Rest API 调用** ## API 调用说明 * 本算子的 API 为异步任务接口，您需要通过 `Submit` 接口提交任务获得任务的 `task_id`，再通过 `Poll` 接口获取对应任务（`task_id`）运行状态，并获取算子处理结果。 * 注意，任务提交后，任务的 `task_id` 有效期为 3 天，超过 3 天后即无法通过此 `task_id` 来获取算子处理结果。 ## Submit ### 接口说明调用音视频合并算子提交异步任务，支持多段视频、多段音频的拼接、时长调整和最终合成。 ### 请求参数 **operator_id** string 必选 `示例值: las_video_audio_merge` 算子 ID。 **operator_version** string 必选 `示例值: v1` 算子版本。 **data** VideoAudioMergeUserReqParams 必选音视频合并请求参数。 **video_urls** list of string 必选 `示例值: ["tos://bucket/input/video_01.mp4", "tos://bucket/input/video_02.mp4"]` 视频输入列表，至少包含 1 项，按数组顺序拼接。支持公网可访问的 HTTP/HTTPS URL，以及与 LAS 服务同主账号、同地域且当前身份可读的 `tos://bucket/key`。支持 `.mp4`、`.mov`、`.mkv`、`.avi`、`.webm`、`.m4v`。TOS 路径以 `/` 结尾时会展开目录下的视频文件；如需精确控制顺序及 `video_durations` 对应关系，建议显式传入对象路径。 **audio_urls** list of string 必选 `示例值: ["tos://bucket/input/audio_01.mp3"]` 音频输入列表，至少包含 1 项，按数组顺序拼接。支持公网可访问的 HTTP/HTTPS URL，以及与 LAS 服务同主账号、同地域且当前身份可读的 `tos://bucket/key`。支持 `.mp3`、`.wav`、`.aac`、`.m4a`、`.flac`、`.ogg`。不支持目录展开。 **output_tos_path** string 必选 `示例值: tos://bucket/output/merge_results/` 输出根目录，必须是与 LAS 服务同主账号、同地域且当前身份可写的 TOS 目录，推荐以 `/` 结尾。服务会在该根目录下追加账号、请求链路和输入哈希等隔离子目录；最终写入位置以 Poll 返回路径为准。路径格式不合法或无访问权限时返回 `Tos.AccessFailed`。 **output_basename** string `Optional` `示例值: merged_result` 输出文件基名，不包含目录和扩展名。不传时由系统自动生成；建议仅使用字母、数字、下划线和中划线。最终生成 `{output_basename}.mp4` 和 `{output_basename}_mapping.json`。包含路径分隔符、扩展名或非法字符时返回 `Parameter.Invalid`。 **video_durations** list of float `Optional` `示例值: [6.0, 6.0]` 视频片段目标时长，单位秒。传入时长度必须等于目录展开后的最终视频数量，并按最终输入顺序逐项对应；每个值必须大于 `0`。服务会按目标时长对片段进行裁剪或变速，实际策略记录在映射 JSON 中。长度不一致、元素非数值或非正数时返回 `Parameter.Invalid`。 **audio_durations** list of float `Optional` `示例值: [12.0]` 音频片段目标时长，单位秒。传入时长度必须等于 `audio_urls` 数量，并按输入顺序逐项对应；每个值必须大于 `0`。服务会按目标时长对片段进行裁剪或变速，实际策略记录在映射 JSON 中。长度不一致、元素非数值或非正数时返回 `Parameter.Invalid`。 **max_speed_ratio** float `Optional` `示例值: 1.25` 音视频对齐允许的最大变速倍率，取值范围 `[1.0, 3.0]`，默认 `1.25`。所需倍率不超过该值时，按 `speed_control_target` 调整指定一侧；超过该值时不继续大幅变速，而是按较短一侧时长裁剪输出。该参数会影响输出时长和处理耗时。 **speed_control_target** string `Optional` `示例值: audio` 对齐时优先变速的对象。`audio`：默认值，优先调整音频速度以匹配视频总时长；`video`：优先调整视频速度以匹配音频总时长。若所需倍率超过 `max_speed_ratio`，则退化为按较短一侧裁剪。其他值返回 `Parameter.Invalid`。 ### 返回数据 **metadata** metadata 请求元信息 **task_id** string `示例值: task-xxx` 异步模式下的任务 ID，用于作业状态查询。 **task_status** string `示例值: PENDING` 异步模式下的任务状态。 * PENDING, 接收请求 * RUNNING, 正在运行 * COMPLETED, 已完成 * FAILED, 失败 * TIMEOUT, 超时 **business_code** string `示例值: 0` 业务码。 **error_msg** string 如有异常，会返回详细错误信息。 ### 示例 #### 请求示例 ```Bash # 请将 OUTPUT_TOS_PATH 设置为本账号上可写入的 tos 路径 export OUTPUT_TOS_PATH="tos://path/to/merge_results" curl --location "https://operator.las.cn-beijing.volces.com/api/v1/submit" \ --header "Content-Type: application/json" \ --header "Authorization: Bearer $LAS_API_KEY" \ --data @- <

AI 数据湖服务