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.add_sound_effect
Add a sound effect to a clip, from Tella’s curated library or from your own audio. For a curated effect, calllist_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.
Required unless
sourceId is given. Preset ID of a curated Tella sound effect, from a default item in list_libraryRequired unless
presetId is given. Source ID for the audio, from create_source or a private/workspace item in list_librarypresetId or sourceId. Placing a preset copies it into a source owned by your workspace, so the video references its own media.