cut clips

Cut several moments out of one recording in one call. Each becomes its own clip, a timeline inside the project. Shape, a crop on the subject, captions and punch-ins are options, absent unless named. A clip is one span or several joined in order. timeline_id is the project: any timeline of the workspace, usually one made for the set with manage_timelines create; clips of a project carry parent_id. In and out points move up to 1.2 seconds onto the nearest word edge when the recording has stored words (transcribe_media with ref reads them; without them spans are cut as given). Each clip that lands is returned with its timeline_id, name and landed spans; a span the project already holds comes back in skipped, one that could not be cut in failed, and one not reached in time in to_do. The first cut puts the set on the workspace feed. For one clip, edit_timeline addClip with source. Free, except captioning a recording without stored words, reading a subject for the crop and drawing each clip’s feed picture: cloud processing.

POST

tools

cut_clips

cut clips

curl --request POST \
  --url https://eversince.ai/api/v1/tools/cut_clips \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "timeline_id": "<string>",
  "ref": "<string>",
  "clips": [
    {
      "source": {
        "[0]": 123,
        "[1]": 123
      },
      "name": "<string>",
      "note": "<string>",
      "platforms": [
        "<string>"
      ],
      "hook": "<string>"
    }
  ]
}
'

import requests

url = "https://eversince.ai/api/v1/tools/cut_clips"

payload = {
    "timeline_id": "<string>",
    "ref": "<string>",
    "clips": [
        {
            "source": {
                "[0]": 123,
                "[1]": 123
            },
            "name": "<string>",
            "note": "<string>",
            "platforms": ["<string>"],
            "hook": "<string>"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    timeline_id: '<string>',
    ref: '<string>',
    clips: [
      {
        source: {'[0]': 123, '[1]': 123},
        name: '<string>',
        note: '<string>',
        platforms: ['<string>'],
        hook: '<string>'
      }
    ]
  })
};

fetch('https://eversince.ai/api/v1/tools/cut_clips', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key

string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id

string

The workspace this one call acts in, when it is not the default: for a key or a connected agent, one of the workspaces the user allowed it.

Body

application/json

timeline_id

string

required

The project the clips land in: any timeline, empty or not, or a clip already in it. The recording itself is ref.

ref

string

required

The recording being cut, as a library ref.

clips

object[]

required

The moments, in the order they should be numbered. Up to 50 a call.

Required array length: 1 - 50 elements

Show child attributes

aspect

enum<string>

The shape every clip is cut at, 9:16 for shorts. Absent leaves each clip at the project's.

Available options:

16:9,

9:16,

21:9,

9:21,

1:1,

4:3,

3:4,

3:2,

2:3,

5:4,

4:5

captions

string

Caption every clip in this look: a template saved for the workspace, or a built-in one: Subtitles, Kinetic, One word, Karaoke, Broadcast, Boxed, Story, Social, Hook. Absent leaves the clips uncaptioned.

hook_style

object

How every hook in the set looks; absent, a white box with dark bold type near the top for three seconds: font_family, font_size (px at the clip's resolution), font_weight (100 to 900), color, background_color (null for none), background_opacity, background_padding, background_radius, position (top-, center- or bottom- with left, center or right; or center), offset_y (px from there, positive down), text_transform (none|uppercase|lowercase|capitalize), animation (none|fade|slide|pop), stroke_color, stroke_width, seconds (0.5 to 15).

Show child attributes

emphasis

object

The words this set is about, lit and marked.

Show child attributes

bleep

Bleep swearing: the sound covered where it is said and the word starred in the captions. true takes the usual list.

zoom

enum<string>

Punch in on the words, as auto_zoom does. Absent leaves the framing still.

Available options:

light,

medium,

strong

reframe

Move each clip's crop to follow the subject, for a cut whose shape differs from the recording's. speaker follows whoever is talking where two people share the frame (needs speakers on the recording).

layout

object

For a stream or tutorial with a face-cam: the camera in one band and the screen in the other, each cropped to its region, on tall and square clips. Regions come off a frame (inspect_media). Replaces reframe and zoom.

Show child attributes

allow_duplicates

boolean

Cut a span the project already holds a clip of. Off, such a span is skipped and the clip it already is named in skipped, so a retried call cannot double the set.

context

string

Optional: one sentence shown to the user beside this action.

Maximum string length: 600

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

any

required

data

object

required

meta

object

required

Show child attributes

media

object[]

cut clips

curl --request POST \
  --url https://eversince.ai/api/v1/tools/cut_clips \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "timeline_id": "<string>",
  "ref": "<string>",
  "clips": [
    {
      "source": {
        "[0]": 123,
        "[1]": 123
      },
      "name": "<string>",
      "note": "<string>",
      "platforms": [
        "<string>"
      ],
      "hook": "<string>"
    }
  ]
}
'

import requests

url = "https://eversince.ai/api/v1/tools/cut_clips"

payload = {
    "timeline_id": "<string>",
    "ref": "<string>",
    "clips": [
        {
            "source": {
                "[0]": 123,
                "[1]": 123
            },
            "name": "<string>",
            "note": "<string>",
            "platforms": ["<string>"],
            "hook": "<string>"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    timeline_id: '<string>',
    ref: '<string>',
    clips: [
      {
        source: {'[0]': 123, '[1]': 123},
        name: '<string>',
        note: '<string>',
        platforms: ['<string>'],
        hook: '<string>'
      }
    ]
  })
};

fetch('https://eversince.ai/api/v1/tools/cut_clips', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Discovery

Timeline

Workspace

Library

Canvas

Generation

Research

Account

Models

Uploads

Webhooks

cut clips

Authorizations

Headers

Body

Response