cut clips

Cut many moments out of one recording at once: each span becomes its own clip, a timeline of its own inside the project, shaped, punched in on the words, cropped to the subject and captioned in one look. 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 span; a span the project already holds comes back in skipped, and one that could not be cut in failed. 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 and reading a subject for the crop: 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": [
        123,
        123
      ],
      "name": "<string>",
      "note": "<string>",
      "platforms": [
        "<string>"
      ],
      "hook": "<string>",
      "score": 5
    }
  ]
}
'

import requests

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

payload = {
    "timeline_id": "<string>",
    "ref": "<string>",
    "clips": [
        {
            "source": [123, 123],
            "name": "<string>",
            "note": "<string>",
            "platforms": ["<string>"],
            "hook": "<string>",
            "score": 5
        }
    ]
}
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: [123, 123],
        name: '<string>',
        note: '<string>',
        platforms: ['<string>'],
        hook: '<string>',
        score: 5
      }
    ]
  })
};

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,
      "queued_minutes": 123,
      "left_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,
      "queued_minutes": 123,
      "left_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 key's own.

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-left to bottom-right), offset_y, 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": [
        123,
        123
      ],
      "name": "<string>",
      "note": "<string>",
      "platforms": [
        "<string>"
      ],
      "hook": "<string>",
      "score": 5
    }
  ]
}
'

import requests

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

payload = {
    "timeline_id": "<string>",
    "ref": "<string>",
    "clips": [
        {
            "source": [123, 123],
            "name": "<string>",
            "note": "<string>",
            "platforms": ["<string>"],
            "hook": "<string>",
            "score": 5
        }
    ]
}
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: [123, 123],
        name: '<string>',
        note: '<string>',
        platforms: ['<string>'],
        hook: '<string>',
        score: 5
      }
    ]
  })
};

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,
      "queued_minutes": 123,
      "left_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,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Discovery

Timeline

Workspace

Library

Canvas

Generation

Research

Account

Models

Uploads

Webhooks

cut clips

Authorizations

Headers

Body

Response