Skip to main content
Add an audio clip to play over a clip for a time range. Upload the audio with create_source first (kind: "audio" with the audio’s duration), then reference the returned sourceId. Upload the audio file as-is — MP3, WAV, M4A, and other common formats are accepted; no need to wrap it in an MP4.
All times are milliseconds on the clip’s playback timeline — the video as watched, with cuts applied. It is the same timeline as get_transcript, thumbnails, and previews, so nothing needs converting. A start at or past the end of the clip is rejected with a 400.

​
list_sound_effects

List the sound effects on a clip.
​
string
required
Video ID
​
string
required
Clip ID

​
add_sound_effect

Add a sound effect to a clip, from Tella’s curated library or from your own audio. For a curated effect, call list_library with scope: "default" and pass the item’s presetId — there is nothing to upload. For your own audio, pass the sourceId of a private or workspace item from that same tool, or upload a new one: call create_source first (kind: "audio" with the audio’s duration), PUT the audio file as-is (MP3, WAV, M4A, …) to the returned uploadUrl, then pass the sourceId here.
​
string
required
Video ID
​
string
required
Clip ID
​
string
Required unless sourceId is given. Preset ID of a curated Tella sound effect, from a default item in list_library
​
string
Required unless presetId is given. Source ID for the audio, from create_source or a private/workspace item in list_library
​
integer
required
Start time in ms
​
integer
required
Duration in ms — use the item’s durationMs to play it in full
​
string
Sound effect name
​
number
Playback volume (0 = muted, 1 = original). Defaults to 1.
Pass exactly one of presetId or sourceId. Placing a preset copies it into a source owned by your workspace, so the video references its own media.

​
update_sound_effect

Update an existing sound effect. Only provided fields change.
​
string
required
Video ID
​
string
required
Clip ID
​
string
required
Sound effect ID
​
integer
New start time in ms
​
integer
New duration in ms
​
string
Sound effect name
​
number
Playback volume (0 = muted, 1 = original)

​
remove_sound_effect

Remove a sound effect from a clip.
​
string
required
Video ID
​
string
required
Clip ID
​
string
required
Sound effect ID