Add or mix video audio
video_add_audioDestructive
Add, replace, or mix an audio file into a video with control over volume, fade effects, and start time. Renders a new output file from local files.
Instructions
Add, replace, or mix an audio file into an existing video and render a new output file. The source video and audio are read only; output_path is created or overwritten. Controls volume, fade-in, fade-out, mix/replace mode, and optional start time.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| video_path | Yes | Absolute path to an existing local video file. The input file is read only. | |
| audio_path | Yes | Absolute path to an existing local audio file such as MP3, WAV, M4A, or AAC. | |
| volume | No | Audio gain from 0.0 to 2.0, where 1.0 preserves original loudness. | |
| fade_in | No | Non-negative fade-in duration in seconds applied to the inserted audio. | |
| fade_out | No | Non-negative fade-out duration in seconds applied near the inserted audio end. | |
| mix | No | True mixes the new audio with existing video audio; false replaces the original audio track. | |
| start_time | No | Optional start offset in seconds where the inserted audio begins. | |
| output_path | No | Destination video path. Auto-generated when omitted; an existing supplied path may be overwritten. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||