Clips

Clip a long video

Turns a talk, webinar, podcast or interview (up to 2 hours, 1 GB) into up to 12 vertical clips with a viral score, a hook line, captions and ready-made copy. url takes a video page on YouTube, Vimeo, TikTok, Instagram, X, LinkedIn, Loom and more, a Google Drive, Dropbox, OneDrive or Box share link, or a direct file link; or pass media_id for a video in the library. Runs a few minutes; returns job_id at once.

POSThttps://traceeai.com/api/v1/clips

CLI:tracee clips create·MCP:mediaaction clip

Authorizations

Authorizationstringheaderrequired
Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

Tracee-Workspacestring
For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.
uuid

Body

application/json

urlstring
A link to the video (YouTube, Vimeo, TikTok, Instagram, X, LinkedIn, Loom…, a Google Drive/Dropbox/OneDrive/Box share link, or a direct file link)
uri
media_idstring
A video already in the library
uuid
clip_lengthstring
Auto 15-60s (default), short 15-30s, medium 30-60s, long 60-90s
Available options:autoshortmediumlong
layoutstring
Auto (default, picked per shot), track (follow the speaker), split (stack two speakers), fit (whole frame over blur)
Available options:autotracksplitfit
captionsboolean
Burn captions in; default true
caption_stylestring
The caption look
Available options:defaulthormozipilllimeonewordcleanglowbeast

Response

Errors

200Already done.
The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.
202Started or still running: follow it with the id in the answer.
The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.