Sources

Create a new source upload (video or image)

Returns a sourceId and a pre-signed S3 URL. PUT the file bytes to uploadUrl, then reference sourceId from clips, layouts (b-roll media), overlays, or backgrounds. Use kind: "image" for images (no duration); Tella hosts the bytes for rendering, so you never deal with raw image URLs.

post/v1/sources

Request body

durationnumber

Duration in seconds. Required for video and audio; ignored for image.

heightinteger

Height in pixels. Required for video and image; omit for audio.

kind'video' | 'audio' | 'image'

Source kind: video (default), audio (e.g. sound effects), or image.

widthinteger

Width in pixels. Required for video and image; omit for audio.

Response

expiresAtstring date-time required

ISO-8601 timestamp at which uploadUrl stops accepting uploads.

sourceIdstring required

ID of the new source.

uploadUrlstring uri required

Pre-signed S3 URL. PUT the file bytes here (single PUT, max ~5GB). Upload the file as-is: any common container is accepted (MP4, MOV, WebM, MP3, WAV, M4A, …) — the .mp4 in the URL path is just the storage key, not a container requirement.

Changes

No recorded changes to this endpoint across all 1 revision of this API.