Skip to main content
PUT
Set background music

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Unique video identifier

Example:

"vid_abc123def456"

Body

application/json

Set the video's background music from either your own uploaded audio (sourceId) or Tella's curated catalog (presetId)

name
string

Optional display name for the track. Defaults to the preset's name when presetId is given.

Example:

"Calm Product Tour"

presetId
string

Preset ID of a curated Tella music track, from a default item of type music in GET /v1/library. Nothing to upload. Mutually exclusive with sourceId; exactly one is required.

Example:

"calm-product-tour"

sourceId
string

Audio source ID from POST /v1/sources (kind: "audio"). Mutually exclusive with presetId; exactly one is required.

Example:

"su_abc123def456"

volume
number
default:0.2

Track volume from 0 (silent) to 1 (full volume)

Required range: 0 <= x <= 1
Example:

0.2

Response

Background music set

backgroundMusic
object
required

One video-wide track that loops over the whole video and is included in exports