音视频合并算子，基于 FFmpeg 对输入的视频和音频素材进行顺序拼接、时长调整和最终合成。算子支持 1 对 1、1 对多、多对 1、多对多等多种输入组合；当视频和音频总时长不一致时，会根据配置自动选择变速对齐或按较短时长裁剪，并将结果视频与处理映射文件上传到 TOS。

算子 ID : las_video_audio_merge

核心能力 #

• 支持多段视频、多段音频顺序拼接。
• 支持视频、音频分别按目标时长预处理后再合成。
• 支持自动选择对齐策略：优先变速，超出阈值时自动裁剪。
• 支持输出最终视频文件和映射文件，便于追踪每次合并的输入、时长和对齐策略。
• 输出目录自动按账号、请求链路和输入哈希隔离，避免不同任务结果互相覆盖。

效果展示 #

支持的地域 #

• 北京：cn-beijing
• 上海：cn-shanghai
• 广州：cn-guangzhou

算子性能 #

输入要求 #

输出要求 #

• 计费标准

  细分项	计费标准说明
  计费项	基于输入视频的时长统计用量进行计费。
  计费类型	按量计费，单位：元/分钟，按实际的计费用量每小时出账。计费精度：毫秒级精度，四舍五入
  单价	0.02 元/分钟

• 计费详情
  计费公式：总费用 = 单价 * 用量

API 调用说明 #

• 本算子的 API 为异步任务接口，您需要通过 Submit 接口提交任务获得任务的 task_id，再通过 Poll 接口获取对应任务（task_id）运行状态，并获取算子处理结果。
• 注意，任务提交后，任务的 task_id 有效期为 3 天，超过 3 天后即无法通过此 task_id 来获取算子处理结果。

Submit #

接口说明 #

调用音视频合并算子提交异步任务，支持多段视频、多段音频的拼接、时长调整和最终合成。

请求参数 #

返回数据 #

示例 #

请求示例

# 请将 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 '{
    "operator_id": "las_video_audio_merge",
    "operator_version": "v1",
    "data": {
        "video_urls": [
            "https://las-demo.tos-cn-beijing.volces.com/las_video_audio_merge/v1/videos/seg_001_0.000-6.000.mp4",
            "https://las-demo.tos-cn-beijing.volces.com/las_video_audio_merge/v1/videos/seg_002_6.000-12.000.mp4"
        ],
        "audio_urls": [
            "https://las-demo.tos-cn-beijing.volces.com/las_video_audio_merge/v1/audio/audio_001.mp3"
        ],
        "output_tos_path": "'$OUTPUT_TOS_PATH'"
    }
}'

返回示例

{
    "metadata": {
        "task_id": "task-20260323153012-abc123",
        "task_status": "PENDING",
        "business_code": "0",
        "error_msg": ""
    }
}

错误码 #

任务进入 FAILED 或 TIMEOUT 后，通过 Poll 返回以下业务错误。错误码实际覆盖范围以服务响应为准。

任务执行阶段业务错误

Poll #

接口说明 #

调用该接口查询音视频合并异步任务的执行状态和结果。

请求参数 #

返回数据 #

示例 #

请求示例

curl --location "https://operator.las.cn-beijing.volces.com/api/v1/poll" --header "Content-Type: application/json" --header "Authorization: Bearer $LAS_API_KEY" --data '{
    "operator_id": "las_video_audio_merge",
    "operator_version": "v1",
    "task_id": "task-20260323153012-abc123"
}'

返回示例

{
  "metadata": {
    "task_id": "task-20260323153012-abc123",
    "task_status": "COMPLETED",
    "submit_time": "2026-07-21T16:04:06+08:00",
    "end_time": "2026-07-21T16:04:16+08:00",
    "business_code": "0",
    "error_msg": ""
  },
  "data": {
    "output_video_path": "tos://your-bucket/output/merge_results/.../merged_result.mp4",
    "output_video_url": "https://example-presigned-url",
    "mapping_json_path": "tos://your-bucket/output/merge_results/.../merged_result_mapping.json"
  }
}

错误码 #

任务进入 FAILED 或 TIMEOUT 后，以下错误码通过 metadata.business_code 和 metadata.error_msg 返回。错误码实际覆盖范围以服务响应为准。

任务执行阶段业务错误