The audio-video merging operator is based on FFmpeg and performs sequential concatenation, duration adjustment, and final synthesis of the input video and audio materials. The operator supports various input combinations, including one-to-one, one-to-many, many-to-one, and many-to-many. When the total durations of the video and audio are inconsistent, it automatically selects speed adjustment or trims to the shorter duration based on the configuration, and uploads the resulting video and processing mapping file to TOS.

Operator ID: las_video_audio_merge

Core capabilities #

• Supports sequential concatenation of multiple video and audio segments.
• Supports preprocessing video and audio separately according to target duration before merging.
• Supports automatic selection of alignment strategy: prioritizes speed adjustment, and automatically trims when exceeding the threshold.
• Supports output of the final video file and mapping file, facilitating tracking of the inputs, durations, and alignment strategy for each merge.
• The output directory is automatically isolated by account, request chain, and input hash to prevent results of different tasks from overwriting each other.

Effect demonstration #

Supported regions #

• Beijing: cn-beijing
• Shanghai: cn-shanghai
• Guangzhou: cn-guangzhou

Operator performance #

Input requirements #

Output requirements #

• Billing standards

  Sub-items	Billing standards description
  Billing item	Billing is based on usage calculated from the duration of the input video.
  Billing type	Usage-based billing, unit: CNY/minute, billed hourly based on actual usage.
  Unit price	0.02 CNY/minute

• Billing details
  Billing formula: Total cost = unit price * usage

Submit #

Interface description #

Invoke the audio-video merge operator to submit an asynchronous task, supporting concatenation of multiple video and audio segments, duration adjustment, and final synthesis.

Request parameters #

Response parameters #

Example #

Request example

# Please set OUTPUT_TOS_PATH to a tos path writable by your account
export OUTPUT_TOS_PATH="tos://path/to/merge_results"

curl --location "https://operator.las.ap-southeast-1.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"
    }
}'

Response example

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

Error codes #

Poll #

Interface description #

Invoke the audio-video merge operator to submit an asynchronous task, supporting concatenation of multiple video and audio segments, duration adjustment, and final synthesis.

Request parameters #

Response parameters #

Example #

Request example

curl --location "https://operator.las.ap-southeast-1.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"
}'

Response example

{
    "metadata": {
        "task_id": "task-20260323153012-abc123",
        "task_status": "COMPLETED",
        "submit_time": "2026-07-21T16:04:06+08:00",
        "end_time": "2026-07-21T16:04:06+08:00",
        "business_code": "0",
        "error_msg": ""
    },
    "data": {
        "output_video_path": "tos://path/to/merge_results/123456/trace-20260323-abc123/4d8d4a3f0a3c1d2e_1742726400/merged_result.mp4",
        "mapping_json_path": "tos://path/to/merge_results/123456/trace-20260323-abc123/4d8d4a3f0a3c1d2e_1742726400/merged_result_mapping.json"
    }
}