Clips

Cut clip ranges by transcript word indices

Cut one or more ranges from a clip by referencing word indices in the transcript. The server reads each word's exact startTimeMs / endTimeMs and merges the resulting cuts — no padding is applied to word boundaries.

post/v1/videos/{id}/clips/{clipId}/cut-by-transcript

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/videos/{id}/clips/{clipId}/cut-by-transcript
  • Auth: HTTP bearer

Path parameters

idstring required

Video identifier

Example:vid_abc123def456
clipIdstring required

Clip identifier

Example:cl_xyz789ghi012

Request body

Example request

{
  "wordRanges": [
    {
      "fromWordIndex": 12,
      "toWordIndex": 17
    }
  ]
}

Response

OK

Example response

{
  "clip": {
    "animatedCursor": true,
    "background": {
      "color": "#000000ff",
      "gradientAngle": 45,
      "gradientColor1": "#ff0080ff",
      "gradientColor2": "#7928caff",
      "sourceId": "su_abc123",
      "type": "solid",
      "videoDurationSeconds": 12.4
    },
    "borderStyle": "subtle-shadow",
    "cameraFocusPoint": {
      "xPct": 50,
      "yPct": 35
    },
    "corners": "regular",
    "createdAt": "2026-01-15T10:30:00.000Z",
    "cuts": [
      {
        "durationMs": 750,
        "startTimeMs": 1500
      }
    ],
    "durationSeconds": 12.5,
    "id": "cl_xyz789ghi012",
    "layoutSceneType": "combi",
    "maxDurationSeconds": 14.2,
    "microphoneVolume": 0.4,
    "name": "Intro",
    "transition": "default",
    "updatedAt": "2026-01-15T14:45:00.000Z",
    "videoId": "vid_abc123def456"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.