Studio Editing

Add Background Music With Your AI Assistant

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.

add_background_music Asks to Confirm Uses AI Credits Plan-Gated Studio Editing
Try Asking
“Add soft background music under this intro”

How It Behaves

Has an irreversible path, so it is marked destructive and your assistant asks before it runs. The irreversible path: the explicit overwrite_original:true path irreversibly replaces the original's render.

It runs Dadan AI or rendering work, so it uses your plan’s AI credits.

Parameters

NameTypeDescription
video_idRequiredType: stringThe video's guid.
audio_urlRequiredType: stringPublic http(s) URL of the audio file (mp3/wav/…) — the editor fetches it server-side.
volumeType: numberBackground-music volume, 0–1 (e.g. 0.4 = quiet bed). Omit for the editor default.
mute_videoType: booleanMute the original video's audio entirely. To mute AND add music this one call suffices — don't also call adjust_volume.
video_volumeType: numberLevel for the ORIGINAL video's audio, 0–1 (duck under the music).
fade_in_secondsType: numberFade the music in over this many seconds.
fade_out_secondsType: numberFade the music out over this many seconds.
start_from_audio_secondsType: numberStart playback this many seconds INTO the audio file (skip its intro).
overwrite_originalType: booleantrue = OVERWRITE the original video's render in place (irreversible). Default false = renders a NEW copy, original untouched.

You don’t fill these in yourself. Your assistant reads the schema and passes the values from your request.

Description Sent to 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

Good to Know

Does add_background_music Change Anything in My Dadan Account?

Has an irreversible path, so it is marked destructive and your assistant asks before it runs. The irreversible path: the explicit overwrite_original:true path irreversibly replaces the original's render.

Does add_background_music Use AI Credits?

Yes. It runs Dadan AI or rendering work and uses your plan’s AI credits. When credits run out it returns an upgrade_required signal instead of failing silently.

How Do I Use add_background_music?

Connect Dadan to your assistant (setup guides) and ask in plain language, for example: “Add soft background music under this intro”. You never type the tool name; your assistant picks it.

Free to Connect

Give Your Assistant Your Video Library

One URL and one sign-in with the Dadan account you already use. No API key, no client secret, nothing to install.

https://mcp.dadan.io/mcp