描述 #

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

使用限制 #

• video_urls 和 audio_urls 都必须传入，且都不能为空。
• 输入源支持 http/https 和 tos://。
• output_tos_path 必须是当前账号可写的 TOS 目录。
• video_durations 与 audio_durations 如有传入，长度必须分别与展开后的 video_urls、audio_urls 数量一致，且每个时长都必须大于 0。
• max_speed_ratio 取值范围为 1.0 ~ 3.0。当音视频时长差异超出该范围时，算子会退化为按较短一侧裁剪，而不是继续大幅变速。

核心功能 #

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

性能说明 #

• 总耗时主要取决于输入文件数量、总时长、分辨率、编码格式以及是否需要重编码。
• 多段素材拼接且伴随时长调整时，通常会触发重编码，耗时会明显高于简单直传拼接。
• 建议优先使用同 Region 的 TOS 读写，以获得更稳定的下载和上传性能。

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": ""
    }
}

错误码 #

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"
}'

返回示例

"{\n  \"metadata\": {\n    \"task_id\": \"task-20260323153012-abc123\",\n    \"task_status\": \"COMPLETED\",\n    \"business_code\": \"0\",\n    \"error_msg\": \"\"\n  },\n  \"data\": {\n    \"output_video_path\": \"tos://path/to/merge_results/123456/trace-20260323-abc123/4d8d4a3f0a3c1d2e_1742726400/merged_result.mp4\",\n    \"mapping_json_path\": \"tos://path/to/merge_results/123456/trace-20260323-abc123/4d8d4a3f0a3c1d2e_1742726400/merged_result_mapping.json\",\n  }\n}"