Add or mix video audio
video_add_audioDestructive
Add, replace, or mix an audio file into an existing video. Adjust volume, fade-in/out, and start offset, then produce a new video.
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 |
|---|---|---|---|
| mix | No | True mixes the new audio with existing video audio; false replaces the original audio track. | |
| 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. | |
| audio_path | Yes | Absolute path to an existing local audio file such as MP3, WAV, M4A, or AAC. | |
| start_time | No | Optional start offset in seconds where the inserted audio begins. | |
| video_path | Yes | Absolute path to an existing local video file. The input file is read only. | |
| 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 | |||