Skip to main content
GET
/
v1
/
videos
/
{id}
/
clips
List clips for a video
curl --request GET \
  --url https://api.tella.com/v1/videos/{id}/clips \
  --header 'Authorization: Bearer <token>'
{
  "clips": [
    {
      "background": {
        "type": "solid",
        "color": "#000000ff",
        "gradientAngle": 45,
        "gradientColor1": "#ff0080ff",
        "gradientColor2": "#7928caff",
        "imageUrl": "https://cdn.example.com/bg.png",
        "videoDurationSeconds": 12.4,
        "videoUrl": "https://cdn.example.com/bg.mp4"
      },
      "createdAt": "2026-01-15T10:30:00.000Z",
      "cuts": [
        {
          "durationMs": 750,
          "startTimeMs": 1500
        }
      ],
      "durationSeconds": 12.5,
      "id": "cl_xyz789ghi012",
      "layoutSceneType": "combi",
      "maxDurationSeconds": 14.2,
      "name": "Intro",
      "order": 0,
      "updatedAt": "2026-01-15T14:45:00.000Z",
      "videoId": "vid_abc123def456"
    }
  ]
}

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Video identifier

Example:

"vid_abc123def456"

Response

OK

Response shape for listing clips of a video

clips
object[]
required

Clips in the video, ordered by order