> ## Documentation Index
> Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Background Music

> Set or remove a video's looping background music track.

Set one video-wide audio track that loops over the whole video and is included in exports. This is separate from per-clip sound effects. Volume ranges from 0 to 1 and defaults to 0.2.

## set\_background\_music

Set or replace the video's background music track, from Tella's curated music or from your own audio.

For a curated track, call `list_library` with `scope: "default"` and `type: "music"` and pass the item's `presetId` — there is nothing to upload. For your own audio, call `create_source` first (`kind: "audio"` with the track's duration), `PUT` the audio bytes to the returned `uploadUrl`, then pass the `sourceId` here.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="presetId" type="string">
  Required unless `sourceId` is given. Preset ID of a curated Tella music track, from a `default` item of type `music` in `list_library`
</ParamField>

<ParamField path="sourceId" type="string">
  Required unless `presetId` is given. Audio source ID from `create_source` (`kind: "audio"`)
</ParamField>

<ParamField path="volume" type="number">
  Volume from 0 to 1 (default 0.2)
</ParamField>

<ParamField path="name" type="string">
  Display name for the track — defaults to the preset's name when `presetId` is given
</ParamField>

## remove\_background\_music

Remove the video's background music track.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>


## Related topics

- [Remove background music](/docs/api-reference/videos/remove-background-music.md)
- [Set background music](/docs/api-reference/videos/set-background-music.md)
- [Add background music to your video](/docs/help/editing/add-background-music-to-your-video.md)
- [Adjust audio levels](/docs/help/editing/adjust-audio-levels.md)
- [Media library API](/docs/media-library-api.md)