Skip to main content
POST
/
v1
/
videos
/
{id}
/
clips
/
{clipId}
/
layouts
Add a layout to a clip
curl --request POST \
  --url https://api.tella.com/v1/videos/{id}/clips/{clipId}/layouts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "layout": {
    "kind": "fullscreen"
  },
  "durationMs": 123,
  "media": {
    "height": 123,
    "imageUrl": "<string>",
    "type": "image",
    "width": 123
  },
  "startTimeMs": 4503599627370495
}
'
{
  "layout": {
    "id": "<string>",
    "durationMs": 5000,
    "layout": {
      "kind": "fullscreen"
    },
    "media": {
      "height": 123,
      "imageUrl": "<string>",
      "type": "image",
      "width": 123
    },
    "startTimeMs": 0
  }
}

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.

Required range: 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.

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

Optional. Only valid on time-ranged layouts. Defaults to the clip's setting when omitted.

Available options:
spring,
hardCut

Response

OK

A layout on a clip

layout
object
required

A layout attached to a clip