# Add background music (`add_background_music`)
> Mixes a soundtrack over a video from a public audio URL. You set the music level and can optionally mute or duck the original audio.
- Area: [Studio editing](https://mcp.dadan.io/tools/studio-editing.md)
- Access: Makes changes; has an irreversible path, so clients ask to confirm (the explicit overwrite_original:true path irreversibly replaces the original's render)
- AI credits: yes
- Available on read-only connections: no

## Example prompt
"Add soft background music under this intro"

## Parameters
- `video_id` (string, required): The video's guid.
- `audio_url` (string, required): Public http(s) URL of the audio file (mp3/wav/…) — the editor fetches it server-side.
- `volume` (number): Background-music volume, 0–1 (e.g. 0.4 = quiet bed). Omit for the editor default.
- `mute_video` (boolean): Mute the original video's audio entirely. To mute AND add music this one call suffices — don't also call adjust_volume.
- `video_volume` (number): Level for the ORIGINAL video's audio, 0–1 (duck under the music).
- `fade_in_seconds` (number): Fade the music in over this many seconds.
- `fade_out_seconds` (number): Fade the music out over this many seconds.
- `start_from_audio_seconds` (number): Start playback this many seconds INTO the audio file (skip its intro).
- `overwrite_original` (boolean): true = OVERWRITE the original video's render in place (irreversible). Default false = renders a NEW copy, original untouched.

## Description for AI assistants
Mix a soundtrack/background music over a video. audio_url must be a PUBLIC http(s) URL to the audio file — Dadan's editor downloads it server-side. volume (0–1) sets the music level; mute_video or video_volume (0–1) mute/duck the original track; fade_in_seconds/fade_out_seconds add fades; start_from_audio_seconds offsets into the audio file. All times in SECONDS. overwrite_original default false = renders a NEW copy, original untouched; true OVERWRITES the original's render. Returns a processing job — poll get_job_status; rendering takes a while.


## Known limitations

- audio_url must be a publicly reachable http(s) URL supplied by the caller. There is no music library.


## Used in these prompts

- Spin a long video into a Short (Creators & Social): "Pull the best 30 seconds from [link], reframe it vertical, add a punch-in zoom at the key moment, and lay background music from [music link] under it."
Canonical page: https://mcp.dadan.io/tools/add-background-music
