Skip to main content
POST
/
v1
/
videos
/
{id}
/
clips
/
{clipId}
/
cut
Cut one or more time ranges from a clip
curl --request POST \
  --url https://api.tella.com/v1/videos/{id}/clips/{clipId}/cut \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cuts": [
    {
      "fromMs": 2000,
      "toMs": 3500
    }
  ],
  "fromMs": 2000,
  "toMs": 3500
}
'
{
  "clip": {
    "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"

clipId
string
required

Clip identifier

Example:

"cl_xyz789ghi012"

Body

application/json

Cut one or more time ranges from the clip in a single request. Provide either cuts: [{fromMs, toMs}, ...] (preferred) or the legacy single-range fromMs/toMs pair. Overlapping or adjacent ranges are merged into the clip's existing cuts.

cuts
object[]

Time ranges to cut from the clip. Merged with the clip's existing cuts; overlapping or adjacent ranges are joined.

Minimum array length: 1
fromMs
integer

Single-range shortcut for cuts: [{fromMs, toMs}]. Use cuts for multiple ranges.

Required range: 0 <= x <= 9007199254740991
Example:

2000

toMs
integer

Single-range shortcut for cuts: [{fromMs, toMs}]. Use cuts for multiple ranges.

Required range: x <= 9007199254740991
Example:

3500

Response

OK

Response shape for a single clip

clip
object
required

A section of a video