Skip to main content
POST
Add a layout to a clip

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Video identifier

Example:

"vid_abc123def456"

clipId
string
required

Clip identifier

Example:

"cl_xyz789ghi012"

Body

application/json

Add a layout to a clip

layout
Fullscreen · object
required

Single-layer fullscreen. Camera-subject clips take an optional style (regular/stretch); basic-subject clips take an optional screenFit.

durationMs
integer

Optional. Provide together with startTimeMs for a time-ranged layout. Minimum 200ms.

Required range: 200 <= x <= 9007199254740991
media
ClipMediaImage · object

Optional media content to show during this layout. Only valid on time-ranged layouts.

startTimeMs
integer

Optional. Provide together with durationMs for a time-ranged layout. In ms on the clip's playback timeline (cuts applied).

Required range: 0 <= x <= 9007199254740991
transitionStyle
enum<string>

Optional. Only valid on time-ranged layouts. Defaults to the user's saved layout intro transition when omitted. The user's saved layout outro transition is applied when the following layout begins or resumes.

Available options:
spring,
hardCut

Response

OK

A layout on a clip

layout
object
required

A layout attached to a clip. Times are in ms on the clip's playback timeline (cuts applied). Internally the layout stays anchored to the footage, so it doesn't drift when cuts change later.