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"
    }
  ]
}

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"

Response

OK

Response shape for listing clips of a video

clips
object[]
required

Clips in the video, ordered by order