Create Overlay Clip

Create an overlay clip backed by an existing source Video.

Content (video_url, name, prompt, etc.) lives on the referenced Video — the clip only stores position/timing/styling + a pointer via elements["sourceVideoId"].

post/api/projects/{project_id}/overlay-clips

Path parameters

project_idstring required

Request body

sourceVideoIdstring nullable

Source Video ID (provides video_url/name/prompt/etc.)

videoIdstring nullable

Parent video ID (overlay is positioned relative to this video)

startMsinteger

Start position relative to parent video (ms)

durationMsinteger required

Visible duration on timeline (ms)

sourceDurationMsinteger

Original video duration (ms)

opacitynumber nullable

Overlay opacity (0.0-1.0)

zIndexinteger nullable

Stacking order among overlays (higher = on top)

Response

Successful Response

object required

Changes

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