Skip to main content
POST
/
v1
/
videos
/
{id}
/
clips
/
{clipId}
/
cut-by-transcript
Cut clip ranges by transcript word indices
curl --request POST \
  --url https://api.tella.com/v1/videos/{id}/clips/{clipId}/cut-by-transcript \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "wordRanges": [
    {
      "fromWordIndex": 12,
      "toWordIndex": 17
    }
  ]
}
'
{
  "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 ranges from the clip by referencing word indices in the uncut transcript. The server resolves each range to exact word startTimeMs/endTimeMs and merges the resulting cuts.

wordRanges
object[]
required

Word ranges to cut. Each range's start and end ms are read directly from the uncut transcript — no padding is applied.

Minimum array length: 1

Response

OK

Response shape for a single clip

clip
object
required

A section of a video