Add an overlay to a clip
Adds an image or video overlay to a clip. Upload the bytes via POST /v1/sources (kind: image or kind: video) and pass the sourceId; the overlay type follows the source’s kind.
Authorizations
API key obtained from your Tella account settings
Path Parameters
Video identifier
"vid_abc123def456"
Clip identifier
"cl_xyz789ghi012"
Body
Add an image or video overlay to a clip. Upload the bytes via POST /v1/sources (kind: image or kind: video) and pass the sourceId; the overlay type follows the source's kind. When point/dimensions are omitted, a centered box is computed from the source.
x <= 90071992547409915000
Source ID from POST /v1/sources (kind: image or kind: video). The overlay type follows the source's kind.
"su_abc123"
Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.
0 <= x <= 90071992547409911000
Overlay size in artboard pixels. Absolute (not a percentage) so the overlay shape never distorts when the artboard dimensions change.
"Logo"
Top-left corner of the overlay, as a percentage of the story canvas (0-100). Relative so the anchor survives story ratio changes.
Response
OK
An overlay on a clip
An image or video overlay on a clip.