Clips

Cut one or more time ranges from a clip

Cut one or more time ranges from a clip in a single request. Pass cuts: [{fromMs, toMs}, ...] for multiple ranges or the legacy fromMs/toMs pair for a single range. Overlapping or adjacent ranges are merged into the clip's existing cuts. To clear all cuts, call updateClip with cuts: [].

post/v1/videos/{id}/clips/{clipId}/cut

Request

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

Path parameters

idstring required

Video identifier

Example:vid_abc123def456
clipIdstring required

Clip identifier

Example:cl_xyz789ghi012

Request body

fromMsinteger

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

toMsinteger

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

Example request

{
  "cuts": [
    {
      "fromMs": 2000,
      "toMs": 3500
    }
  ],
  "fromMs": 2000,
  "toMs": 3500
}

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.