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",
    "screenFit": "cover",
    "style": "regular"
  },
  "durationMs": 123,
  "media": {
    "height": 123,
    "imageUrl": "<string>",
    "type": "image",
    "width": 123
  },
  "startTimeMs": 4503599627370495,
  "transitionStyle": "spring"
}
'
{
  "layout": {
    "id": "<string>",
    "durationMs": 5000,
    "layout": {
      "kind": "fullscreen",
      "screenFit": "cover",
      "style": "regular"
    },
    "media": {
      "height": 123,
      "imageUrl": "<string>",
      "type": "image",
      "width": 123
    },
    "startTimeMs": 0,
    "transitionStyle": "spring"
  }
}

Documentation Index

Fetch the complete documentation index at: https://tella.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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