Skip to main content
A source is an uploaded file (video, audio, or image) that can be turned into a new video or clip, or referenced as B-roll media, an overlay, a clip background, background music, or a sound effect. Create a source, upload the bytes to the returned pre-signed URL, then reference the sourceId from create_video, upload_clip, add_layout / update_layout, add_overlay, update_clip, set_background_music, or add_sound_effect.

​
create_source

Create a new source upload. Returns a sourceId and a pre-signed uploadUrl — PUT the file bytes to uploadUrl (the URL expires after 1 hour). Once uploaded, the sourceId is accepted by: Upload the file as-is: any common container is accepted (MP4, MOV, WebM, MP3, WAV, M4A, …). The .mp4 in the upload URL is just the storage key, not a container requirement — there’s no need to remux or re-encode before uploading. For audio files, set kind: "audio" with the audio’s duration and omit width / height. For images, set kind: "image" and omit duration. Tella hosts the uploaded image for rendering — you never deal with raw image URLs.
​
enum<string>
Source kind — video (default), audio, or image
​
integer
Width in pixels — required for video and image, omit for audio
​
integer
Height in pixels — required for video and image, omit for audio
​
number
Duration in seconds — required for video and audio, ignored for image