{"openapi":"3.1.0","info":{"title":"cuttingfloor","version":"0.55.9","license":{"name":"AGPL-3.0-only","identifier":"AGPL-3.0-only"},"description":"A headless video editor: the same tools as its MCP server (https://api.cuttingfloor.ai/mcp), as plain HTTP. POST /v1/<tool> with the tool's arguments as a JSON object; the response is its result. Sign in with an API key from your account page: Authorization: Bearer cf_…\n\nLong work (imports, analysis, renders, exports) answers at once with a job_id: POST /v1/job.get {\"job_id\": \"…\", \"wait_seconds\": 30} waits up to 30 s for it to finish or fail, and a finished job gives its result and signed download links. Every edit returns a new timeline_id; keep using the latest. A refused call answers with an HTTP error status and {code, message, hint}: the hint says what to do instead."},"servers":[{"url":"https://api.cuttingfloor.ai"}],"security":[{"apiKey":[]}],"tags":[{"name":"timeline"},{"name":"track"},{"name":"clip"},{"name":"range"},{"name":"title"},{"name":"caption"},{"name":"text"},{"name":"audio"},{"name":"filter"},{"name":"adjustment"},{"name":"transition"},{"name":"edit"},{"name":"media"},{"name":"judge"},{"name":"create"},{"name":"render"},{"name":"export"},{"name":"qa"},{"name":"job"},{"name":"skills"}],"paths":{"/v1/timeline.create":{"post":{"operationId":"timeline_create","summary":"Create timeline","description":"Start an empty timeline. Returns its timeline_id and its tracks (ids for track_id). Where no clip covers the picture it is black (transparent in a nested timeline). Timelines are immutable: every edit returns a new timeline_id, and older ids stay valid for 7 days after last use. For work longer than that, keep the timeline.get document on your side and restore it with timeline.load.","tags":["timeline"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_create_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_create_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/timeline.get":{"post":{"operationId":"timeline_get","summary":"Get timeline","description":"The full timeline: tracks, clips (frames, end exclusive), link groups and the media it uses. The server keeps a timeline 7 days after last use: for work longer than that, save this document on your side (it is the edit) and restore it with timeline.load.","tags":["timeline"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_get_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_get_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/timeline.load":{"post":{"operationId":"timeline_load","summary":"Load timeline","description":"Restore a timeline from the document timeline.get returned, e.g. after it expired (7 days after last use). Its media must still be here: media expires 7 days after last use, so import saved files again with media.import and swap them in with clip.replace.","tags":["timeline"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_load_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_load_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/timeline.history":{"post":{"operationId":"timeline_history","summary":"Timeline history","description":"The chain of edits that made this timeline, newest first. To go back, keep using an older timeline_id.","tags":["timeline"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_history_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_history_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/timeline.diff":{"post":{"operationId":"timeline_diff","summary":"Diff timelines","description":"Which clips, tracks and settings differ between two timelines.","tags":["timeline"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_diff_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_diff_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/timeline.set_sequence":{"post":{"operationId":"timeline_set_sequence","summary":"Set sequence","description":"Change resolution, frame rate or audio format. Clip times are kept in time, so they survive a rate change. Each picture is refitted to the new shape by its fit (contain by default, which leaves bars where the shapes differ); the result warns how many clips no longer fill the frame, and clip.set_transform {fit: \"cover\"} fills it. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["timeline"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_set_sequence_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/timeline_set_sequence_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/track.add":{"post":{"operationId":"track_add","summary":"Add track","description":"Add an empty video or audio track. New video tracks go on top. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["track"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/track_add_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/track_add_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/track.remove":{"post":{"operationId":"track_remove","summary":"Remove track","description":"Remove a track and its clips. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["track"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/track_remove_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/track_remove_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/track.set":{"post":{"operationId":"track_set","summary":"Set track","description":"Rename, mute (audio), hide (video) or lock a track. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["track"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/track_set_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/track_set_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.add":{"post":{"operationId":"clip_add","summary":"Add clip","description":"Place media on the timeline. A/V media lands as a linked pair on a video and an audio track. Default: the whole media, after the last clip, overwriting. A picture is scaled to fit the frame (a small logo fills it edge to edge); clip.set_transform {fit: \"none\"} keeps its own pixel size. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_add_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_add_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.remove":{"post":{"operationId":"clip_remove","summary":"Remove clip","description":"Remove a clip and the clips linked to it; ripple closes the gap. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_remove_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_remove_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.move":{"post":{"operationId":"clip_move","summary":"Move clip","description":"Move a clip (and its linked clips) to a frame and optionally another track. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_move_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_move_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.trim":{"post":{"operationId":"clip_trim","summary":"Trim clip","description":"Move the start or end edge of a clip. side: video or audio trims one half of a link group (J/L cuts). Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_trim_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_trim_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.split":{"post":{"operationId":"clip_split","summary":"Split clip","description":"Cut a clip (and its linked clips) in two at a frame. The left piece keeps its id; clip_id is the new right piece of the clip named, and clip_ids every new right piece (its linked ones too), linked together. Each piece keeps its own copy of the settings (transform, mask, effects, speed); later changes apply to the piece named. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_split_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_split_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.link":{"post":{"operationId":"clip_link","summary":"Link clips","description":"Make clips move, trim and split together. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_link_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_link_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.unlink":{"post":{"operationId":"clip_unlink","summary":"Unlink clip","description":"Break the link group a clip belongs to. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_unlink_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_unlink_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.set_enabled":{"post":{"operationId":"clip_set_enabled","summary":"Enable/disable clip","description":"A disabled clip stays on the timeline but renders as a gap. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_enabled_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_enabled_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.set_speed":{"post":{"operationId":"clip_set_speed","summary":"Set speed","description":"Speed up, slow down, ramp or reverse a clip and its linked clips. rate is constant; curve is a speed ramp over the clip. The clip keeps its source and its length changes; ripple (default) moves later clips. Pitch is kept unless preserve_pitch is false. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_speed_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_speed_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.freeze":{"post":{"operationId":"clip_freeze","summary":"Freeze frame","description":"Hold the frame at at_frame for duration_frames: the clip splits there, a freeze frame goes in, and later clips on its tracks move later. Freezing a clip's last frame holds it after the clip, with silence under the hold. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_freeze_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_freeze_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.roll":{"post":{"operationId":"clip_roll","summary":"Roll edit","description":"Move the cut between a clip and the clip right after it: one gets longer, the other shorter, nothing else moves. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_roll_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_roll_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.slip":{"post":{"operationId":"clip_slip","summary":"Slip edit","description":"Show earlier or later source in a clip without moving or resizing it. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_slip_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_slip_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.slide":{"post":{"operationId":"clip_slide","summary":"Slide edit","description":"Move a clip between its neighbours: the clip before it and the clip after it change length so nothing else moves. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_slide_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_slide_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.replace":{"post":{"operationId":"clip_replace","summary":"Replace media","description":"Swap the media in a clip, keeping its place, length, speed and look. Starts at source_in (default 0). Its linked clips swap too (linked: false for this clip only); clip_ids lists every clip swapped. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_replace_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_replace_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/range.lift":{"post":{"operationId":"range_lift","summary":"Lift range","description":"Remove everything in a frame range on the given tracks (default all unlocked, so a picture range takes the sound under it too: lock a track with track.set or name track_ids to keep it), leaving a gap. changed lists each clip removed or cut, with its track; a warning says when sound went with the picture. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["range"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/range_lift_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/range_lift_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/range.extract":{"post":{"operationId":"range_extract","summary":"Extract range","description":"Remove everything in a frame range on the given tracks (default all unlocked, so a picture range takes the sound under it too: lock a track with track.set or name track_ids to keep it) and close the gap. For cutting out silences, filler words or mistakes across all tracks at once. changed lists each clip removed or cut, with its track; a warning says when sound went with the picture. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["range"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/range_extract_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/range_extract_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/title.add":{"post":{"operationId":"title_add","summary":"Add title","description":"Text on a video track, over the tracks below: styled with font, size, colour, outline, shadow and box, placed by x/y, revealed with a typewriter or word animation. A style field you leave out takes the published default (video://catalog/text: bold white Inter at 9% of the frame height, centred, with a soft shadow); timeline.get shows the full style. spans style part of the text (words first_word to last_word, from 0: one word in yellow or bold). It is a clip, so transforms, masks, animations and transitions apply. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["title"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/title_add_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/title_add_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/caption.add":{"post":{"operationId":"caption_add","summary":"Add captions","description":"Captions on a video track from segments (with optional word timings for highlights), from SRT/VTT text, or in_clip: segments timed in seconds of a clip's media, such as transcript word times, placed where they play. One clip per caption; returns their clip_ids. A style field you leave out takes the published default (video://catalog/text: bold white Inter at 6% of the frame height, near the bottom, with a black outline); timeline.get shows the full style. Lines wrap on their own at style max_width (a fraction of the frame width), balanced in length; \\n forces a break. style max_lines caps the lines on screen at once: a longer caption shows a screenful at a time, each from its first word's time. A segment's spans style part of its text (words first_word to last_word, from 0: the timed words, or the text split at spaces), e.g. the key word in yellow. Burned in when exported. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["caption"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/caption_add_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/caption_add_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/text.set":{"post":{"operationId":"text_set","summary":"Set text","description":"Change a title's or caption's text, or restyle many at once (clip_ids, or every one on track_id). The style is merged; null turns an outline, shadow, box or highlight off (and max_lines back to all lines). spans (one clip) restyle part of its text. Fonts: video://catalog/fonts, or an unknown font is refused with the close matches. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["text"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/text_set_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/text_set_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/audio.set_gain":{"post":{"operationId":"audio_set_gain","summary":"Set gain","description":"Volume of an audio clip (or a video clip's linked audio) in dB; keyframes ride it up and down. The preview is a waveform of the clip; with preview inline it also carries the measured loudness (preview.loudness), a link preview does not. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["audio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/audio_set_gain_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/audio_set_gain_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/audio.set_pan":{"post":{"operationId":"audio_set_pan","summary":"Set pan","description":"Place a clip's sound left (-1) to right (1). Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["audio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/audio_set_pan_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/audio_set_pan_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/audio.fade":{"post":{"operationId":"audio_fade","summary":"Fade audio","description":"Fade a clip's sound in from its start and out to its end. null removes a fade. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["audio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/audio_fade_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/audio_fade_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/audio.set_master":{"post":{"operationId":"audio_set_master","summary":"Set master","description":"Gain (dB) and limiter ceiling on the whole mix. The ceiling caps sample peaks (dBFS); the true peak between samples can land above it, most on dense, bright sound, and qa.check measures it (dBTP). Audio edits with preview inline carry the measured loudness (preview.loudness); a link preview does not. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["audio"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/audio_set_master_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/audio_set_master_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/filter.add":{"post":{"operationId":"filter_add","summary":"Add effect","description":"Apply an effect to a clip, every clip on a track, or the whole timeline: picture effects (colour, LUT, blur, vignette, chroma key, glitch, denoise and more) on video, sound effects (EQ, compressor, noise_reduction, voice_denoise, pitch and more) on audio. Order matters: effects run in the order added (a track's before a clip's own). Picture numbers take keyframes, except glitch, denoise and chroma_key tolerance; sound params are constants. A wrong name or param is refused with the full list, ranges, units and defaults (also at video://catalog/effects); timeline.get shows every param applied. Returns its id as clip_id. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["filter"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/filter_add_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/filter_add_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/filter.set":{"post":{"operationId":"filter_set","summary":"Set effect","description":"Change an effect's params (merged) or turn it off and on. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["filter"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/filter_set_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/filter_set_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/filter.remove":{"post":{"operationId":"filter_remove","summary":"Remove effect","description":"Take an effect off. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["filter"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/filter_remove_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/filter_remove_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/adjustment.add":{"post":{"operationId":"adjustment_add","summary":"Add adjustment clip","description":"An empty clip on a video track whose effects (filter.add with its clip_id) change everything below it while it runs: a colour grade or blur over a stretch of the edit. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["adjustment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/adjustment_add_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/adjustment_add_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/transition.add":{"post":{"operationId":"transition_add","summary":"Add transition","description":"Transition at the cut after a clip, into the clip that touches it (video://catalog/transitions). Linked audio gets a crossfade at the same cut. kind crossfade is sound only: on a video clip it crossfades the linked audio and the picture cuts hard (use mode handles for that). mode overlap (default) overlaps the clips and moves later clips earlier; handles uses source past the cut and moves nothing. changed lists each transition added, with its track and kind. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["transition"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/transition_add_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/transition_add_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/transition.set":{"post":{"operationId":"transition_set","summary":"Set transition","description":"Change a transition's kind or duration. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["transition"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/transition_set_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/transition_set_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/transition.remove":{"post":{"operationId":"transition_remove","summary":"Remove transition","description":"Remove a transition; the cut becomes a hard cut. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["transition"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/transition_remove_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/transition_remove_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.set_transform":{"post":{"operationId":"clip_set_transform","summary":"Set transform","description":"Position, scale, rotate, fade, flip, crop or fit a video clip over the tracks below (picture-in-picture, overlays, punch-ins). fit none shows a graphic at its own pixel size, so scale 1 is its real size; the default contain scales it to touch the frame edges. Any number takes a constant or {keyframes: [{frame, value, ease}]} with frames from the clip start; a keyframe's ease shapes the move from it to the next one (sine_in_out, cubic_out, back_out, hold and more). Overlays that must follow a zoom or pan: put the clip and its overlays in a timeline of the same shape, nest it with clip.add {nested_timeline_id} and transform the nested clip, so everything moves together. Omitted fields keep their value; null resets one. To pin an overlay to a moving subject, use media.analyze track boxes as keyframes: for each box, frame = timeline frame of the box time (where the tracked clip plays that media second) minus this clip's start, x = box x + w/2 and y = box y + h/2 (add your offset). That holds when the tracked clip fills the frame as is; if it is scaled, moved or cropped, map the box through its transform first. Skip boxes with found false. The result's placements say where the clip now shows, in sequence pixels: its picture box, the part visible after crop and mask inside the frame, and the source pixels that show there. corners pins the picture's four corners to four points in the frame instead (a screen, sign or page seen at an angle, or a tilt in 3D), keyframable the same way; it replaces x, y, scale, scale_x, scale_y, rotation and fit, while opacity, flip, crop and masks still apply. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_transform_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_transform_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.set_blend":{"post":{"operationId":"clip_set_blend","summary":"Set blend mode","description":"How a video clip mixes with the tracks below: normal, multiply, screen, overlay and more (video://catalog/blend_modes). Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_blend_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_blend_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.set_mask":{"post":{"operationId":"clip_set_mask","summary":"Set mask","description":"Select part of a video clip, then show, hide or fill it: rectangle (rounded), ellipse, linear, mirror, heart, star, polygon or matte (a media's alpha, e.g. a create.cutout), with feather and invert. Several shapes: add. A fill paints the selection from the picture around it and from earlier frames where that area showed, so something that never moves against its background leaves a smudge: nothing ever shows what is behind it. It is a job of its own (job.list shows its progress); a render that needs it names the job until it is done, and an export waits for it. Position, size and rotation animate like transform values. Coordinates are fractions of the clip's fitted frame: a sequence-shaped box with the picture fitted inside (bars where the shapes differ), before the clip's scale and position. A narrower picture fills k = (its aspect / the sequence's) of the box width, centred, so a picture-fraction box maps to x = 0.5 + (x - 0.5) * k, width * k (a wider picture: the same on y and height, with k = the sequence aspect / its). null removes the mask. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_mask_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_mask_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/clip.set_animation":{"post":{"operationId":"clip_set_animation","summary":"Set animation","description":"Entrance, exit and loop presets layered over the clip transform (video://catalog/animations): e.g. in {name: \"pop\", duration_frames: 12}, loop {name: \"float\"}; a loop runs the whole clip, or only from_frame to to_frame of it (loop {name: \"shake\", from_frame: 30, to_frame: 45} for a jolt). null removes one. Returns the new timeline_id (edit that one next), what changed, and where each changed clip now sits.","tags":["clip"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_animation_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/clip_set_animation_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/edit.batch":{"post":{"operationId":"edit_batch","summary":"Batch edit","description":"A pipeline of edits in one call: each op runs on the result of the one before, and a later op takes an id an earlier op made with {\"$ref\":\"ops[N].clip_id\"} (or track_id, clip_ids[M]). Unrelated edits go in one pipeline too; order matters only when one edit uses the result of another. One new timeline_id and one preview at the end; all apply or none do. Separate edit calls each start from the timeline_id they are given, so they run one after another. Returns the edit result plus results: [{tool, clip_id?, clip_ids?, track_id?}] per op.","tags":["edit"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/edit_batch_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/edit_batch_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/media.import":{"post":{"operationId":"media_import","summary":"Import media","description":"Ingest the user's own video, audio, image or font into an editable media_id: probe, fingerprint, conform if needed (VFR, rotation, HDR → BT.709), 540p proxy and integrated loudness. A reference image to recreate needs no import: rebuild it with create.motion or create.still. A file on the user's phone or computer must be staged first (media.upload, or their upload page, https://cuttingfloor.ai/upload). Sources: an http(s) URL to the file itself (public Dropbox and Google Drive share links work as they are; a video site's page such as YouTube, or a private share, does not; fetched once, at the start), the upload_id of a staged file, a small file as a data: URI (up to 8 MB, with its sha256), the job_id of a completed export.video, a still (one frame of a video or an edit, as a PNG), or a file the chat attaches, as file. Long-running: returns a task, or {job_id, media_id}. The media_id is editable once the job reports processing, so start every import, then edit. The same file returns the same media_id; the copy stays here 7 days after last use.","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_import_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_import_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/media.upload":{"post":{"operationId":"media_upload","summary":"Upload media","description":"Stage one file on this server: returns a url and an upload_id. A staged file is inert until imported. The url works for 7 days and takes the file from whoever holds it, with no other credentials; opened in a browser, it is a page to pick the file and send it, so it reaches files on the user's phone or computer, including one attached in a chat that isn't handed to you. Files the user drops on their upload page, https://cuttingfloor.ai/upload, are staged too: many at once, after signing in to the same account.","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_upload_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_upload_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/media.list":{"post":{"operationId":"media_list","summary":"List media","description":"What the user has here: imported and created media, and files they sent that aren't imported yet (through media.upload's link, or dropped on their upload page, https://cuttingfloor.ai/upload), with names, sizes and when each expires, plus this account's storage used and how much it holds. When the user mentions a file they sent or dropped (\"the interview I uploaded\"), find it here by name and media.import {source: {upload_id}} it; complete says it is all in. Listing does not count as a use, so nothing here lasts longer for being listed. This is a place to work, not storage: when the user counts on something here staying, tell them it goes on its own and offer to save it where they keep their files.","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_list_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_list_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/media.delete":{"post":{"operationId":"media_delete","summary":"Delete media","description":"Delete a media for good, so an old or wrong version stops turning up: its file here, proxy, mezzanine and media.analyze results go, and its room comes back to this account’s storage. A path import leaves the original in its folder; exports made from it stay. Timelines that use it keep their ids and edits but no longer render (media_offline names it, as for expired media): replace those clips with clip.replace. Importing the same file again makes a new media_id.","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_delete_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_delete_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/media.analyze":{"post":{"operationId":"media_analyze","summary":"Analyze media","description":"Find what is in imported media, or in the sound of an edit, as data for edits. transcript: every word with its time (whisper.cpp on the CPU; the model downloads once). For English the word edges are then aligned to the sound (wav2vec2 forced alignment): a word starts and ends within about 0.05 s of where its letters sound, and an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more; timing_confidence says how clearly each word was heard. Other languages keep whisper's own times, up to about a second off. Short ums and uhs are often missing from the words, while kind speech still detects them as voice. from_seconds and until_seconds transcribe just that stretch: the words come back in the result and are not stored, so the stored transcript (which edits and captions read) stays the whole media's. file: txt also writes the transcript as a file on the cutting floor, with a download url. beats: tempo, beat and downbeat times, and strengths: each beat's onset strength, 0–1 of the strongest (the hardest hits, the drop). faces: face boxes over time, e.g. to reframe to 9:16 with clip.set_transform keyframes. track: follow a region you give from a moment on, a box for each sampled time (found false where the subject was lost); to make a title, sticker, arrow or mask follow the subject, turn the boxes into clip.set_transform (or clip.set_mask) keyframes, no tracking of your own needed. look: your own typed questions about what is on screen, answered on every sampled frame (to find where something happens from plain words, media.seek). silence: stretches quieter than threshold_db for at least min_seconds. scenes: times the picture changes by more than threshold (0–100; hard cuts between ordinary shots score about 10 to 30, see threshold), with each cut's score. speech: the probability that someone is speaking, every 32 ms (Silero VAD), and the spans where it is at least your min_probability; it hears speech, not noise or music, so a cough or a door is not speech. loudness: integrated loudness (LUFS), true peak (dBTP), loudness range (LU), RMS level and noise floor (dBFS) over the whole media or from_seconds to until_seconds. To line up two recordings, media.correlate. sounds: what can be heard and when, every 40 ms, for 447 named sounds (video://catalog/sounds: Laughter, Applause, Cough, Sneeze, Music, Speech, Door, Footsteps, Beep…): give labels for the ones you want, or none for every sound that reaches your min_probability; you get each sound's spans and its probability in every frame (a run over the whole media is kept with it; one over from_seconds to until_seconds comes back only). To find a sound you describe in your own words, media.listen. speakers: who speaks when (pyannote and ERes2Net on the CPU, about 10 to 20 s a minute): turns numbered in the order voices are first heard; give speakers (how many) or cluster_threshold. Transcript words then carry their speaker. voice: pitch (YIN, Hz) and level (RMS dBFS) every 0.1 s, and a summary (pitch median and range, level, voiced seconds, words per second from the transcript), e.g. as judge.ask state. colour: per-channel mean and percentiles, luma, white point estimate and clipping (RGB 0–255) of the frame and regions you name, at sampled times. picture: FFmpeg signalstats of every frame over a stretch: luma, chroma, saturation, hue, and ydif, the change from the frame before (a flash or frozen frame shows there).\nWith timeline_id instead of media_id, speech, loudness, silence, sounds, speakers, voice measure the edit's mix and faces, track, look, scenes, colour, picture its picture as it renders (titles, effects and grades included), over from_seconds to until_seconds (timeline seconds); they come back in the result. A source or range with no sound fails with no_audio, naming it.\nTimes are media seconds (timeline seconds for a timeline); boxes are fractions of the picture, and a box you give takes units \"pixels\" too (picture_size gives the size). Results stay with the media (media.get include; the latest run of each kind) except track, silence, scenes and loudness, which come back in the result; speech over the whole media is kept (media.get include speech), so asking again with another min_probability or range answers from it. A result too long to return (a long transcript) comes back as its summary and a note: read it in pieces with media.get include and a time range or page.\nLong-running: returns a task, or a job_id for job.get.\n\nHOW LOOK WORKS. A fast judgment model (preview) answers your questions about frames sampled from the media. Each sampled frame is its own request: the judgment model sees that one picture, named `frame`, and with with_previous also the frame sampled just before it, named `previous`, plus any state you give: text or JSON entries by name, the same on every frame (the script, what a term means). Every question is answered on every frame, independently and in parallel (about 0.15 s a frame), as typed data you then combine in your own code.\nChoose the type by the answer you need. noul: yes or no, answered as noul, the probability of yes from 0 to 1. choice: one of options you name, answered as choice plus probabilities and confidence. score: a degree on levels you order, answered as score (0 is the first level; it can land between levels) plus confidence. box: where one thing is, answered as box {x, y, w, h} in fractions of the picture plus confidence.\nWrite each question about the picture as it looks. Name the picture in backticks (\"in `frame`\"), ask about one thing, word it so yes means the thing is there, and describe it as it appears: \"Does `frame` show a human being, even if only their face fills the picture?\", \"Is one large word laid over `frame`, much bigger than any other text?\". To compare, name both pictures and the thing that differs: \"Is there a button in `frame` that is not in `previous`?\". To locate, name the one thing so only it fits (\"the 'Get started for free' button under the headline in `frame`\") and, in the same call, a noul asking whether it is there; use the box on frames where that noul is high. Give a choice a none option for frames where nothing fits, and each score level a concrete situation.\nRead the answers this way: a noul of 0.5 or more reads as yes, and you can set your own cut-off; confidence tells you how far to trust a choice, a score or a box, and a loose box shows as low confidence. Work in passes: every_seconds 1 over the whole media, then at_seconds around the times where answers change. media.get scenes give when the picture cuts; look tells you what is on it.\nThe result gives each question's spans (when a noul reads yes, which choice holds when); every frame's answers stay with the media (media.get include ['look'], the last 10 runs). Up to 600 frames and 32 questions a call. To find the moments that match a description, media.seek takes it in plain words and returns where it holds. For one judgment about text, a still or a single frame, judge.ask answers at once. Full guide to writing questions: https://docs.typesafe.ai/primitives and https://docs.typesafe.ai/images.","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_analyze_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_analyze_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/media.correlate":{"post":{"operationId":"media_correlate","summary":"Sync offset","description":"Find how far one recording sits from another: the sync offset of b against a, by cross-correlating their sound, with how strongly they match. Use it to line up a camera with a separate microphone, two cameras of the same moment, or a re-recorded line against the original. Each side is imported media or an edit's mix (timeline_id), over its own from_seconds to until_seconds, so you can match a short stretch of b against a longer stretch of a.\noffset_seconds: b's moment t lines up with a's moment t + offset_seconds, each in its own seconds. To line them up on a timeline, place b's clip so it starts offset_seconds later than a's (earlier when negative), source starts being equal. strength is the correlation of the overlapping sound at that offset, -1 to 1: near 1 the same sound, near 0 unrelated; next_best is the best offset outside the winning peak, and a strength close to it means the match is unclear (repetitive sound, or not the same moment). Offsets are searched up to max_offset_seconds either way, where at least half of the shorter sound overlaps the other. Up to 600 s read from each side.\nA side with no sound in its range (no audio stream, a range past its end, or digital silence) fails with no_audio, naming which side. Short reads answer at once; longer ones return a task or job.","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_correlate_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_correlate_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/media.get":{"post":{"operationId":"media_get","summary":"Get media","description":"Status, where it came from (origin: the import source, the export of which timeline_id and preset, or the create.* tool and the media it was made from), a signed download url for the file (media is kept 7 days after last use, as kept_until and expiry say: save the file from it to keep it, and media.import it again later) and a page_url that plays or shows it in any browser (to give a person), its format (extension and mime_type, read from the file, not its name), everything the probe read (probe: the format and every stream, e.g. pix_fmt, colour space, primaries, transfer), duration, frame rate, conform reasons, integrated loudness and summaries of media.analyze results under analyses (counts only: analyses.transcript.words is how many words). While it is importing or being made, job names the job doing it and its progress. include returns those results at the top level, e.g. include [\"transcript\"] gives transcript.words, the list of words with times. For long media, read them in pieces: from_seconds and to_seconds keep what overlaps that stretch of the media, offset and limit page through what is left, and pages says, per analysis, the index of the first item returned in the whole list (for transcript words, the index clip.add source {words} takes), how many matched and next_offset for the next page (null at the end).","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_get_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_get_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/media.seek":{"post":{"operationId":"media_seek","summary":"Seek by natural language","description":"Find the moments in a video, or in an edit as it renders, that match what you describe in plain words, so you go straight to them instead of watching it all. Name each criterion and say what a matching frame shows; you get back the stretches of time where each one holds, with the time and picture of the best frame in each.\nUse it to:\n- Check quality: find frames that are too dark or blown out, out of focus, black or blank (a gap in an edit), with a microphone or crew in shot, with text cut off at the edge, or with a caption over a face. With timeline_id it checks the edit as it renders, titles, effects and gaps included.\n- Watch efficiently: looking through a whole video costs you a picture for every moment. Seek judges the frames for you and says where things are, so you look only there: where the demo starts, where the speaker holds up the product, where the second location begins.\n- Pick shots: B-roll or a thumbnail moment that fits a description (\"a wide shot of a city street at night\", \"she smiles straight at the camera with her eyes open\").\n- Find changes: with with_previous, where the slide changes, someone walks in or the camera angle switches (\"`frame` shows a different slide from `previous`\").\n- Find room or trouble for overlays: where the lower third stays empty for a title, or where a logo, a licence plate or a face appears that needs a blur.\n\nHOW TO WRITE CRITERIA. A fast judgment model (preview) judges each sampled frame on its own, as a picture named `frame` (about 512 px on its long edge; with with_previous also `previous`, the frame sampled before), and gives each criterion the probability that it is true. A criterion is a statement or a question about how the picture looks. Keep one judgment to a criterion, and say what shows rather than a verdict: not \"bad lighting\" but \"the faces are too dark to make out their eyes\"; not \"a good thumbnail\" but \"a person looks straight at the camera with eyes open and mouth closed\". Criteria that name no picture or state entry in backticks are asked about `frame` (\"In `frame`: <your words>\"); name `frame`, `previous` or your state entries yourself to judge them together (\"`frame` shows the button `line` talks about\"). The judgment model answers most accurately from examples: give {instructions, criteria: {true: \"…\", false: \"…\"}} with a case of each ({true: \"the face is a dark silhouette against a bright window\", false: \"the face is evenly lit, a little dim\"}). Detail too small to see at that size (fine print, slight softness) answers poorly; check it with render.frames at full size.\nREADING THE RESULT. matches gives, per criterion, each run of consecutive samples at or above min_probability (default 0.5), with its start, end and best sample: peak_seconds, frame (for render.frames) and uri (a resource to read the picture). samples has every probability, for your own cut-off. A probability near 0.5 means the judgment model cannot tell, not that the thing is half there: reword a criterion that keeps landing there. asked shows the question each criterion became.\nCOST. Each frame is one judgment however many criteria it carries, so ask everything you are looking for in one call (up to 32 criteria). Work in passes: every_seconds 2 to 5 over the whole video, then at_seconds around a match to find more exactly where it starts. Sampling sees only the frames it samples, so no match can't prove a one-frame defect (a flash, a black or dropped frame) absent: read every frame of a suspect stretch with render.frames, or measure black frames with qa.check. Up to 600 frames a call. Long-running: returns a task, or a job_id for job.get.\nmedia.analyze look asks typed questions (a choice, a score, a box) of every frame when you need measurements rather than moments; judge.ask judges one picture at once.","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_seek_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_seek_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/media.search":{"post":{"operationId":"media_search","summary":"Search media by natural language","description":"Find moments across all the user's media from what you describe in plain words: media.seek across every file instead of one. looks criteria are judged on pictures: each keyframe of every video (a new keyframe wherever the picture changes, at least every 10 s, picked when the media was indexed) and each image. says criteria are judged on ~30 s passages of transcripts the media already has. You get matches per criterion across files (media, start, end, best moment and its picture), most probable first.\nCOST. Each keyframe or passage judged is one judgment, however many criteria (up to 32) it carries; 200 judgments are a credit. Images cost 1 each; a 10-minute video about 50 to 260 by how much its picture changes. Every file the search keeps adds to the cost, so narrow first: kind, media_ids, from, name_contains, duration and from/until_seconds are free and cut what is judged before anything is. candidates is free too: it keeps the N media whose pictures look most like looks by local similarity, far cheaper, though it can drop media where the thing is small or brief. Ask everything you are looking for in one call.\nA search estimated over 1 credit is not run: the result has searched false, the estimate (judgments, credits, by kind, the largest media) and what the free filters could cut, and nothing is charged. Tell the user the cost and run it again with cost_override once they agree.\nHOW TO WRITE CRITERIA. As for media.seek: say what a matching picture shows or what the speech says, one judgment each, with {instructions, criteria: {true, false}} examples for accuracy. Pictures are judged at about 512 px, so small detail (a logo in a corner, fine print) can be missed.\nskipped lists media the filters kept that were not judged, and why (still indexing after import, no transcript, outside candidates): not found there is not the same as not there. Long-running: returns a task, or a job_id for job.get.","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_search_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_search_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/media.listen":{"post":{"operationId":"media_listen","summary":"Find sounds by description","description":"Find when something can be heard in a video or audio file, or in an edit as it plays, from what you describe in plain words, so you go straight to it instead of listening to it all: laughter, applause, a cough, a door slamming, a phone ringing, a dog barking, music starting, someone typing, a car passing. Name each sound and say what it is; you get back the stretches of time where each one can be heard, with the moment it is clearest.\nUse it to:\n- Find reactions and moments: where the crew or the audience laughs, where people clap or cheer, a gasp, a scream.\n- Find trouble to cut or cover: a cough, a sneeze, a phone going off, a door, a siren, wind on the microphone, a click or a bump.\n- Find sound to cut on: a clap, a bang, a hit, the music starting or stopping.\n\nHOW IT WORKS. FlexSED, an open-vocabulary sound detection model (local, on the CPU; about 15 to 20 times faster than real time), listens to every 40 ms of the sound and gives each description the probability that it can be heard there. Describe the sound itself, briefly, as you would caption it (\"laughter\", \"a crowd cheering\", \"glass breaking\"), not the scene or a judgment; it is asked as \"The sound of <your words>\". Short, common sound names work best; put each sound you want in its own entry, up to 16 a call, all listened for at once.\nLIMITS. Inside music it hears \"music\", not drums, instruments or single hits (for hits in music, media.analyze beats). Inside speech it hears \"speech\", not what is said: words and fillers such as um sound alike to it. A short sound can score higher over a short from_seconds to until_seconds around it.\nREADING THE RESULT. matches gives, per sound, each run of frames at or above min_probability (default 0.5) with its start, end, peak_seconds and frame (for render.frames; media frames for video, timeline frames for an edit). peaks gives the highest probability each sound reaches, and scores every probability (step_seconds apart), for your own cut-off. A sound whose peak stays well under your cut-off is most likely not there; one hovering near it is worth a listen or a lower cut-off.\nMedia or an edit: with media_id, times are the file's own seconds; with timeline_id, it listens to the edit's mix as it plays (cuts, gaps, levels and effects included), over from_seconds to until_seconds, and times are timeline seconds, so a match is where that sound now sits in the edit. A source or range with no sound fails with no_audio, naming it.\nFor the 447 sounds with names (Laughter, Applause, Cough, Speech, Music…) as stored data, media.analyze kind sounds. Long-running: returns a task, or a job_id for job.get.","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_listen_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/media_listen_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/judge.ask":{"post":{"operationId":"judge_ask","summary":"Ask questions about text or pictures","description":"Answer your questions about text and pictures you give (yes or no, a choice, a score, or where something is in a picture), as typed answers in about a second. It asks a fast judgment model (preview).\nThe judgment model sees exactly the state: each entry under its name, and your questions refer to entries by name in backticks (\"in `passage`\"). An entry is text (a string, or a JSON object or array of related facts) or a picture: {media_id} for an imported image, {media_id, at_seconds} for the frame of a video at that time, {timeline_id, at_seconds} for a frame of an edit as it renders (to judge a grade or a layout you made). Mix them freely. Each call stands alone, so put everything a judgment needs into its state.\nChoose the type by the answer you need. noul: yes or no, answered as noul, the probability of yes from 0 to 1 (0.5 or more reads as yes). choice: one of options you name, answered as choice plus probabilities and confidence. score: a degree on levels you order, answered as score (0 is the first level) plus confidence. box: where one thing is in a picture, answered as box {x, y, w, h} in fractions of that picture plus confidence.\nWrite each question as one thing, worded so yes means it is there. Open with what the state is (\"`passage` is a transcript of someone speaking off the cuff\"), and give a noul criteria {true, false} with an example of each: the judgment model answers most accurately from examples. To locate, name the one thing so only it fits (\"the yellow headline 'Get started' at the top of `shot`\") and ask a noul whether it is there; trust a box with high confidence.\nOne call answers many questions about one state at once, so judge many items together: put the shared text in state once, and give each item its own question carrying its own marked copy. Filler words: state {passage: \"So basically the way this works is\"}, and per word a noul \"`passage` is a transcript of someone speaking off the cuff. With one word marked: \"So [[basically]] the way this works is\". Is the marked word filler, so the sentence says the same without it?\" with criteria {true: \"the [[the]] report is late\", false: \"the report is [[late]]\"}. A shot: state {shot: {media_id, at_seconds: 12.5}}, choice \"What fills `shot`?\" with options {speaker: \"A person talking to camera\", screen: \"A screen recording\", none: \"Anything else\"}. Both: state {line: \"Click Get started\", screen: {media_id, at_seconds: 4}}, noul \"Does `screen` show the button `line` talks about?\".\nUp to 300 questions, 8 pictures and 200k characters of text a call. To find where something shows in a video or an edit, media.seek takes it in plain words; to measure every frame, media.analyze look asks your questions of frames it samples. Guide to writing questions: https://docs.typesafe.ai/primitives and https://docs.typesafe.ai/images.","tags":["judge"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/judge_ask_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/judge_ask_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/create.motion":{"post":{"operationId":"create_motion","summary":"Create a motion graphic","description":"Render animated HTML to a video with alpha, frame-exactly: lower thirds, animated titles, callouts, logo stings, kinetic type, generated graphics. Place the media_id with clip.add on a track above the video. Up to 60 s, and width × height × fps × seconds up to 30 s of 1080p30. Runs in the sandbox: no network (inline everything, load libraries from lib/; assets are for imported files the page must show as they are, like the user's logo or a font), fixed memory and time limits. Fonts installed: Inter, Montserrat, Open Sans, Lato, Bebas Neue, Lobster Two, Comic Neue, Fira Code, DejaVu Sans, Serif and Mono, and Noto for most scripts (video://catalog/fonts lists every one); any other font goes in as an imported asset. To match a reference you were shown, rebuild it in HTML/SVG; it does not need importing. The result's warnings list what went wrong in the page: uncaught errors, console errors, files blocked or not found. Long-running: returns a task, or {job_id, status, media_id} for job.get. The same recipe returns the same media, already completed with its result in result.","tags":["create"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_motion_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_motion_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/create.still":{"post":{"operationId":"create_still","summary":"Create a still","description":"Render an HTML page to a PNG: title and end cards, thumbnails, overlays, designed text. Transparent where nothing is painted. Capture waits for fonts, and for window.__ready if the page sets it to a promise (up to 10 s). Runs in the sandbox: no network (inline everything, load libraries from lib/; assets are for imported files the page must show as they are, like the user's logo or a font), fixed memory and time limits. Fonts installed: Inter, Montserrat, Open Sans, Lato, Bebas Neue, Lobster Two, Comic Neue, Fira Code, DejaVu Sans, Serif and Mono, and Noto for most scripts (video://catalog/fonts lists every one); any other font goes in as an imported asset. To match a reference you were shown, rebuild it in HTML/SVG; it does not need importing. The result's warnings list what went wrong in the page: uncaught errors, console errors, files blocked or not found. Long-running: returns a task, or {job_id, status, media_id} for job.get. The same recipe returns the same media, already completed with its result in result.","tags":["create"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_still_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_still_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/create.matte":{"post":{"operationId":"create_matte","summary":"Create a matte","description":"A solid or gradient picture (PNG, any length on a timeline): backgrounds, slugs, colour washes with clip.set_blend. Gradients work like CSS: angle 180 runs top to bottom; radial reaches the corners; colours may carry alpha (#RRGGBBAA). Long-running like every create.* tool, but quick.","tags":["create"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_matte_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_matte_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/create.voiceover":{"post":{"operationId":"create_voiceover","summary":"Create a voiceover","description":"English text spoken by a natural voice (Kokoro, local; the model downloads once) as WAV media. words (default) times each word into the media transcript (media.get include transcript). Long-running: a task, or {job_id, media_id} for job.get.","tags":["create"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_voiceover_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_voiceover_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/create.cutout":{"post":{"operationId":"create_cutout","summary":"Cut out a subject","description":"A subject without its background, local: ProRes 4444 with alpha and the sound, or a PNG, to lay over a new background. subject any (BiRefNet) cuts out products, animals or objects; people (MODNet) is fast enough for long video. region: one item by its bounds, followed; also a clip.set_mask matte. Long-running: a task, or {job_id, media_id} for job.get.","tags":["create"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_cutout_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_cutout_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/create.stabilized":{"post":{"operationId":"create_stabilized","summary":"Steady shaky video","description":"A steadied copy of shaky video, local (vid.stab): one pass measures the camera shake over the whole media, a second moves each frame against a smoothed camera path. New media, ProRes with the sound, to put on the timeline in place of the shaky clip (clip.replace keeps its place and timing). Long-running: a task, or {job_id, media_id} for job.get.","tags":["create"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_stabilized_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_stabilized_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/create.upscaled":{"post":{"operationId":"create_upscaled","summary":"Add resolution","description":"A larger copy of low-resolution video or an image with detail drawn in, local: Real-ESRGAN (realesr-general-x4v3, on the CPU) makes each frame four times the size, then it is resized to scale. Slow: on 8 cores about 1 s a frame for 320x180, 2.5 s for 640x360. Sources up to 1280x720, results up to 3840 px on the long edge. New media (ProRes with the sound, or a PNG) to put in place of the original (clip.replace keeps its place and timing). Long-running: a task, or {job_id, media_id} for job.get.","tags":["create"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_upscaled_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_upscaled_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/create.stems":{"post":{"operationId":"create_stems","summary":"Separate voice and music","description":"The sound of a video or audio file pulled apart into stems, each new audio media for clip.add: vocals (voices, spoken or sung), drums, bass, other (everything else: guitars, keys, effects, room noise) and no_vocals (all but the voice, in one file). Laid together at the same time, the four stems make the original sound again.\nUse it to keep only the voice (lose the music under an interview: vocals), keep only the music (take the voice out of a clip: no_vocals), turn the music down under speech (vocals and no_vocals on their own tracks, with their own gain), or take a beat or a bass line on its own.\nDemucs v4 (htdemucs), local, on the CPU: about a fifth of the media's length on 8 cores (a minute of sound in about 15 s). Built for music; on speech with background noise, vocals keeps the voice and other takes most of the noise. Media up to 3 hours. Each stem is a 32-bit float WAV, 44.1 kHz stereo, as long as the original; the same media and stems give the same media again while they last. Long-running: a task, or a job_id for job.get.","tags":["create"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_stems_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_stems_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/create.lipsync":{"post":{"operationId":"create_lipsync","summary":"Lip-sync a video to new speech","description":"Make a person on camera say different words: their mouth is redrawn to match the speech you give (a re-recorded line, a create.voiceover, a word taken from elsewhere in the take). Runs at the user's lip-sync provider on their own key (sync. labs), and the provider bills them for each second sent. Only for the user's own footage, or people who agreed to it (cuttingfloor.ai/acceptable-use). To replace a line or swap a word, give range, the span of the video where it is said, and audio (with audio_range) holding just the new words. The result is that span alone, re-synced and carrying the new speech, as long as the speech with sync_mode remap; place it over the original span (clip.add on a track above, or clip.replace) and mute the old words. Send only the span: it costs less and finishes sooner. Lip sync is for when the face stays on screen while the words change. When the speaker is off screen at that moment, or a cutaway (b-roll, the screen being talked about, a reaction) can cover the splice, the cutaway hides the edit without it. Takes minutes. Long-running: a task, or {job_id, media_id} for job.get. The same recipe returns the same media. Provider limits (plan length, credits, file size) come back as limit_exceeded with the provider's error_code.","tags":["create"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_lipsync_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/create_lipsync_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/render.frames":{"post":{"operationId":"render_frames","summary":"Render frames","description":"Look at a timeline (or a media file): up to 16 frames as one contact-sheet image (layout grid) or one image each (single). Media frames are numbered at the media frame rate; a picture that can be see-through (alpha or a palette) is shown over a light checkerboard, so transparency shows as checks and a background baked into the file as itself. size full: up to 4 frames at the sequence (or media) size from the original media, for thumbnails and stills to keep. format webp (default), png or jpeg, with quality for webp and jpeg. Each image comes inline and with a signed download url.","tags":["render"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/render_frames_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/render_frames_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/export.video":{"post":{"operationId":"export_video","summary":"Export video","description":"Render the timeline to a file, at the sequence size and frame rate. Formats: mp4_h264 (MP4), mp4_h264_fast (MP4, quick and small with sound, to watch a cut), mp4_av1 (MP4, AV1/Opus), mov_prores_422hq (MOV), gif (15 fps), wav, mp3. overrides sets another size (a box, aspect kept), fps, bitrate or crf (video://catalog/presets). Scaling up adds no detail: a picture made larger than its source looks soft. Long-running: returns a task, or {job_id} for job.get. The result links the file (a resource_link to video://jobs/{job_id}/output, which reads as the file, or its signed URL when large), has a signed download URL and a page_url that plays it in any browser (the link to give a person to watch or share), both working for 168 h (job.get gives fresh ones). The file itself is deleted 7 days after the export finishes (kept_until, and expiry in words): save it from url to keep it. The server keeps the file 7 days, as a working copy: when the user has a finished piece to keep, offer to save it from the url where they keep their files, and media.import it to use it again. qa.check measures a render (gaps, frames, loudness) before you export. sha256 and fingerprint tell two renders apart without downloading them (fingerprint matches media.get of the file once imported).","tags":["export"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/export_video_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/export_video_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/qa.check":{"post":{"operationId":"qa_check","summary":"QA check","description":"Measure the rendered timeline: gaps in the picture, offline media, rendered against expected frame count, integrated loudness (LUFS) and true peak (dBTP), plus black and silent stretches when you give their settings. With speech {min_probability}, every cut is listed with speech facts: the speech probability of the mix just before and after it (Silero VAD), the seconds without speech each side, and, per clip edge, the transcript word it cuts through and how much of that word is lost (from the media's transcript, when it has one). Facts only, no verdicts. A timeline up to 20 s is checked within the call (which waits its turn for a render when the server is busy) and answers as a completed job, the report in result; longer ones return a task or job.","tags":["qa"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/qa_check_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/qa_check_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/job.get":{"post":{"operationId":"job_get","summary":"Get job","description":"Status, progress and, once completed, the result of long-running calls (media.import, media.analyze, create.*, export.video, qa.check). Same record as tasks/get. status_message says what it is doing, or where it stands in the queue; for names the media or timeline. wait_seconds (up to 50) answers when any job asked for finishes, fails or is cancelled, or when the wait runs out (then with its progress), so one call waits instead of many polls. seconds_left and starts_in_seconds come only when progress so far allows. job_ids reads many and answers {jobs, not_found}, each result in brief (result_summary: lists cut to their first items, with what was cut) unless result is full; result summary does the same for one job. A job whose progress stops for minutes ends with a stalled error, freeing its slot.","tags":["job"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/job_get_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/job_get_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/job.list":{"post":{"operationId":"job_list","summary":"List jobs","description":"Your recent jobs, newest first, each with its status, progress and for (the media or timeline it is for), filtered by status, tool or media_id. Results are left out unless you ask (result summary or full); job.get reads one.","tags":["job"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/job_list_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/job_list_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/job.cancel":{"post":{"operationId":"job_cancel","summary":"Cancel job","description":"Stop a job, queued or running, within seconds: its engines are killed and its slot goes to the next job. Finished jobs are left as they are.","tags":["job"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/job_cancel_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/job_cancel_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/export.timeline":{"post":{"operationId":"export_timeline","summary":"Export timeline","description":"Write the edit for another editor: fcpxml (Final Cut Pro, DaVinci Resolve), otio (Premiere, Resolve, OpenTimelineIO apps), edl (CMX 3600, one video track), or srt/vtt (the captions). Best effort: warnings lists what the format could not carry (masks, blend modes, effects, animated transforms, ramps, text styling). timeline.get is the lossless copy. media reference (default) points at the media where this server keeps it, which another machine cannot open and which goes 7 days after last use (the result warns); media collect makes a .zip with the media files next to the timeline file, to hand the edit on. Long-running: a task, or {job_id} for job.get; the result has a signed download URL.","tags":["export"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/export_timeline_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/export_timeline_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/skills.search":{"post":{"operationId":"skills_search","summary":"Find a skill","description":"Find step-by-step instructions for a common job, written for you to follow with these tools: cutting the pauses, ums and restarts out of a talking video, for one. Search in the user's words: the skills that fit come back, best first. When none fits, or with no query, the answer is the list of every skill, a page at a time, to choose from by description. Read one with skills.get, then follow its Steps.","tags":["skills"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/skills_search_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/skills_search_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}},"/v1/skills.get":{"post":{"operationId":"skills_get","summary":"Read a skill","description":"The whole skill as Markdown: when to use it, what it needs, numbered Steps naming the tools to call, a decision table and the rules to keep. Follow the Steps in order.","tags":["skills"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/skills_get_args"}}}},"responses":{"200":{"description":"The result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/skills_get_result"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key from your account page (cf_…), or a cuttingfloor sign-in token"}},"responses":{"Error":{"description":"The call was refused: what went wrong, and what to do instead","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","additionalProperties":true},"hint":{"type":"string","description":"What to do instead: the next call, valid values"}}},"timeline_create_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"tracks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["video","audio"]},"name":{"type":"string"}},"required":["id","kind","name"]},"description":"The new tracks; edits take the id (track_id), not the name"}},"required":["timeline_id","tracks"]},"timeline_create_args":{"type":"object","properties":{"name":{"default":"Untitled","type":"string","minLength":1,"maxLength":200},"sequence":{"type":"object","properties":{"width":{"type":"integer","minimum":16,"maximum":8192,"multipleOf":2},"height":{"type":"integer","minimum":16,"maximum":8192,"multipleOf":2},"fps":{"type":"object","properties":{"num":{"type":"integer","exclusiveMinimum":0},"den":{"type":"integer","exclusiveMinimum":0}},"required":["num","den"]},"audio_rate":{"default":48000,"type":"integer","exclusiveMinimum":0},"channels":{"default":2,"type":"integer","minimum":1,"maximum":8},"color":{"default":"bt709","type":"string","const":"bt709"}},"required":["width","height","fps"]},"tracks":{"default":{"video":1,"audio":1},"description":"How many empty tracks to start with","type":"object","properties":{"video":{"type":"integer","minimum":0,"maximum":32},"audio":{"type":"integer","minimum":0,"maximum":32}},"required":["video","audio"]}},"required":["sequence"]},"timeline_get_result":{"type":"object","properties":{"timeline_id":{"type":"string"},"parent":{"type":["string","null"]},"name":{"type":"string"},"sequence":{"type":"object","properties":{"width":{"type":"integer","minimum":16,"maximum":8192,"multipleOf":2},"height":{"type":"integer","minimum":16,"maximum":8192,"multipleOf":2},"fps":{"type":"object","properties":{"num":{"type":"integer","exclusiveMinimum":0},"den":{"type":"integer","exclusiveMinimum":0}},"required":["num","den"]},"audio_rate":{"default":48000,"type":"integer","exclusiveMinimum":0},"channels":{"default":2,"type":"integer","minimum":1,"maximum":8},"color":{"default":"bt709","type":"string","const":"bt709"}},"required":["width","height","fps","audio_rate","channels","color"]},"duration":{"type":"integer","minimum":0,"description":"Timeline length in frames"},"tracks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["video","audio"]},"name":{"type":"string"},"muted":{"type":"boolean"},"hidden":{"type":"boolean"},"locked":{"type":"boolean"},"clips":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"default":"media","type":"string","enum":["media","timeline","title","caption","adjustment"]},"kind":{"type":"string","enum":["video","audio"]},"track_id":{"type":"string"},"media_id":{"description":"For media clips","type":"string"},"nested_timeline":{"description":"For nested timelines (compound clips): a key of the view's `nested` map","type":"string"},"text":{"description":"For titles and captions","type":"string"},"words":{"description":"Caption word timings, frames from the clip start","type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"}},"required":["text","start","end"]}},"style":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"As text.set style takes it"},"spans":{"description":"Styled runs, as text.set spans takes them","type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"start":{"type":"integer","minimum":0,"description":"First frame on the timeline"},"end":{"type":"integer","minimum":0,"description":"Frame after the last one (exclusive)"},"source":{"type":"object","properties":{"in":{"type":"integer","minimum":0},"out":{"type":"integer","minimum":0}},"required":["in","out"],"description":"Source range in sequence frames from the start of the media, out exclusive; longer or shorter than the clip when its speed is changed"},"link":{"description":"Link group: linked clips move, trim and split together","type":["string","null"]},"enabled":{"type":"boolean"},"speed":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"As clip.set_speed takes it"},"gain":{"description":"dB, as audio.set_gain takes it"},"pan":{"description":"-1 left to 1 right","type":"number"},"fade":{"type":"object","properties":{"in_frames":{"type":"number"},"out_frames":{"type":"number"}}},"effects":{"description":"{id, name, params, enabled}; params as video://catalog/effects lists them","type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"transform":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"As clip.set_transform takes it"},"blend":{"type":"string","enum":["normal","add","multiply","screen","overlay","darken","lighten","color_dodge","color_burn","hard_light","soft_light","difference","exclusion"]},"mask":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"As clip.set_mask mask takes it"},"animation":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"As clip.set_animation takes it"}},"required":["id","type","kind","track_id","start","end","source","link","enabled"]}},"transitions":{"description":"Transitions at cuts, frames end exclusive","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"from_clip_id":{"type":"string"},"to_clip_id":{"type":"string"},"kind":{"type":"string","enum":["dissolve","dip_to_black","dip_to_white","wipe_left","wipe_right","wipe_up","wipe_down","slide_left","slide_right","slide_up","slide_down","push_left","push_right","push_up","push_down","zoom_in","zoom_out","iris","spin","crossfade"]},"start":{"type":"integer","minimum":0},"end":{"type":"integer","minimum":0}},"required":["id","from_clip_id","to_clip_id","kind","start","end"]}},"effects":{"description":"Effects on every clip","type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["id","kind","name","muted","hidden","locked","clips"]},"description":"Video tracks bottom to top, then audio tracks"},"media":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"name":{"type":"string"},"duration":{"description":"Length in sequence frames, exact (45.48 ends part way into frame 45, which a clip of the whole media counts as a frame); null for stills","anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"video":{"type":"boolean"},"audio":{"type":"boolean"}},"required":["name","duration","video","audio"]}},"effects":{"description":"Effects on the whole picture and mix","type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"master":{"type":"object","properties":{"gain_db":{"type":"number"},"limit_db":{"type":"number"}},"required":["gain_db"]},"nested":{"description":"Timelines nested as compound clips, at any depth: each has this shape without timeline_id, parent or nested","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["timeline_id","parent","name","sequence","duration","tracks","media"]},"timeline_get_args":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"}},"required":["timeline_id"]},"timeline_load_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"}},"required":["timeline_id"]},"timeline_load_args":{"type":"object","properties":{"timeline":{"type":"object","properties":{"name":{"type":"string"},"sequence":{"type":"object","properties":{"width":{"type":"integer","minimum":16,"maximum":8192,"multipleOf":2},"height":{"type":"integer","minimum":16,"maximum":8192,"multipleOf":2},"fps":{"type":"object","properties":{"num":{"type":"integer","exclusiveMinimum":0},"den":{"type":"integer","exclusiveMinimum":0}},"required":["num","den"]},"audio_rate":{"default":48000,"type":"integer","exclusiveMinimum":0},"channels":{"default":2,"type":"integer","minimum":1,"maximum":8},"color":{"default":"bt709","type":"string","const":"bt709"}},"required":["width","height","fps"]},"tracks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["video","audio"]},"name":{"type":"string"},"muted":{"type":"boolean"},"hidden":{"type":"boolean"},"locked":{"type":"boolean"},"clips":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"default":"media","type":"string","enum":["media","timeline","title","caption","adjustment"]},"kind":{"type":"string","enum":["video","audio"]},"track_id":{"type":"string"},"media_id":{"description":"For media clips","type":"string"},"nested_timeline":{"description":"For nested timelines (compound clips): a key of the view's `nested` map","type":"string"},"text":{"description":"For titles and captions","type":"string"},"words":{"description":"Caption word timings, frames from the clip start","type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"}},"required":["text","start","end"]}},"style":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"As text.set style takes it"},"spans":{"description":"Styled runs, as text.set spans takes them","type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"start":{"type":"integer","minimum":0,"description":"First frame on the timeline"},"end":{"type":"integer","minimum":0,"description":"Frame after the last one (exclusive)"},"source":{"type":"object","properties":{"in":{"type":"integer","minimum":0},"out":{"type":"integer","minimum":0}},"required":["in","out"],"description":"Source range in sequence frames from the start of the media, out exclusive; longer or shorter than the clip when its speed is changed"},"link":{"description":"Link group: linked clips move, trim and split together","type":["string","null"]},"enabled":{"type":"boolean"},"speed":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"As clip.set_speed takes it"},"gain":{"description":"dB, as audio.set_gain takes it"},"pan":{"description":"-1 left to 1 right","type":"number"},"fade":{"type":"object","properties":{"in_frames":{"type":"number"},"out_frames":{"type":"number"}}},"effects":{"description":"{id, name, params, enabled}; params as video://catalog/effects lists them","type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"transform":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"As clip.set_transform takes it"},"blend":{"type":"string","enum":["normal","add","multiply","screen","overlay","darken","lighten","color_dodge","color_burn","hard_light","soft_light","difference","exclusion"]},"mask":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"As clip.set_mask mask takes it"},"animation":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"As clip.set_animation takes it"}},"required":["id","kind","track_id","start","end","source","link","enabled"]}},"transitions":{"description":"Transitions at cuts, frames end exclusive","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"from_clip_id":{"type":"string"},"to_clip_id":{"type":"string"},"kind":{"type":"string","enum":["dissolve","dip_to_black","dip_to_white","wipe_left","wipe_right","wipe_up","wipe_down","slide_left","slide_right","slide_up","slide_down","push_left","push_right","push_up","push_down","zoom_in","zoom_out","iris","spin","crossfade"]},"start":{"type":"integer","minimum":0},"end":{"type":"integer","minimum":0}},"required":["id","from_clip_id","to_clip_id","kind","start","end"]}},"effects":{"description":"Effects on every clip","type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["id","kind","name","muted","hidden","locked","clips"]},"description":"Video tracks bottom to top, then audio tracks"},"media":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"name":{"type":"string"},"duration":{"description":"Length in sequence frames, exact (45.48 ends part way into frame 45, which a clip of the whole media counts as a frame); null for stills","anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"video":{"type":"boolean"},"audio":{"type":"boolean"}},"required":["name","duration","video","audio"]}},"effects":{"description":"Effects on the whole picture and mix","type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"master":{"type":"object","properties":{"gain_db":{"type":"number"},"limit_db":{"type":"number"}},"required":["gain_db"]},"nested":{"description":"Timelines nested as compound clips, at any depth: each has this shape without timeline_id, parent or nested","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"timeline_id":{"type":"string"},"parent":{"type":["string","null"]},"duration":{"type":"integer","minimum":0}},"required":["name","sequence","tracks","media"],"description":"A timeline as returned by timeline.get"}},"required":["timeline"]},"timeline_history_result":{"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"parent":{"anyOf":[{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},{"type":"null"}]},"tool":{"type":["string","null"]},"args":{},"available":{"type":"boolean","description":"false once the stored timeline has expired"}},"required":["timeline_id","parent","tool","args","available"]}},"truncated":{"type":"boolean"}},"required":["entries","truncated"]},"timeline_history_args":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"limit":{"default":50,"type":"integer","minimum":1,"maximum":500}},"required":["timeline_id"]},"timeline_diff_result":{"type":"object","properties":{"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]}}},"required":["changed"]},"timeline_diff_args":{"type":"object","properties":{"from":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"to":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"}},"required":["from","to"]},"timeline_set_sequence_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"timeline_set_sequence_args":{"type":"object","properties":{"sequence":{"type":"object","properties":{"width":{"type":"integer","minimum":16,"maximum":8192,"multipleOf":2},"height":{"type":"integer","minimum":16,"maximum":8192,"multipleOf":2},"fps":{"type":"object","properties":{"num":{"type":"integer","exclusiveMinimum":0},"den":{"type":"integer","exclusiveMinimum":0}},"required":["num","den"]},"audio_rate":{"default":48000,"type":"integer","exclusiveMinimum":0},"channels":{"default":2,"type":"integer","minimum":1,"maximum":8},"color":{"default":"bt709","type":"string","const":"bt709"}},"required":["width","height","fps"]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["sequence","timeline_id"]},"track_add_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"track_add_args":{"type":"object","properties":{"kind":{"type":"string","enum":["video","audio"]},"name":{"type":"string","minLength":1,"maxLength":100},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["kind","timeline_id"]},"track_remove_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"track_remove_args":{"type":"object","properties":{"track_id":{"type":"string"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["track_id","timeline_id"]},"track_set_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"track_set_args":{"type":"object","properties":{"track_id":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":100},"muted":{"type":"boolean"},"hidden":{"type":"boolean"},"locked":{"type":"boolean"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["track_id","timeline_id"]},"clip_add_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_add_args":{"type":"object","properties":{"track_id":{"type":"string","description":"Track for the clip; a linked A/V clip puts its other half on link_track_id"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"nested_timeline_id":{"description":"Instead of media: nest another timeline as one clip (a compound clip)","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"at_frame":{"description":"Where the clip starts. Default: after the last clip","type":"integer","minimum":0},"after_clip_id":{"description":"Start where this clip ends (instead of at_frame)","type":"string"},"source":{"description":"Where in the media to start and stop, in frames at the sequence rate (frame 48 at 24 fps is 2 s into the media), out exclusive. Default: the whole media","anyOf":[{"type":"object","properties":{"in":{"type":"integer","minimum":0},"out":{"type":"integer","minimum":0}},"required":["in","out"]},{"type":"object","properties":{"words":{"type":"array","prefixItems":[{"type":"integer","minimum":0},{"type":"integer","minimum":0}],"items":false,"minItems":2,"maxItems":2}},"required":["words"],"description":"Transcript words i to j (inclusive), from media.get include transcript: from the frame word i starts in to the frame after word j ends, with no padding (clip.trim adds room for a breath or a word's tail)"}]},"duration_frames":{"description":"Length for stills (default 5 s); ignored when source is given","type":"integer","exclusiveMinimum":0},"av":{"default":"linked","description":"linked: video and audio as a link group; video or audio: only that part","type":"string","enum":["linked","video","audio"]},"link_track_id":{"description":"Track for the other half of a linked clip. Default: the first track of that kind","type":"string"},"mode":{"default":"overwrite","description":"overwrite replaces what is underneath; insert pushes later clips right","type":"string","enum":["overwrite","insert"]},"other_tracks":{"default":"stay","description":"Tracks holding neither this clip nor a clip linked to it (linked clips, such as its own sound, always change with it): what they do when this edit moves later clips. stay: they don't move, and the result warns which clips there now play early or late. sync: they get the same change, so titles, overlays and sound stay in step: time taken out here comes out of them too (like range.extract), time added here opens the same gap in them (clips crossing that point are split, as insert does). Locked tracks always stay","type":"string","enum":["stay","sync"]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["track_id","timeline_id"]},"clip_remove_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_remove_args":{"type":"object","properties":{"clip_id":{"type":"string"},"ripple":{"default":false,"description":"Close the gap by pulling later clips left","type":"boolean"},"other_tracks":{"default":"stay","description":"Tracks holding neither this clip nor a clip linked to it (linked clips, such as its own sound, always change with it): what they do when this edit moves later clips. stay: they don't move, and the result warns which clips there now play early or late. sync: they get the same change, so titles, overlays and sound stay in step: time taken out here comes out of them too (like range.extract), time added here opens the same gap in them (clips crossing that point are split, as insert does). Locked tracks always stay","type":"string","enum":["stay","sync"]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","timeline_id"]},"clip_move_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_move_args":{"type":"object","properties":{"clip_id":{"type":"string"},"to_frame":{"type":"integer","minimum":0},"to_track_id":{"type":"string"},"mode":{"default":"overwrite","description":"overwrite replaces what is underneath; insert pushes later clips right","type":"string","enum":["overwrite","insert"]},"ripple":{"default":false,"description":"Close the gap left behind","type":"boolean"},"other_tracks":{"default":"stay","description":"Tracks holding neither this clip nor a clip linked to it (linked clips, such as its own sound, always change with it): what they do when this edit moves later clips. stay: they don't move, and the result warns which clips there now play early or late. sync: they get the same change, so titles, overlays and sound stay in step: time taken out here comes out of them too (like range.extract), time added here opens the same gap in them (clips crossing that point are split, as insert does). Locked tracks always stay","type":"string","enum":["stay","sync"]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","to_frame","timeline_id"]},"clip_trim_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_trim_args":{"type":"object","properties":{"clip_id":{"type":"string"},"edge":{"type":"string","enum":["start","end"]},"to_frame":{"type":"integer","minimum":0,"description":"New timeline position of that edge"},"ripple":{"default":false,"description":"Shift later clips so nothing overlaps and no gap opens","type":"boolean"},"side":{"default":"both","description":"Trim only one half of a link group (J/L cuts)","type":"string","enum":["both","video","audio"]},"other_tracks":{"default":"stay","description":"Tracks holding neither this clip nor a clip linked to it (linked clips, such as its own sound, always change with it): what they do when this edit moves later clips. stay: they don't move, and the result warns which clips there now play early or late. sync: they get the same change, so titles, overlays and sound stay in step: time taken out here comes out of them too (like range.extract), time added here opens the same gap in them (clips crossing that point are split, as insert does). Locked tracks always stay","type":"string","enum":["stay","sync"]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","edge","to_frame","timeline_id"]},"clip_split_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_split_args":{"type":"object","properties":{"clip_id":{"type":"string"},"at_frame":{"type":"integer","minimum":0},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","at_frame","timeline_id"]},"clip_link_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_link_args":{"type":"object","properties":{"clip_ids":{"minItems":2,"type":"array","items":{"type":"string"}},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_ids","timeline_id"]},"clip_unlink_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_unlink_args":{"type":"object","properties":{"clip_id":{"type":"string"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","timeline_id"]},"clip_set_enabled_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_set_enabled_args":{"type":"object","properties":{"clip_id":{"type":"string"},"enabled":{"type":"boolean"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","enabled","timeline_id"]},"clip_set_speed_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_set_speed_args":{"type":"object","properties":{"clip_id":{"type":"string"},"rate":{"description":"Constant speed: 2 = twice as fast","type":"number","minimum":0.05,"maximum":100},"curve":{"description":"Speed ramp: rates at fractions of the clip as it plays after the change (first at 0, last at 1; 0.5 is halfway through the new length), linear between. timeline.get gives each point its clip frame and source frame","minItems":2,"maxItems":32,"type":"array","items":{"type":"object","properties":{"at":{"type":"number","minimum":0,"maximum":1},"rate":{"type":"number","minimum":0.05,"maximum":100}},"required":["at","rate"]}},"reverse":{"type":"boolean"},"preserve_pitch":{"description":"Keep voices at their pitch (default true)","type":"boolean"},"interpolate":{"description":"Video, when it shows fewer new frames a second than the sequence (slowed, or a lower frame rate; rate 1 smooths that): none repeats frames; blend crossfades neighbours; motion makes new frames from the movement (minterpolate, slow). Made once as a job of its own (job.list); a render that needs it names the job until it is done, and an export waits. Up to 6000 frames a clip","type":"string","enum":["none","blend","motion"]},"ripple":{"default":true,"description":"Move later clips as the clip gets longer or shorter","type":"boolean"},"other_tracks":{"default":"stay","description":"Tracks holding neither this clip nor a clip linked to it (linked clips, such as its own sound, always change with it): what they do when this edit moves later clips. stay: they don't move, and the result warns which clips there now play early or late. sync: they get the same change, so titles, overlays and sound stay in step: time taken out here comes out of them too (like range.extract), time added here opens the same gap in them (clips crossing that point are split, as insert does). Locked tracks always stay","type":"string","enum":["stay","sync"]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","timeline_id"]},"clip_freeze_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_freeze_args":{"type":"object","properties":{"clip_id":{"type":"string"},"at_frame":{"type":"integer","minimum":0,"description":"Timeline frame to hold"},"duration_frames":{"type":"integer","exclusiveMinimum":0,"maximum":1000000},"other_tracks":{"default":"stay","description":"Tracks holding neither this clip nor a clip linked to it (linked clips, such as its own sound, always change with it): what they do when this edit moves later clips. stay: they don't move, and the result warns which clips there now play early or late. sync: they get the same change, so titles, overlays and sound stay in step: time taken out here comes out of them too (like range.extract), time added here opens the same gap in them (clips crossing that point are split, as insert does). Locked tracks always stay","type":"string","enum":["stay","sync"]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","at_frame","duration_frames","timeline_id"]},"clip_roll_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_roll_args":{"type":"object","properties":{"clip_id":{"type":"string","description":"The clip before the cut"},"to_frame":{"type":"integer","minimum":0,"description":"New position of the cut"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","to_frame","timeline_id"]},"clip_slip_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_slip_args":{"type":"object","properties":{"clip_id":{"type":"string"},"by_frames":{"type":"integer","minimum":-10000000,"maximum":10000000,"description":"Positive shows later source"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","by_frames","timeline_id"]},"clip_slide_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_slide_args":{"type":"object","properties":{"clip_id":{"type":"string"},"to_frame":{"type":"integer","minimum":0},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","to_frame","timeline_id"]},"clip_replace_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_replace_args":{"type":"object","properties":{"clip_id":{"type":"string"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"source_in":{"description":"Source frame the clip starts at. Default 0","type":"integer","minimum":0},"linked":{"default":true,"description":"Also swap its linked clips (its sound, or its picture) onto the new media, keeping their offset, where the new media has that kind; false swaps this clip only","type":"boolean"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","media_id","timeline_id"]},"range_lift_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"range_lift_args":{"type":"object","properties":{"range":{"type":"object","properties":{"start":{"type":"integer","minimum":0},"end":{"type":"integer","minimum":0}},"required":["start","end"],"description":"Timeline frames, end exclusive"},"track_ids":{"description":"Tracks to act on. Default: every unlocked track","minItems":1,"type":"array","items":{"type":"string"}},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["range","timeline_id"]},"range_extract_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"range_extract_args":{"type":"object","properties":{"range":{"type":"object","properties":{"start":{"type":"integer","minimum":0},"end":{"type":"integer","minimum":0}},"required":["start","end"],"description":"Timeline frames, end exclusive"},"track_ids":{"description":"Tracks to act on. Default: every unlocked track","minItems":1,"type":"array","items":{"type":"string"}},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["range","timeline_id"]},"title_add_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"title_add_args_TextStyle":{"type":"object","properties":{"font":{"description":"Installed: Inter, Montserrat, Open Sans, Lato, Bebas Neue, Lobster Two, Comic Neue, Fira Code, DejaVu Sans, Serif and Mono, Noto for most scripts (video://catalog/fonts lists all); another font: font_media_id","type":"string","minLength":1,"maxLength":100},"font_media_id":{"description":"An imported font","type":"string","pattern":"^m_[0-9a-z]{26}$"},"size":{"description":"Of frame height","type":"number","minimum":0.005,"maximum":1},"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"underline":{"type":"boolean"},"align":{"type":"string","enum":["left","center","right"]},"x":{"description":"Of frame width, 0 = left: where the text sits, by its align side","type":"number","minimum":-1,"maximum":2},"y":{"description":"Of frame height, 0 = top: where the anchor edge of the text sits","type":"number","minimum":-1,"maximum":2},"anchor":{"description":"Which edge of the text sits on y (titles default middle, captions bottom)","type":"string","enum":["top","middle","bottom"]},"max_width":{"description":"Of frame width: longer text wraps onto more lines, balanced in length","type":"number","minimum":0.05,"maximum":1},"letter_spacing":{"type":"number","minimum":-0.5,"maximum":2},"outline":{"anyOf":[{"type":"object","properties":{"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"width":{"type":"number","minimum":0,"maximum":0.5}},"required":["color","width"]},{"type":"null"}]},"shadow":{"anyOf":[{"type":"object","properties":{"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"distance":{"type":"number","minimum":0,"maximum":0.5},"blur":{"type":"number","minimum":0,"maximum":0.5}},"required":["color","distance"]},{"type":"null"}]},"box":{"anyOf":[{"type":"object","properties":{"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"padding":{"type":"number","minimum":0,"maximum":1}},"required":["color","padding"]},{"type":"null"}]},"highlight":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","enum":["none","fill","word","karaoke","pop"],"description":"Needs caption word timings. karaoke: each word takes color as it is spoken and keeps it; fill: likewise, sweeping across each word; word: only the word being spoken; pop: that word, growing a little"},"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"}},"required":["mode","color"]},{"type":"null"}]},"reveal":{"type":"string","enum":["none","typewriter","word_fade","word_pop"]},"reveal_frames":{"type":"integer","minimum":1,"maximum":10000},"max_lines":{"description":"At most this many lines at once: longer text shows in turn, a screenful at a time, each from its first word (by word timing, or by length without it). Lines are broken here, by the font, balanced in length; null shows it all at once","anyOf":[{"type":"integer","minimum":1,"maximum":20},{"type":"null"}]}}},"title_add_args_TextSpan":{"type":"object","properties":{"first_word":{"type":"integer","minimum":0,"maximum":10000},"last_word":{"type":"integer","minimum":0,"maximum":10000},"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"underline":{"type":"boolean"},"size":{"description":"Of frame height","type":"number","minimum":0.005,"maximum":1}},"required":["first_word","last_word"]},"title_add_args":{"type":"object","properties":{"track_id":{"type":"string","description":"A video track; text composites over the tracks below"},"text":{"type":"string","minLength":1,"maxLength":2000,"description":"Line breaks with \\n"},"at_frame":{"description":"Default: after the last clip on the track","type":"integer","minimum":0},"duration_frames":{"description":"Default 3 s","type":"integer","exclusiveMinimum":0,"maximum":1000000},"style":{"$ref":"#/components/schemas/title_add_args_TextStyle"},"spans":{"maxItems":500,"type":"array","items":{"$ref":"#/components/schemas/title_add_args_TextSpan"},"description":"Style part of the text: each span restyles words first_word to last_word (from 0: the timed words, or the text split at spaces), e.g. one word in yellow"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["track_id","text","timeline_id"]},"caption_add_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"caption_add_args_TextSpan":{"type":"object","properties":{"first_word":{"type":"integer","minimum":0,"maximum":10000},"last_word":{"type":"integer","minimum":0,"maximum":10000},"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"underline":{"type":"boolean"},"size":{"description":"Of frame height","type":"number","minimum":0.005,"maximum":1}},"required":["first_word","last_word"]},"caption_add_args_TextStyle":{"type":"object","properties":{"font":{"description":"Installed: Inter, Montserrat, Open Sans, Lato, Bebas Neue, Lobster Two, Comic Neue, Fira Code, DejaVu Sans, Serif and Mono, Noto for most scripts (video://catalog/fonts lists all); another font: font_media_id","type":"string","minLength":1,"maxLength":100},"font_media_id":{"description":"An imported font","type":"string","pattern":"^m_[0-9a-z]{26}$"},"size":{"description":"Of frame height","type":"number","minimum":0.005,"maximum":1},"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"underline":{"type":"boolean"},"align":{"type":"string","enum":["left","center","right"]},"x":{"description":"Of frame width, 0 = left: where the text sits, by its align side","type":"number","minimum":-1,"maximum":2},"y":{"description":"Of frame height, 0 = top: where the anchor edge of the text sits","type":"number","minimum":-1,"maximum":2},"anchor":{"description":"Which edge of the text sits on y (titles default middle, captions bottom)","type":"string","enum":["top","middle","bottom"]},"max_width":{"description":"Of frame width: longer text wraps onto more lines, balanced in length","type":"number","minimum":0.05,"maximum":1},"letter_spacing":{"type":"number","minimum":-0.5,"maximum":2},"outline":{"anyOf":[{"type":"object","properties":{"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"width":{"type":"number","minimum":0,"maximum":0.5}},"required":["color","width"]},{"type":"null"}]},"shadow":{"anyOf":[{"type":"object","properties":{"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"distance":{"type":"number","minimum":0,"maximum":0.5},"blur":{"type":"number","minimum":0,"maximum":0.5}},"required":["color","distance"]},{"type":"null"}]},"box":{"anyOf":[{"type":"object","properties":{"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"padding":{"type":"number","minimum":0,"maximum":1}},"required":["color","padding"]},{"type":"null"}]},"highlight":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","enum":["none","fill","word","karaoke","pop"],"description":"Needs caption word timings. karaoke: each word takes color as it is spoken and keeps it; fill: likewise, sweeping across each word; word: only the word being spoken; pop: that word, growing a little"},"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"}},"required":["mode","color"]},{"type":"null"}]},"reveal":{"type":"string","enum":["none","typewriter","word_fade","word_pop"]},"reveal_frames":{"type":"integer","minimum":1,"maximum":10000},"max_lines":{"description":"At most this many lines at once: longer text shows in turn, a screenful at a time, each from its first word (by word timing, or by length without it). Lines are broken here, by the font, balanced in length; null shows it all at once","anyOf":[{"type":"integer","minimum":1,"maximum":20},{"type":"null"}]}}},"caption_add_args":{"type":"object","properties":{"track_id":{"type":"string","description":"A video track for the captions, usually the top one"},"segments":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"start_frame":{"type":"integer","minimum":0},"end_frame":{"type":"integer","minimum":0},"text":{"type":"string","minLength":1,"maxLength":2000},"words":{"description":"Word timings for highlights, timeline frames","maxItems":500,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200},"start_frame":{"type":"integer","minimum":0},"end_frame":{"type":"integer","minimum":0}},"required":["text","start_frame","end_frame"]}},"spans":{"maxItems":500,"type":"array","items":{"$ref":"#/components/schemas/caption_add_args_TextSpan"},"description":"Style part of the text: each span restyles words first_word to last_word (from 0: the timed words, or the text split at spaces), e.g. one word in yellow"}},"required":["start_frame","end_frame","text"]}},"in_clip":{"description":"Segments timed in seconds of a clip's media (e.g. transcript word times), placed where those moments play in the clip, through speed changes; what doesn't play is left out","type":"object","properties":{"clip_id":{"type":"string"},"segments":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"start":{"type":"number","minimum":0},"end":{"type":"number","minimum":0},"text":{"type":"string","minLength":1,"maxLength":2000},"words":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200},"start":{"type":"number","minimum":0},"end":{"type":"number","minimum":0}},"required":["text","start","end"]}},"spans":{"maxItems":500,"type":"array","items":{"$ref":"#/components/schemas/caption_add_args_TextSpan"},"description":"Style part of the text: each span restyles words first_word to last_word (from 0: the timed words, or the text split at spaces), e.g. one word in yellow"}},"required":["start","end","text"]}}},"required":["clip_id","segments"]},"srt":{"description":"SubRip text instead of segments","type":"string","maxLength":2000000},"vtt":{"description":"WebVTT text instead of segments","type":"string","maxLength":2000000},"offset_frames":{"default":0,"description":"Shifts srt/vtt times","type":"integer","minimum":-1000000,"maximum":1000000},"style":{"$ref":"#/components/schemas/caption_add_args_TextStyle"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["track_id","timeline_id"]},"text_set_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"text_set_args_TextStyle":{"type":"object","properties":{"font":{"description":"Installed: Inter, Montserrat, Open Sans, Lato, Bebas Neue, Lobster Two, Comic Neue, Fira Code, DejaVu Sans, Serif and Mono, Noto for most scripts (video://catalog/fonts lists all); another font: font_media_id","type":"string","minLength":1,"maxLength":100},"font_media_id":{"description":"An imported font","type":"string","pattern":"^m_[0-9a-z]{26}$"},"size":{"description":"Of frame height","type":"number","minimum":0.005,"maximum":1},"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"underline":{"type":"boolean"},"align":{"type":"string","enum":["left","center","right"]},"x":{"description":"Of frame width, 0 = left: where the text sits, by its align side","type":"number","minimum":-1,"maximum":2},"y":{"description":"Of frame height, 0 = top: where the anchor edge of the text sits","type":"number","minimum":-1,"maximum":2},"anchor":{"description":"Which edge of the text sits on y (titles default middle, captions bottom)","type":"string","enum":["top","middle","bottom"]},"max_width":{"description":"Of frame width: longer text wraps onto more lines, balanced in length","type":"number","minimum":0.05,"maximum":1},"letter_spacing":{"type":"number","minimum":-0.5,"maximum":2},"outline":{"anyOf":[{"type":"object","properties":{"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"width":{"type":"number","minimum":0,"maximum":0.5}},"required":["color","width"]},{"type":"null"}]},"shadow":{"anyOf":[{"type":"object","properties":{"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"distance":{"type":"number","minimum":0,"maximum":0.5},"blur":{"type":"number","minimum":0,"maximum":0.5}},"required":["color","distance"]},{"type":"null"}]},"box":{"anyOf":[{"type":"object","properties":{"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"padding":{"type":"number","minimum":0,"maximum":1}},"required":["color","padding"]},{"type":"null"}]},"highlight":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","enum":["none","fill","word","karaoke","pop"],"description":"Needs caption word timings. karaoke: each word takes color as it is spoken and keeps it; fill: likewise, sweeping across each word; word: only the word being spoken; pop: that word, growing a little"},"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"}},"required":["mode","color"]},{"type":"null"}]},"reveal":{"type":"string","enum":["none","typewriter","word_fade","word_pop"]},"reveal_frames":{"type":"integer","minimum":1,"maximum":10000},"max_lines":{"description":"At most this many lines at once: longer text shows in turn, a screenful at a time, each from its first word (by word timing, or by length without it). Lines are broken here, by the font, balanced in length; null shows it all at once","anyOf":[{"type":"integer","minimum":1,"maximum":20},{"type":"null"}]}}},"text_set_args_TextSpan":{"type":"object","properties":{"first_word":{"type":"integer","minimum":0,"maximum":10000},"last_word":{"type":"integer","minimum":0,"maximum":10000},"color":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"underline":{"type":"boolean"},"size":{"description":"Of frame height","type":"number","minimum":0.005,"maximum":1}},"required":["first_word","last_word"]},"text_set_args":{"type":"object","properties":{"clip_ids":{"description":"Titles or captions","minItems":1,"maxItems":5000,"type":"array","items":{"type":"string"}},"track_id":{"description":"Instead of clip_ids: every title and caption on a track","type":"string"},"text":{"description":"Only with a single clip","type":"string","minLength":1,"maxLength":2000},"style":{"description":"Merged into each clip's style; null fields reset","$ref":"#/components/schemas/text_set_args_TextStyle"},"spans":{"description":"Only with a single clip: replaces its spans (null removes them). New text drops spans it doesn't give","anyOf":[{"maxItems":500,"type":"array","items":{"$ref":"#/components/schemas/text_set_args_TextSpan"},"description":"Style part of the text: each span restyles words first_word to last_word (from 0: the timed words, or the text split at spaces), e.g. one word in yellow"},{"type":"null"}]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["timeline_id"]},"audio_set_gain_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"audio_set_gain_args_Animatable":{"anyOf":[{"type":"number"},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":-1000000,"maximum":100000000},"value":{"type":"number"},"ease":{"type":"string","enum":["linear","hold","smooth","sine_in","sine_out","sine_in_out","quad_in","quad_out","quad_in_out","cubic_in","cubic_out","cubic_in_out","quart_in","quart_out","quart_in_out","quint_in","quint_out","quint_in_out","expo_in","expo_out","expo_in_out","circ_in","circ_out","circ_in_out","back_in","back_out","back_in_out","elastic_in","elastic_out","elastic_in_out","bounce_in","bounce_out","bounce_in_out"]}},"required":["frame","value"]},"description":"frame is from the clip start; ease shapes the move from this keyframe to the next (default linear; hold waits, then jumps)"}},"required":["keyframes"]},{"type":"null"}]},"audio_set_gain_args":{"type":"object","properties":{"clip_id":{"type":"string","description":"An audio clip, or a video clip whose linked audio to change"},"gain_db":{"description":"dB, -60 to 24; 0 leaves it as it is. Keyframes make a ride: the first key holds backward to the clip start, so a ride that begins part-way down must also key its starting level at frame 0 or the frames before it are changed too. A key past the clip end is stored as given, with no clamp and no warning. Two keys on one frame are refused","$ref":"#/components/schemas/audio_set_gain_args_Animatable"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","gain_db","timeline_id"]},"audio_set_pan_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"audio_set_pan_args":{"type":"object","properties":{"clip_id":{"type":"string"},"pan":{"description":"-1 left, 0 centre, 1 right; null resets","anyOf":[{"type":"number","minimum":-1,"maximum":1},{"type":"null"}]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","pan","timeline_id"]},"audio_fade_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"audio_fade_args":{"type":"object","properties":{"clip_id":{"type":"string"},"in_frames":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":1000000},{"type":"null"}]},"out_frames":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":1000000},{"type":"null"}]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","timeline_id"]},"audio_set_master_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"audio_set_master_args":{"type":"object","properties":{"gain_db":{"anyOf":[{"type":"number","minimum":-60,"maximum":40},{"type":"null"}]},"limit_db":{"description":"Limiter ceiling on sample peaks, dBFS","anyOf":[{"type":"number","minimum":-20,"maximum":0},{"type":"null"}]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["timeline_id"]},"filter_add_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"filter_add_args":{"type":"object","properties":{"clip_id":{"description":"Apply to one clip (or an adjustment clip)","type":"string"},"track_id":{"description":"Or to every clip on a track","type":"string"},"timeline":{"description":"Or true for the whole picture or mix","type":"boolean"},"name":{"type":"string","enum":["brightness_contrast","saturation","exposure","temperature","hue","vibrance","curves","lut","grayscale","sepia","invert","blur","sharpen","vignette","grain","chromatic_aberration","pixelate","glitch","denoise","chroma_key","equalizer","compressor","noise_reduction","voice_denoise","de_esser","dialogue_enhance","reverb","echo","pitch","highpass","lowpass","telephone","dereverb","lens_correction","directional_blur","channels"],"description":"Each effect's params: brightness_contrast(brightness, contrast) saturation(amount) exposure(stops) temperature(kelvin) hue(degrees) vibrance(amount) curves(preset) lut(media_id) grayscale() sepia() invert() blur(radius) sharpen(amount) vignette(amount) grain(amount) chromatic_aberration(offset) pixelate(size) glitch(amount) denoise(strength) chroma_key(color, tolerance) equalizer(low_db, mid_db, high_db) compressor(threshold_db, ratio, makeup_db, attack_ms, release_ms) noise_reduction(amount_db) voice_denoise(keep, mix) de_esser(amount) dialogue_enhance(amount) reverb(amount) echo(delay_ms, decay) pitch(semitones) highpass(frequency) lowpass(frequency) telephone() dereverb(reach_ms, mix) lens_correction(k1, k2, center_x, center_y) directional_blur(angle, radius) channels(left, right)"},"params":{"default":{},"description":"The effect's own params; any left out take their defaults. A wrong one is refused with the effect's params, ranges, units and defaults","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["name","timeline_id"]},"filter_set_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"filter_set_args":{"type":"object","properties":{"filter_id":{"type":"string"},"params":{"description":"Merged into its params","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["filter_id","timeline_id"]},"filter_remove_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"filter_remove_args":{"type":"object","properties":{"filter_id":{"type":"string"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["filter_id","timeline_id"]},"adjustment_add_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"adjustment_add_args":{"type":"object","properties":{"track_id":{"type":"string","description":"A video track; the effects reach every track below it"},"at_frame":{"description":"Default: after the last clip on the track","type":"integer","minimum":0},"duration_frames":{"type":"integer","exclusiveMinimum":0,"maximum":10000000},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["track_id","duration_frames","timeline_id"]},"transition_add_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"transition_add_args":{"type":"object","properties":{"clip_id":{"type":"string","description":"The clip before the cut; the clip after it must touch it"},"kind":{"type":"string","enum":["dissolve","dip_to_black","dip_to_white","wipe_left","wipe_right","wipe_up","wipe_down","slide_left","slide_right","slide_up","slide_down","push_left","push_right","push_up","push_down","zoom_in","zoom_out","iris","spin","crossfade"],"description":"video://catalog/transitions; crossfade on audio tracks"},"duration_frames":{"type":"integer","minimum":2,"maximum":10000},"mode":{"default":"overlap","description":"overlap: the clips overlap by the duration and later clips move earlier; handles: use source past the cut, nothing moves","type":"string","enum":["overlap","handles"]},"other_tracks":{"default":"stay","description":"overlap only: what the other tracks do. stay: they don't move, so what sits after the cut there plays later against the picture (the result warns which clips); extract: the same span comes out of them too, like range.extract, so everything stays in sync","type":"string","enum":["stay","extract"]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","kind","duration_frames","timeline_id"]},"transition_set_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"transition_set_args":{"type":"object","properties":{"transition_id":{"type":"string"},"kind":{"type":"string","enum":["dissolve","dip_to_black","dip_to_white","wipe_left","wipe_right","wipe_up","wipe_down","slide_left","slide_right","slide_up","slide_down","push_left","push_right","push_up","push_down","zoom_in","zoom_out","iris","spin","crossfade"]},"duration_frames":{"type":"integer","minimum":2,"maximum":10000},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["transition_id","timeline_id"]},"transition_remove_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"transition_remove_args":{"type":"object","properties":{"transition_id":{"type":"string"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["transition_id","timeline_id"]},"clip_set_transform_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"placements":{"description":"Where each clip the edit moved, cropped, masked or animated shows, sequence pixels; for a title or caption, the area it can draw in, not the text itself","type":"array","items":{"type":"object","properties":{"clip_id":{"type":"string"},"frames":{"type":"array","items":{"type":"object","properties":{"frame":{"type":"number","description":"From the clip start"},"picture":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"description":"The whole picture, before crop and mask and rotation; for a corner pin, the box around its corners"},"corners":{"description":"Corner pin: where the picture corners land, top left, top right, bottom right, bottom left","minItems":4,"maxItems":4,"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]}},"rotation":{"type":"number"},"opacity":{"type":"number"},"visible":{"description":"What it shows: crop and mask applied, rotated, inside the frame; null: nothing","anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},{"type":"null"}]},"source":{"description":"The part of the source that shows, source pixels","anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},{"type":"null"}]}},"required":["frame","picture","rotation","opacity","visible","source"]}},"complete":{"type":"boolean","description":"true: values move in straight lines between entries; false: evenly sampled"}},"required":["clip_id","frames","complete"]}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_set_transform_args_Animatable":{"anyOf":[{"type":"number"},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":-1000000,"maximum":100000000},"value":{"type":"number"},"ease":{"type":"string","enum":["linear","hold","smooth","sine_in","sine_out","sine_in_out","quad_in","quad_out","quad_in_out","cubic_in","cubic_out","cubic_in_out","quart_in","quart_out","quart_in_out","quint_in","quint_out","quint_in_out","expo_in","expo_out","expo_in_out","circ_in","circ_out","circ_in_out","back_in","back_out","back_in_out","elastic_in","elastic_out","elastic_in_out","bounce_in","bounce_out","bounce_in_out"]}},"required":["frame","value"]},"description":"frame is from the clip start; ease shapes the move from this keyframe to the next (default linear; hold waits, then jumps)"}},"required":["keyframes"]},{"type":"null"}]},"clip_set_transform_args_CornerPoints":{"minItems":4,"maxItems":4,"type":"array","items":{"type":"array","prefixItems":[{"type":"number","minimum":-1,"maximum":2},{"type":"number","minimum":-1,"maximum":2}],"items":false,"minItems":2,"maxItems":2}},"clip_set_transform_args":{"type":"object","properties":{"x":{"description":"Centre x, 0 = left edge, 1 = right edge (default 0.5); -4 to 5","$ref":"#/components/schemas/clip_set_transform_args_Animatable"},"y":{"description":"Centre y, 0 = top, 1 = bottom (default 0.5); -4 to 5","$ref":"#/components/schemas/clip_set_transform_args_Animatable"},"scale":{"description":"Size relative to the fit (default 1); 0 to 20","$ref":"#/components/schemas/clip_set_transform_args_Animatable"},"scale_x":{"description":"Extra horizontal stretch (default 1); 0 to 20","$ref":"#/components/schemas/clip_set_transform_args_Animatable"},"scale_y":{"description":"Extra vertical stretch (default 1); 0 to 20","$ref":"#/components/schemas/clip_set_transform_args_Animatable"},"rotation":{"description":"Degrees clockwise (default 0); -36000 to 36000","$ref":"#/components/schemas/clip_set_transform_args_Animatable"},"opacity":{"description":"Opacity (default 1); 0 to 1","$ref":"#/components/schemas/clip_set_transform_args_Animatable"},"fit":{"anyOf":[{"type":"string","enum":["contain","cover","fill","none"],"description":"contain: whole picture inside the frame, scaled up or down to touch its edges (default); cover: fill the frame, cropping what overflows equally on both sides (move x or y off 0.5 to show another part); fill: stretch; none: its own pixels at sequence size, unscaled (a 300 px logo stays 300 px on a 1920 px sequence), for logos and graphics made to size"},{"type":"null"}]},"flip":{"anyOf":[{"type":"string","enum":["none","horizontal","vertical","both"]},{"type":"null"}]},"crop":{"anyOf":[{"type":"object","properties":{"left":{"default":0,"type":"number","minimum":0,"maximum":0.99},"right":{"default":0,"type":"number","minimum":0,"maximum":0.99},"top":{"default":0,"type":"number","minimum":0,"maximum":0.99},"bottom":{"default":0,"type":"number","minimum":0,"maximum":0.99}},"description":"Hidden from each edge, in fractions of the clip's fitted frame (the sequence-shaped box with the picture fitted inside, bars included, as for masks); the rest stays where it was"},{"type":"null"}]},"corners":{"description":"Corner pin: where the picture's four corners land, as [x, y] in fractions of the frame (-1 to 2), in the order top left, top right, bottom right, bottom left; or {keyframes: [{frame, corners, ease}]}. Replaces x, y, scale, scale_x, scale_y, rotation and fit; null removes it","anyOf":[{"anyOf":[{"$ref":"#/components/schemas/clip_set_transform_args_CornerPoints"},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":-1000000,"maximum":100000000},"corners":{"$ref":"#/components/schemas/clip_set_transform_args_CornerPoints"},"ease":{"type":"string"}},"required":["frame","corners"]}}},"required":["keyframes"]}]},{"type":"null"}]},"clip_id":{"type":"string"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","timeline_id"]},"clip_set_blend_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_set_blend_args":{"type":"object","properties":{"clip_id":{"type":"string"},"mode":{"type":"string","enum":["normal","add","multiply","screen","overlay","darken","lighten","color_dodge","color_burn","hard_light","soft_light","difference","exclusion"]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","mode","timeline_id"]},"clip_set_mask_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"placements":{"description":"Where each clip the edit moved, cropped, masked or animated shows, sequence pixels; for a title or caption, the area it can draw in, not the text itself","type":"array","items":{"type":"object","properties":{"clip_id":{"type":"string"},"frames":{"type":"array","items":{"type":"object","properties":{"frame":{"type":"number","description":"From the clip start"},"picture":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"description":"The whole picture, before crop and mask and rotation; for a corner pin, the box around its corners"},"corners":{"description":"Corner pin: where the picture corners land, top left, top right, bottom right, bottom left","minItems":4,"maxItems":4,"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]}},"rotation":{"type":"number"},"opacity":{"type":"number"},"visible":{"description":"What it shows: crop and mask applied, rotated, inside the frame; null: nothing","anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},{"type":"null"}]},"source":{"description":"The part of the source that shows, source pixels","anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},{"type":"null"}]}},"required":["frame","picture","rotation","opacity","visible","source"]}},"complete":{"type":"boolean","description":"true: values move in straight lines between entries; false: evenly sampled"}},"required":["clip_id","frames","complete"]}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_set_mask_args_Animatable":{"anyOf":[{"type":"number"},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":-1000000,"maximum":100000000},"value":{"type":"number"},"ease":{"type":"string","enum":["linear","hold","smooth","sine_in","sine_out","sine_in_out","quad_in","quad_out","quad_in_out","cubic_in","cubic_out","cubic_in_out","quart_in","quart_out","quart_in_out","quint_in","quint_out","quint_in_out","expo_in","expo_out","expo_in_out","circ_in","circ_out","circ_in_out","back_in","back_out","back_in_out","elastic_in","elastic_out","elastic_in_out","bounce_in","bounce_out","bounce_in_out"]}},"required":["frame","value"]},"description":"frame is from the clip start; ease shapes the move from this keyframe to the next (default linear; hold waits, then jumps)"}},"required":["keyframes"]},{"type":"null"}]},"clip_set_mask_args_MaskPoints":{"minItems":3,"maxItems":64,"type":"array","items":{"type":"array","prefixItems":[{"type":"number","minimum":-4,"maximum":5},{"type":"number","minimum":-4,"maximum":5}],"items":false,"minItems":2,"maxItems":2}},"clip_set_mask_args_MaskShape":{"type":"object","properties":{"shape":{"type":"string","enum":["rectangle","ellipse","linear","mirror","heart","star","polygon","matte"]},"x":{"description":"Mask centre x in the fitted frame, 0–1 (default 0.5); -4 to 5","$ref":"#/components/schemas/clip_set_mask_args_Animatable"},"y":{"description":"Mask centre y in the fitted frame, 0–1 (default 0.5); -4 to 5","$ref":"#/components/schemas/clip_set_mask_args_Animatable"},"width":{"description":"Fraction of the fitted frame width (default 0.5); 0 to 10","$ref":"#/components/schemas/clip_set_mask_args_Animatable"},"height":{"description":"Fraction of the fitted frame height (default 0.5); band thickness for mirror; 0 to 10","$ref":"#/components/schemas/clip_set_mask_args_Animatable"},"rotation":{"description":"Degrees clockwise; for linear, the edge angle; -36000 to 36000","$ref":"#/components/schemas/clip_set_mask_args_Animatable"},"corner_radius":{"description":"rectangle: corner radius as a fraction of its short side","type":"number","minimum":0,"maximum":0.5},"points":{"description":"polygon: [x, y] corners in the fitted frame, 0–1, or {keyframes: [{frame, points, ease}]}","anyOf":[{"$ref":"#/components/schemas/clip_set_mask_args_MaskPoints"},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":-1000000,"maximum":100000000},"points":{"$ref":"#/components/schemas/clip_set_mask_args_MaskPoints"},"ease":{"type":"string"}},"required":["frame","points"]}}},"required":["keyframes"]}]},"media_id":{"description":"matte: media whose alpha (or brightness) selects","type":"string","pattern":"^m_[0-9a-z]{26}$"}},"required":["shape"]},"clip_set_mask_args":{"type":"object","properties":{"clip_id":{"type":"string"},"mask":{"description":"null removes the mask","anyOf":[{"type":"object","properties":{"shape":{"type":"string","enum":["rectangle","ellipse","linear","mirror","heart","star","polygon","matte"]},"x":{"description":"Mask centre x in the fitted frame, 0–1 (default 0.5); -4 to 5","$ref":"#/components/schemas/clip_set_mask_args_Animatable"},"y":{"description":"Mask centre y in the fitted frame, 0–1 (default 0.5); -4 to 5","$ref":"#/components/schemas/clip_set_mask_args_Animatable"},"width":{"description":"Fraction of the fitted frame width (default 0.5); 0 to 10","$ref":"#/components/schemas/clip_set_mask_args_Animatable"},"height":{"description":"Fraction of the fitted frame height (default 0.5); band thickness for mirror; 0 to 10","$ref":"#/components/schemas/clip_set_mask_args_Animatable"},"rotation":{"description":"Degrees clockwise; for linear, the edge angle; -36000 to 36000","$ref":"#/components/schemas/clip_set_mask_args_Animatable"},"corner_radius":{"description":"rectangle: corner radius as a fraction of its short side","type":"number","minimum":0,"maximum":0.5},"points":{"description":"polygon: [x, y] corners in the fitted frame, 0–1, or {keyframes: [{frame, points, ease}]}","anyOf":[{"$ref":"#/components/schemas/clip_set_mask_args_MaskPoints"},{"type":"object","properties":{"keyframes":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":-1000000,"maximum":100000000},"points":{"$ref":"#/components/schemas/clip_set_mask_args_MaskPoints"},"ease":{"type":"string"}},"required":["frame","points"]}}},"required":["keyframes"]}]},"media_id":{"description":"matte: media whose alpha (or brightness) selects","type":"string","pattern":"^m_[0-9a-z]{26}$"},"feather":{"description":"Soft edge as a fraction of the picture short side","type":"number","minimum":0,"maximum":0.5},"invert":{"description":"Select the outside instead","type":"boolean"},"mode":{"description":"show (default) only the selection, hide it, or fill it (painted in from around it and from earlier frames)","type":"string","enum":["show","hide","fill"]},"add":{"description":"More shapes in the same selection, e.g. two panels; feather, invert and mode apply to all","minItems":1,"maxItems":8,"type":"array","items":{"$ref":"#/components/schemas/clip_set_mask_args_MaskShape"}}},"required":["shape"]},{"type":"null"}]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","mask","timeline_id"]},"clip_set_animation_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"clip_id":{"description":"The clip this edit made or acted on (each tool says which)","type":"string"},"clip_ids":{"description":"Every clip this edit made or acted on, linked ones included (each tool says which)","type":"array","items":{"type":"string"}},"track_id":{"type":"string"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"placements":{"description":"Where each clip the edit moved, cropped, masked or animated shows, sequence pixels; for a title or caption, the area it can draw in, not the text itself","type":"array","items":{"type":"object","properties":{"clip_id":{"type":"string"},"frames":{"type":"array","items":{"type":"object","properties":{"frame":{"type":"number","description":"From the clip start"},"picture":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"description":"The whole picture, before crop and mask and rotation; for a corner pin, the box around its corners"},"corners":{"description":"Corner pin: where the picture corners land, top left, top right, bottom right, bottom left","minItems":4,"maxItems":4,"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]}},"rotation":{"type":"number"},"opacity":{"type":"number"},"visible":{"description":"What it shows: crop and mask applied, rotated, inside the frame; null: nothing","anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},{"type":"null"}]},"source":{"description":"The part of the source that shows, source pixels","anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},{"type":"null"}]}},"required":["frame","picture","rotation","opacity","visible","source"]}},"complete":{"type":"boolean","description":"true: values move in straight lines between entries; false: evenly sampled"}},"required":["clip_id","frames","complete"]}}},"required":["timeline_id","parent","changed","preview","warnings"]},"clip_set_animation_args":{"type":"object","properties":{"clip_id":{"type":"string"},"in":{"description":"Entrance, from the clip start","anyOf":[{"type":"object","properties":{"name":{"type":"string","enum":["fade","zoom_in","zoom_out","slide_left","slide_right","slide_up","slide_down","pop","spin","drop"]},"duration_frames":{"type":"integer","exclusiveMinimum":0,"maximum":100000}},"required":["name","duration_frames"]},{"type":"null"}]},"out":{"description":"Exit, ending at the clip end","anyOf":[{"type":"object","properties":{"name":{"type":"string","enum":["fade","zoom_in","zoom_out","slide_left","slide_right","slide_up","slide_down","pop","spin","drop"]},"duration_frames":{"type":"integer","exclusiveMinimum":0,"maximum":100000}},"required":["name","duration_frames"]},{"type":"null"}]},"loop":{"description":"Repeats over the clip, or over from_frame to to_frame of it","anyOf":[{"type":"object","properties":{"name":{"type":"string","enum":["pulse","sway","shake","float","spin","flicker"]},"period_frames":{"type":"integer","exclusiveMinimum":0,"maximum":100000},"strength":{"default":1,"type":"number","minimum":0,"maximum":5},"from_frame":{"description":"Frame from the clip start where it begins, its first repeat starting there; like keyframes it stays on that moment of the source through trims and splits. Default the clip start","type":"integer","minimum":-10000000,"maximum":10000000},"to_frame":{"description":"Frame from the clip start it stops before, back at rest. Default the clip end","type":"integer","minimum":-10000000,"maximum":10000000}},"required":["name"]},{"type":"null"}]},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]}},"required":["clip_id","timeline_id"]},"edit_batch_result":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The new version: edit this one next (older ids stay valid)"},"parent":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"The version this edit started from"},"changed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["clip","track","transition","effects","master","sequence","name"]},"change":{"type":"string","enum":["added","removed","modified"]},"track_id":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"kind":{"type":"string"}},"required":["id","type","change"]},"description":"What the edit added, removed or modified; a clip or transition says its track and where it now sits (frames, end exclusive)"},"preview":{"anyOf":[{"type":"object","properties":{"uri":{"type":"string"},"frames":{"type":"array","items":{"type":"integer","minimum":0},"description":"Frames shown; for a waveform, the start and end of its span"},"status":{"type":"string","enum":["ready","pending"]},"loudness":{"description":"Measured for audio edits, over the waveform span","type":"object","properties":{"lufs":{"type":["number","null"]},"true_peak_db":{"type":["number","null"]}},"required":["lufs","true_peak_db"]}},"required":["uri","frames","status"]},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"placements":{"description":"Where each clip the edit moved, cropped, masked or animated shows, sequence pixels; for a title or caption, the area it can draw in, not the text itself","type":"array","items":{"type":"object","properties":{"clip_id":{"type":"string"},"frames":{"type":"array","items":{"type":"object","properties":{"frame":{"type":"number","description":"From the clip start"},"picture":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"description":"The whole picture, before crop and mask and rotation; for a corner pin, the box around its corners"},"corners":{"description":"Corner pin: where the picture corners land, top left, top right, bottom right, bottom left","minItems":4,"maxItems":4,"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"]}},"rotation":{"type":"number"},"opacity":{"type":"number"},"visible":{"description":"What it shows: crop and mask applied, rotated, inside the frame; null: nothing","anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},{"type":"null"}]},"source":{"description":"The part of the source that shows, source pixels","anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},{"type":"null"}]}},"required":["frame","picture","rotation","opacity","visible","source"]}},"complete":{"type":"boolean","description":"true: values move in straight lines between entries; false: evenly sampled"}},"required":["clip_id","frames","complete"]}},"results":{"type":"array","items":{"type":"object","properties":{"tool":{"type":"string"},"clip_id":{"type":"string"},"clip_ids":{"type":"array","items":{"type":"string"}},"track_id":{"type":"string"}},"required":["tool"]}}},"required":["timeline_id","parent","changed","preview","warnings","results"]},"edit_batch_args":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preview":{"default":"link","description":"inline: image in the result; link: URI that renders on read; none","type":"string","enum":["inline","link","none"]},"ops":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"tool":{"type":"string","enum":["timeline.set_sequence","track.add","track.remove","track.set","clip.add","clip.remove","clip.move","clip.trim","clip.split","clip.link","clip.unlink","clip.set_enabled","clip.set_speed","clip.freeze","clip.roll","clip.slip","clip.slide","clip.replace","range.lift","range.extract","title.add","caption.add","text.set","audio.set_gain","audio.set_pan","audio.fade","audio.set_master","filter.add","filter.set","filter.remove","adjustment.add","transition.add","transition.set","transition.remove","clip.set_transform","clip.set_blend","clip.set_mask","clip.set_animation"]},"args":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["tool","args"]},"description":"Edits applied in order as one change. An arg may be {\"$ref\":\"ops[2].clip_id\"} to use an id made by an earlier op; a linked clip.add's clip_id is its clip on track_id, and clip_ids holds the linked ones too"}},"required":["timeline_id","ops"]},"media_import_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]}},"required":["job_id","status","status_uri","hint"]},"media_import_args":{"type":"object","properties":{"source":{"description":"Where the file is. Give this or file","anyOf":[{"type":"object","properties":{"path":{"type":"string","minLength":1,"description":"A file under a media root, e.g. /media/videos/clip.mp4 (local mode)"}},"required":["path"]},{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"An http(s) URL that downloads the file itself; a page about it (a YouTube or other video page, a private share) is refused"}},"required":["url"]},{"type":"object","properties":{"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"A file sent to the URL media.upload gave, once fully sent"}},"required":["upload_id"]},{"type":"object","properties":{"data":{"type":"string","minLength":6,"maxLength":11185011,"description":"A small file written out as a data: URI (data:image/png;base64,…), up to 8 MB: a logo, a still, a short sound. Bigger files go through media.upload"},"sha256":{"description":"The file's SHA-256 in hex; the import is refused if the data decodes to anything else","type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["data"]},{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"A completed export.video: its rendered file becomes media, e.g. to re-edit a finished cut or place it in a sequence of another shape"}},"required":["job_id"]},{"type":"object","properties":{"still":{"type":"object","properties":{"media_id":{"description":"A video, frame numbered at its own rate","type":"string","pattern":"^m_[0-9a-z]{26}$"},"timeline_id":{"description":"An edit, timeline frame, as it renders","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"frame":{"type":"integer","minimum":0}},"required":["frame"],"description":"One frame of a video or of an edit as a still image (PNG at full size: the media size, or the sequence size; see-through parts of the media stay so): to place, cut out or reuse"}},"required":["still"]}]},"file":{"description":"A file the user attached in the chat, as the client passes it (instead of source)","type":"object","properties":{"download_url":{"type":"string","format":"uri","description":"Where the server downloads the file from"},"file_id":{"type":"string","minLength":1},"mime_type":{"type":"string"},"file_name":{"type":"string"}},"required":["download_url","file_id"]},"name":{"description":"The media's desired name on the cutting floor. Default: the file's own name","type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}}},"media_upload_result":{"type":"object","properties":{"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"url":{"type":"string","description":"The staging url; no other credentials needed"},"expires_at":{"type":"string"},"expiry":{"type":"string","description":"expires_at in words: the link and a file sent through it go then unless imported"},"max_bytes":{"type":"number"},"how":{"type":"string"}},"required":["upload_id","url","expires_at","expiry","max_bytes","how"]},"media_upload_args":{"type":"object","properties":{"name":{"description":"The file's name, if known. A label only: the file the user picks on the page brings its own name, and import reads the content, not the extension","type":"string","minLength":1,"maxLength":200,"pattern":"^[^/\\\\]+$"},"bytes":{"description":"The file size, to be refused now rather than part way if it is too big","type":"integer","exclusiveMinimum":0}}},"media_list_result":{"type":"object","properties":{"next_offset":{"description":"offset for the next page of media; null on the last","anyOf":[{"type":"integer"},{"type":"null"}]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"status":{"type":"string","enum":["importing","processing","ready","failed"]},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"duration_seconds":{"type":["number","null"]},"from":{"type":"string","enum":["upload","url","path","render","created"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"bytes":{"description":"Size of the original file","type":["number","null"]},"created_at":{"type":"string"},"expires_at":{"type":"string","description":"When the server deletes it: 7 days after last use; any use pushes it back"},"expiry":{"type":"string","description":"expires_at in words: how long is left and what keeps it longer"}},"required":["media_id","name","status","kind","duration_seconds","from","origin","bytes","created_at","expires_at","expiry"]},"description":"Imported and created media, most recently used first (up to 200)"},"media_count":{"type":"integer","description":"All media held (that match name), including any not listed"},"uploads":{"type":"array","items":{"type":"object","properties":{"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"name":{"type":"string"},"received_bytes":{"type":"number"},"bytes":{"description":"The size given when the upload began, if any","type":["number","null"]},"complete":{"type":"boolean","description":"All sent: media.import {source: {upload_id}} takes it"},"created_at":{"type":"string"},"expires_at":{"type":"string"},"expiry":{"type":"string","description":"expires_at in words: how long is left to import it"}},"required":["upload_id","name","received_bytes","bytes","complete","created_at","expires_at","expiry"]},"description":"Files sent to the server and not imported yet, newest first (up to 200): through media.upload, or dropped on the cuttingfloor site by the user"},"upload_count":{"type":"integer","description":"All uploads waiting (that match name), including any not listed"},"storage":{"type":"object","properties":{"used_bytes":{"type":"number","description":"Everything held: uploads, media with its proxies, exports"},"max_bytes":{"description":"This account's storage, in bytes; null for no limit","type":["number","null"]}},"required":["used_bytes","max_bytes"]}},"required":["next_offset","media","media_count","uploads","upload_count","storage"]},"media_list_args":{"type":"object","properties":{"name":{"description":"Part of a name, any case: only media and uploads whose name holds it","type":"string","minLength":1,"maxLength":200},"limit":{"default":20,"description":"Most media in one answer, most recently used first","type":"integer","minimum":1,"maximum":200},"offset":{"default":0,"description":"Where a page of media starts: the next_offset of the page before","type":"integer","minimum":0}}},"media_delete_result":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"deleted":{"type":"boolean","const":true},"freed_bytes":{"type":"number","description":"What it held here: the file, its proxy and mezzanine, and its analyses"},"storage":{"type":"object","properties":{"used_bytes":{"type":"number"},"max_bytes":{"description":"This account's storage, in bytes; null for no limit","type":["number","null"]}},"required":["used_bytes","max_bytes"]}},"required":["media_id","deleted","freed_bytes","storage"]},"media_delete_args":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}},"required":["media_id"]},"media_analyze_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"kind":{"type":"string","enum":["transcript","beats","faces","track","look","silence","scenes","speech","loudness","sounds","speakers","voice","colour","picture"]},"summary":{"description":"The summary media.get gives under analyses; look: where each answer holds","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"model":{"description":"look: the judgment model","type":"string"},"frames":{"description":"look: frames asked about","type":"number"},"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"file":{"description":"file: the written file","type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","description":"Signed download url"},"page_url":{"type":"string","description":"Shows the file in any browser"},"expires_at":{"type":"string","description":"When the url stops working"},"expiry":{"type":"string","description":"When the file goes, in words"}},"required":["name","url","page_url","expires_at","expiry"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"description":"look: this run (id, model, questions, frames with answers)","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"track":{"type":"object","properties":{"rate":{"type":"number"},"points":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"found":{"type":"boolean"}},"required":["time","x","y","w","h","found"]}}},"required":["rate","points"]},"silences":{"description":"silence: media seconds; a stretch after the sound stops (see sound_ends) counts as silent","type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]}},"sound_ends":{"description":"silence: where the sound stream stops, when it stops before the media ends: past it there is no sound at all","type":"number"},"scenes":{"description":"scenes: cut times, media seconds","type":"array","items":{"type":"number"}},"scene_scores":{"description":"scenes: how much the picture changed at each cut, on the threshold scale","type":"array","items":{"type":"number"}},"speech":{"type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"description":"Runs of frames at or above min_probability, seconds"},"frame_seconds":{"type":"number"},"from":{"type":"number"},"probabilities":{"description":"Every frame, when short enough to return; media: also media.get include speech","type":"array","items":{"type":"number"}}},"required":["model","min_probability","spans","frame_seconds","from"]},"loudness":{"type":"object","properties":{"integrated_lufs":{"description":"EBU R128; null below its -70 LUFS gate","type":["number","null"]},"true_peak_dbtp":{"type":["number","null"]},"loudness_range_lu":{"description":"EBU R128 loudness range (LRA)","type":["number","null"]},"rms_dbfs":{"description":"RMS level over the whole stretch","type":["number","null"]},"noise_floor_dbfs":{"description":"Level of the quietest moments (FFmpeg astats noise floor): room tone or hiss","type":["number","null"]},"channels":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]},"description":"Each channel on its own, in stream order (1 is left in stereo)"},"from":{"type":"number","description":"Seconds measured from"},"until":{"description":"Seconds measured until; null: the end","type":["number","null"]}},"required":["integrated_lufs","true_peak_dbtp","loudness_range_lu","rms_dbfs","noise_floor_dbfs","channels","from","until"]},"sounds":{"type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers_asked":{"description":"The count you gave, or null","type":["number","null"]},"cluster_threshold":{"description":"The cut-off you gave, or null","type":["number","null"]},"speakers":{"type":"number","description":"How many speakers were found"},"from":{"description":"The stretch diarised, when not the whole media","type":"number"},"until":{"type":["number","null"]},"turns":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"speaker":{"type":"number","description":"0 is the first voice heard, 1 the next new one, …"},"confidence":{"description":"0–1: how close this turn's voice sits to its speaker's other turns","type":["number","null"]}},"required":["start","end","speaker","confidence"]},"description":"Each stretch of one voice, by start; two voices at once overlap"}},"required":["model","speakers_asked","cluster_threshold","speakers","turns"]},"voice":{"type":"object","properties":{"method":{"type":"string"},"frame_seconds":{"type":"number"},"from":{"type":"number"},"summary":{"type":"object","properties":{"seconds":{"type":"number"},"voiced_seconds":{"type":"number","description":"Time with a clear pitch: voice, not noise or silence"},"pitch_hz":{"description":"Over the voiced time","anyOf":[{"type":"object","properties":{"median":{"type":"number"},"p10":{"type":"number"},"p90":{"type":"number"}},"required":["median","p10","p90"]},{"type":"null"}]},"pitch_range_semitones":{"description":"p10 to p90: how much the voice moves","type":["number","null"]},"level_db":{"type":"object","properties":{"rms":{"type":["number","null"]},"p10":{"type":["number","null"]},"p90":{"type":["number","null"]}},"required":["rms","p10","p90"]},"words":{"description":"Transcript words in the stretch; null: no transcript","type":["number","null"]},"words_per_second":{"type":["number","null"]}},"required":["seconds","voiced_seconds","pitch_hz","pitch_range_semitones","level_db","words","words_per_second"]},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"pitch_hz":{"description":"Median of its voiced 10 ms steps; null: none","type":["number","null"]},"voiced":{"type":"number","description":"Share of it with a clear pitch, 0–1"},"level_db":{"description":"RMS, dBFS; null: digital silence","type":["number","null"]}},"required":["time","pitch_hz","voiced","level_db"]}}},"required":["method","frame_seconds","from","summary","frames"]},"colour":{"type":"object","properties":{"percentiles":{"type":"array","items":{"type":"number"}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"regions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"pixels":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"description":"The region measured, in pixels of the picture"},"r":{"type":"object","properties":{"mean":{"type":"number"},"percentiles":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per percentile asked (\"5\", \"50\", \"95\"): the value"}},"required":["mean","percentiles"]},"g":{"type":"object","properties":{"mean":{"type":"number"},"percentiles":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per percentile asked (\"5\", \"50\", \"95\"): the value"}},"required":["mean","percentiles"]},"b":{"type":"object","properties":{"mean":{"type":"number"},"percentiles":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per percentile asked (\"5\", \"50\", \"95\"): the value"}},"required":["mean","percentiles"]},"luma":{"type":"object","properties":{"mean":{"type":"number"},"percentiles":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per percentile asked (\"5\", \"50\", \"95\"): the value"}},"required":["mean","percentiles"],"description":"Rec. 709 luma of the encoded values: 0.2126 R + 0.7152 G + 0.0722 B"},"white_point":{"type":"object","properties":{"r":{"type":"number"},"g":{"type":"number"},"b":{"type":"number"}},"required":["r","g","b"],"description":"Mean colour of the brightest 1% of its pixels, an estimate of the white point"},"clipped_high":{"type":"number","description":"Share of pixels with a channel at 255"},"clipped_low":{"type":"number","description":"Share of pixels black in every channel"}},"required":["pixels","r","g","b","luma","white_point","clipped_high","clipped_low"]},"description":"frame: the whole picture; and each region you named"}},"required":["time","regions"]}}},"required":["percentiles","frames"]},"picture":{"type":"object","properties":{"method":{"type":"string"},"from":{"type":"number"},"columns":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"One number per frame in each, in order: time, then FFmpeg signalstats in the picture's own bit depth (0–255 for 8-bit): ymin, ylow (10th percentile), yavg, yhigh (90th), ymax, the same for u and v, satmin…satmax, huemed, hueavg, ydif, udif, vdif (mean change from the frame before), and the bits each plane uses (ybitdepth…)"}},"required":["method","from","columns"]},"picture_size":{"description":"faces, track, colour: the picture measured, in pixels (a box times it is pixels)","type":"object","properties":{"width":{"type":"number"},"height":{"type":"number"}},"required":["width","height"]},"note":{"description":"In place of the analysis when it is too long to return: where to read it","type":"string"}},"required":["kind"]}},"required":["job_id","status","status_uri","hint"]},"media_analyze_args":{"type":"object","properties":{"media_id":{"description":"Analyze imported media (media seconds)","type":"string","pattern":"^m_[0-9a-z]{26}$"},"file":{"description":"transcript: also write it as a file on the cutting floor, named for the media and the stretch it covers, with a download url like an export","type":"string","enum":["txt"]},"timeline_id":{"description":"Analyze an edit as it plays (timeline seconds): its mix (speech, loudness, silence, sounds, speakers, voice) or its picture (faces, track, look, scenes, colour, picture)","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"kind":{"type":"string","enum":["transcript","beats","faces","track","look","silence","scenes","speech","loudness","sounds","speakers","voice","colour","picture"],"description":"transcript: words with times (whisper.cpp, then aligned to the sound); beats: tempo, beat times and the onset strength at each; faces: face boxes over time; track: follow a region; look: your own questions answered on sampled frames; silence: stretches quieter than threshold_db for min_seconds; scenes: times the picture changes by more than threshold; speech: where someone is speaking (Silero VAD probability every 32 ms, spans at or above min_probability); loudness: integrated loudness, true peak, loudness range, RMS and noise floor; sounds: when each of 447 named sounds (laughter, applause, cough, music, speech, door…) can be heard, every 40 ms; speakers: who speaks when; voice: pitch, level and pace over time; colour: colour statistics of frames and regions; picture: every frame's brightness, colour and change from the frame before"},"questions":{"description":"look: id (yours, not shown to the model) to question; up to 32, all asked of every frame","type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]{0,63}$"},"additionalProperties":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"noul"},"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"criteria":{"type":"object","properties":{"true":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"false":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}}}},"required":["type","instructions"]},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"criteria":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},{"type":"null"}]},"description":"option: what it means"}},"required":["type","instructions","criteria"]},{"type":"object","properties":{"type":{"type":"string","const":"score"},"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"criteria":{"minItems":2,"maxItems":10,"type":"array","items":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"description":"levels, lowest first"}},"required":["type","instructions","criteria"]},{"type":"object","properties":{"type":{"type":"string","const":"box"},"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}},"required":["type","instructions"]}]}},"state":{"description":"look: text or JSON entries shown beside `frame` on every frame, by name, for questions to refer to (a script line, a definition)","type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]{0,63}$"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}},"every_seconds":{"description":"look, colour: sample a frame this often. Default 1","type":"number","minimum":0.04,"maximum":3600},"at_seconds":{"description":"look, colour: sample exactly these times instead","minItems":1,"maxItems":600,"type":"array","items":{"type":"number","minimum":0}},"from_seconds":{"description":"Start sampling or measuring here (any kind but beats, and faces and scenes on media). Default 0","type":"number","minimum":0},"with_previous":{"default":false,"description":"look: also show the frame sampled before, as `previous`","type":"boolean"},"min_probability":{"description":"speech (required): a 32 ms frame with at least this speech probability is speech; sounds (required): a 40 ms frame has the sound when its probability is at least this","type":"number","minimum":0,"maximum":1},"labels":{"description":"sounds: the sounds to report, named as in video://catalog/sounds (e.g. [\"Laughter\", \"Applause\", \"Cough\"]). Default: every sound that reaches min_probability somewhere","minItems":1,"maxItems":64,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"model":{"default":"base","description":"transcript: whisper size, on the server CPU. Bigger is more accurate and slower: small takes about 3 times as long as base, tiny about half","type":"string","enum":["tiny","base","small"]},"language":{"default":"auto","description":"transcript: e.g. 'en', or 'auto'","type":"string","minLength":2,"maxLength":8},"region":{"description":"track: the box to follow (top-left x, y and size) and when","type":"object","properties":{"x":{"type":"number","minimum":0},"y":{"type":"number","minimum":0},"w":{"type":"number","exclusiveMinimum":0},"h":{"type":"number","exclusiveMinimum":0},"units":{"default":"fraction","description":"fraction (default): of the picture; pixels: of the picture at its own size","type":"string","enum":["fraction","pixels"]},"at_seconds":{"type":"number","minimum":0}},"required":["x","y","w","h","at_seconds"]},"regions":{"description":"colour: named boxes to measure besides the whole frame (frame), up to 16","type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]{0,63}$"},"additionalProperties":{"type":"object","properties":{"x":{"type":"number","minimum":0},"y":{"type":"number","minimum":0},"w":{"type":"number","exclusiveMinimum":0},"h":{"type":"number","exclusiveMinimum":0},"units":{"default":"fraction","description":"fraction (default): of the picture; pixels: of the picture at its own size","type":"string","enum":["fraction","pixels"]}},"required":["x","y","w","h"]}},"percentiles":{"default":[5,50,95],"description":"colour: the percentiles to give of each channel","minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":0,"maximum":100}},"speakers":{"description":"speakers: how many people speak, when you know (or give cluster_threshold)","type":"integer","minimum":1,"maximum":20},"cluster_threshold":{"description":"speakers: when the count is unknown, how different two voices must be to count as two people; lower finds more speakers (try 0.5 to 0.9)","type":"number","exclusiveMinimum":0,"maximum":10},"until_seconds":{"description":"Stop sampling or measuring here. Default: the end","type":"number","minimum":0},"threshold_db":{"description":"silence (required): quieter than this counts as silence, dBFS","type":"number","minimum":-100,"maximum":0},"min_seconds":{"description":"silence (required): only stretches at least this long","type":"number","minimum":0.01,"maximum":3600},"threshold":{"description":"scenes (required): how much the picture must change to count as a cut, 0–100 (FFmpeg scdet's score): the change from the frame before, in percent of full range, less the change just before it (so steady motion stays low). Hard cuts between ordinary shots score about 10 to 30, a cut between opposite pictures up to 100: start at FFmpeg's own default, 10, and raise it if you get too many","type":"number","minimum":0,"maximum":100},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["kind"]},"media_correlate_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"offset_seconds":{"description":"b's moment t lines up with a's moment t + offset_seconds, each in its own seconds; null when the sounds can't overlap by half within max_offset_seconds","type":["number","null"]},"strength":{"description":"Correlation of the overlapping sound at that offset, -1 to 1: near 1 the same sound, near 0 unrelated","type":["number","null"]},"overlap_seconds":{"description":"How much sound overlaps at that offset","type":["number","null"]},"next_best":{"description":"The best offset outside the winning peak: close to strength means an unclear match","anyOf":[{"type":"object","properties":{"offset_seconds":{"type":"number"},"strength":{"type":"number"}},"required":["offset_seconds","strength"]},{"type":"null"}]},"placement":{"description":"offset_seconds as where to place b on a timeline, in plain words. Trust it only once strength and next_best agree: two unrelated files still come back with a placement","type":["string","null"]}},"required":["offset_seconds","strength","overlap_seconds","next_best"]}},"required":["job_id","status","status_uri","hint"]},"media_correlate_args":{"type":"object","properties":{"a":{"type":"object","properties":{"media_id":{"description":"Imported media (media seconds)","type":"string","pattern":"^m_[0-9a-z]{26}$"},"timeline_id":{"description":"An edit's mix as it plays (timeline seconds)","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"from_seconds":{"description":"Read from here. Default 0","type":"number","minimum":0},"until_seconds":{"description":"Read until here. Default: the end","type":"number","minimum":0}},"description":"The sound to line up against: the reference"},"b":{"type":"object","properties":{"media_id":{"description":"Imported media (media seconds)","type":"string","pattern":"^m_[0-9a-z]{26}$"},"timeline_id":{"description":"An edit's mix as it plays (timeline seconds)","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"from_seconds":{"description":"Read from here. Default 0","type":"number","minimum":0},"until_seconds":{"description":"Read until here. Default: the end","type":"number","minimum":0}},"description":"The sound whose offset you want"},"max_offset_seconds":{"type":"number","minimum":0.01,"maximum":300,"description":"Search offsets up to this far either way"},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["a","b","max_offset_seconds"]},"media_get_result":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers_asked":{"description":"The count you gave, or null","type":["number","null"]},"cluster_threshold":{"description":"The cut-off you gave, or null","type":["number","null"]},"speakers":{"type":"number","description":"How many speakers were found"},"from":{"description":"The stretch diarised, when not the whole media","type":"number"},"until":{"type":["number","null"]},"turns":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"speaker":{"type":"number","description":"0 is the first voice heard, 1 the next new one, …"},"confidence":{"description":"0–1: how close this turn's voice sits to its speaker's other turns","type":["number","null"]}},"required":["start","end","speaker","confidence"]},"description":"Each stretch of one voice, by start; two voices at once overlap"}},"required":["model","speakers_asked","cluster_threshold","speakers","turns"]},"voice":{"type":"object","properties":{"method":{"type":"string"},"frame_seconds":{"type":"number"},"from":{"type":"number"},"summary":{"type":"object","properties":{"seconds":{"type":"number"},"voiced_seconds":{"type":"number","description":"Time with a clear pitch: voice, not noise or silence"},"pitch_hz":{"description":"Over the voiced time","anyOf":[{"type":"object","properties":{"median":{"type":"number"},"p10":{"type":"number"},"p90":{"type":"number"}},"required":["median","p10","p90"]},{"type":"null"}]},"pitch_range_semitones":{"description":"p10 to p90: how much the voice moves","type":["number","null"]},"level_db":{"type":"object","properties":{"rms":{"type":["number","null"]},"p10":{"type":["number","null"]},"p90":{"type":["number","null"]}},"required":["rms","p10","p90"]},"words":{"description":"Transcript words in the stretch; null: no transcript","type":["number","null"]},"words_per_second":{"type":["number","null"]}},"required":["seconds","voiced_seconds","pitch_hz","pitch_range_semitones","level_db","words","words_per_second"]},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"pitch_hz":{"description":"Median of its voiced 10 ms steps; null: none","type":["number","null"]},"voiced":{"type":"number","description":"Share of it with a clear pitch, 0–1"},"level_db":{"description":"RMS, dBFS; null: digital silence","type":["number","null"]}},"required":["time","pitch_hz","voiced","level_db"]}}},"required":["method","frame_seconds","from","summary","frames"]},"colour":{"type":"object","properties":{"percentiles":{"type":"array","items":{"type":"number"}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"regions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"pixels":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"],"description":"The region measured, in pixels of the picture"},"r":{"type":"object","properties":{"mean":{"type":"number"},"percentiles":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per percentile asked (\"5\", \"50\", \"95\"): the value"}},"required":["mean","percentiles"]},"g":{"type":"object","properties":{"mean":{"type":"number"},"percentiles":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per percentile asked (\"5\", \"50\", \"95\"): the value"}},"required":["mean","percentiles"]},"b":{"type":"object","properties":{"mean":{"type":"number"},"percentiles":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per percentile asked (\"5\", \"50\", \"95\"): the value"}},"required":["mean","percentiles"]},"luma":{"type":"object","properties":{"mean":{"type":"number"},"percentiles":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per percentile asked (\"5\", \"50\", \"95\"): the value"}},"required":["mean","percentiles"],"description":"Rec. 709 luma of the encoded values: 0.2126 R + 0.7152 G + 0.0722 B"},"white_point":{"type":"object","properties":{"r":{"type":"number"},"g":{"type":"number"},"b":{"type":"number"}},"required":["r","g","b"],"description":"Mean colour of the brightest 1% of its pixels, an estimate of the white point"},"clipped_high":{"type":"number","description":"Share of pixels with a channel at 255"},"clipped_low":{"type":"number","description":"Share of pixels black in every channel"}},"required":["pixels","r","g","b","luma","white_point","clipped_high","clipped_low"]},"description":"frame: the whole picture; and each region you named"}},"required":["time","regions"]}}},"required":["percentiles","frames"]},"picture":{"type":"object","properties":{"method":{"type":"string"},"from":{"type":"number"},"columns":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"One number per frame in each, in order: time, then FFmpeg signalstats in the picture's own bit depth (0–255 for 8-bit): ymin, ylow (10th percentile), yavg, yhigh (90th), ymax, the same for u and v, satmin…satmax, huemed, hueavg, ydif, udif, vdif (mean change from the frame before), and the bits each plane uses (ybitdepth…)"}},"required":["method","from","columns"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]},"media_get_args":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"include":{"description":"Also return these analyses (otherwise only their summaries): in full, or the piece from_seconds, to_seconds, offset and limit choose. One never run on this media is absent, and warnings says so","type":"array","items":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]}},"from_seconds":{"description":"Only what ends after this media time: transcript words, beats, speaker turns, frames","type":"number","minimum":0},"to_seconds":{"description":"Only what starts before this media time","type":"number","exclusiveMinimum":0},"offset":{"default":0,"description":"Skip this many items of each included list (after the time range)","type":"integer","minimum":0},"limit":{"description":"At most this many items of each included list; pages says where the next starts","type":"integer","minimum":1}},"required":["media_id"]},"media_seek_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"model":{"type":"string","description":"The judgment model that judged the frames"},"frames":{"type":"number","description":"Frames judged"},"asked":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"description":"Per criterion: the noul question the judgment model was asked, as sent"},"matches":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"First matching sample, in seconds"},"end":{"type":"number","description":"Last matching sample of the run, in seconds"},"peak_seconds":{"type":"number","description":"The sample most likely to match"},"peak_probability":{"type":"number"},"frame":{"type":"integer","minimum":0,"description":"peak_seconds as a frame number, for render.frames"},"uri":{"type":"string","description":"MCP resource: the picture at peak_seconds"}},"required":["start","end","peak_seconds","peak_probability","frame","uri"]}},"description":"Per criterion: runs of consecutive samples that match, in time order; empty when none do"},"samples":{"type":"array","items":{"type":"object","properties":{"seconds":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per criterion, 0 to 1"}},"required":["seconds","probabilities"]},"description":"Every judged sample, for your own cut-off or arithmetic"}},"required":["model","frames","asked","matches","samples"]}},"required":["job_id","status","status_uri","hint"]},"media_seek_args":{"type":"object","properties":{"media_id":{"description":"Seek in imported media (media seconds)","type":"string","pattern":"^m_[0-9a-z]{26}$"},"timeline_id":{"description":"Seek in an edit as it renders (timeline seconds): gaps, cuts, titles and effects included","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"criteria":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]{0,63}$"},"additionalProperties":{"anyOf":[{"type":"string","minLength":1},{"type":"object","properties":{"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"criteria":{"type":"object","properties":{"true":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"false":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}}}},"required":["instructions"],"additionalProperties":false}]},"description":"Name (yours, not shown to the model) to what a matching frame shows: a statement or question about the picture, or {instructions, criteria: {true, false}} to say what counts as yes and as no. Up to 32, each judged on every frame"},"state":{"description":"Text or JSON entries shown beside `frame` on every frame, by name, for criteria to refer to (a script line, what a term means)","type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]{0,63}$"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}},"every_seconds":{"description":"Sample a frame this often. Default 1","type":"number","minimum":0.04,"maximum":3600},"at_seconds":{"description":"Sample exactly these times instead","minItems":1,"maxItems":600,"type":"array","items":{"type":"number","minimum":0}},"from_seconds":{"description":"Start sampling here. Default 0","type":"number","minimum":0},"until_seconds":{"description":"Stop here. Default: the end","type":"number","minimum":0},"with_previous":{"default":false,"description":"Also show the frame sampled before, as `previous`, for criteria about change. The first sample is only shown as `previous`","type":"boolean"},"min_probability":{"default":0.5,"description":"A frame matches a criterion when its probability is at least this","type":"number","minimum":0,"maximum":1},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["criteria"]},"media_search_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"searched":{"type":"boolean","description":"false: over 1 credit without cost_override; nothing was judged or charged"},"estimate":{"type":"object","properties":{"media":{"type":"integer","description":"Media that would be judged"},"judgments":{"type":"integer","description":"Keyframes and passages judged: one judgment each"},"credits":{"type":"number","description":"judgments at 200 a credit, plus a few seconds of running time"},"by_kind":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"media":{"type":"integer"},"judgments":{"type":"integer"}},"required":["media","judgments"]},"description":"Per kind: media and judgments"},"largest":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"kind":{"type":"string"},"duration_seconds":{"type":["number","null"]},"judgments":{"type":"integer"}},"required":["media_id","name","kind","duration_seconds","judgments"]},"description":"The media taking the most judgments, most first (up to 10)"}},"required":["media","judgments","credits","by_kind","largest"]},"warning":{"description":"When not searched: the cost, what makes it up, and what the free filters would cut","type":"string"},"model":{"description":"The judgment model that judged","type":"string"},"asked":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"description":"Per criterion: the noul question the judgment model is asked, as sent"},"matches":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"kind":{"type":"string"},"start":{"type":"number","description":"Seconds where the match starts"},"end":{"type":"number","description":"Seconds where it ends: the next keyframe or the passage end"},"peak_seconds":{"type":"number"},"peak_probability":{"type":"number"},"uri":{"description":"looks: MCP resource, the picture at peak_seconds","type":"string"},"text":{"description":"says: the passage","type":"string"}},"required":["media_id","name","kind","start","end","peak_seconds","peak_probability"]}},"description":"Per criterion: every match across the media, most probable first; empty when none"},"judged":{"type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"description":"Media judged"},"skipped":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"route":{"type":"string","enum":["looks","says"]},"reason":{"type":"string","enum":["not_ready","indexing","index_failed","no_picture","no_transcript","outside_candidates"]}},"required":["media_id","name","route","reason"]},"description":"Media the filters kept but nothing judged, and why: not found there is not the same as not there"},"candidates":{"description":"With candidates: each media by its best keyframe similarity, highest first","type":"array","items":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"similarity":{"type":"number"}},"required":["media_id","similarity"]}}},"required":["searched","estimate","asked","matches","judged","skipped"]}},"required":["job_id","status","status_uri","hint"]},"media_search_args":{"type":"object","properties":{"looks":{"description":"Name (yours) to what a matching picture shows, judged on every keyframe of each video and on each image: a statement about the picture, or {instructions, criteria: {true, false}} with a case of each","type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]{0,63}$"},"additionalProperties":{"anyOf":[{"type":"string","minLength":1},{"type":"object","properties":{"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"criteria":{"type":"object","properties":{"true":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"false":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}}}},"required":["instructions"],"additionalProperties":false}]}},"says":{"description":"Name to what matching speech says, judged on ~30 s passages of each media's existing transcript; media without one are listed as skipped","type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]{0,63}$"},"additionalProperties":{"anyOf":[{"type":"string","minLength":1},{"type":"object","properties":{"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"criteria":{"type":"object","properties":{"true":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"false":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}}}},"required":["instructions"],"additionalProperties":false}]}},"kind":{"description":"Only these kinds. Free","minItems":1,"type":"array","items":{"type":"string","enum":["video","image","audio","font","lut"]}},"media_ids":{"description":"Only these media. Free","minItems":1,"maxItems":200,"type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}},"from":{"description":"Only media that came this way (media.list's from). Free","minItems":1,"type":"array","items":{"type":"string","enum":["upload","url","path","render","created"]}},"name_contains":{"description":"Only media whose name contains this, ignoring case. Free","type":"string","minLength":1,"maxLength":200},"min_duration_seconds":{"description":"Only media at least this long. Free","type":"number","minimum":0},"max_duration_seconds":{"description":"Only media at most this long. Free","type":"number","minimum":0},"from_seconds":{"description":"Judge each media from this second on. Free","type":"number","minimum":0},"until_seconds":{"description":"Judge each media up to this second. Free","type":"number","minimum":0},"candidates":{"description":"Judge only the media whose pictures look most like the looks criteria, by local similarity (free, no judgments): far cheaper, and can drop media where the thing is small or brief","type":"integer","minimum":1,"maximum":200},"min_probability":{"default":0.5,"description":"A keyframe or passage matches a criterion when its probability is at least this","type":"number","minimum":0,"maximum":1},"cost_override":{"description":"Run a search estimated over 1 credit: user_confirmed (the user saw this estimate and agreed) or user_preapproved (the user said to search whatever it costs)","type":"string","enum":["user_confirmed","user_preapproved"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}}},"media_listen_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"model":{"type":"string","description":"The sound model that listened"},"asked":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"},"description":"Per sound: the words the model was given"},"matches":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"},"frame":{"description":"peak_seconds as a frame number for render.frames: a media frame (video only), or a timeline frame","type":"integer","minimum":0}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: runs of 40 ms frames that match, in time order; empty when none do"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound: the highest probability anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"},"note":{"description":"What the model can and cannot hear, to read a peak near 0 by","type":"string"}},"required":["model","asked","matches","peaks","scores"]}},"required":["job_id","status","status_uri","hint"]},"media_listen_args":{"type":"object","properties":{"media_id":{"description":"Listen to imported media (media seconds)","type":"string","pattern":"^m_[0-9a-z]{26}$"},"timeline_id":{"description":"Listen to an edit as it plays (timeline seconds): its mix, with cuts, gaps, levels and effects","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"sounds":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]{0,63}$"},"additionalProperties":{"type":"string","minLength":1,"maxLength":200},"description":"Name (yours) to the sound in plain words: what it is, as you would caption it (\"laughter\", \"a crowd cheering\", \"a door slams\", \"a phone ringing\", \"a dog barking\", \"keyboard typing\"). Up to 16, each listened for in every 40 ms frame"},"min_probability":{"default":0.5,"description":"A frame matches a sound when its probability is at least this","type":"number","minimum":0,"maximum":1},"from_seconds":{"description":"Start listening here (media or timeline seconds). Default 0","type":"number","minimum":0},"until_seconds":{"description":"Stop here. Default: the end","type":"number","minimum":0},"step_seconds":{"description":"scores: one value per this many seconds (the highest in each). Default 0.04, every frame, coarser when that would be too many","type":"number","minimum":0.04,"maximum":60},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["sounds"]},"judge_ask_result":{"type":"object","properties":{"model":{"type":"string"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"noul":{"type":"number"}},"required":["noul"]},{"type":"object","properties":{"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["choice","probabilities","confidence"]},{"type":"object","properties":{"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["score","probabilities","confidence"]},{"type":"object","properties":{"box":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},"confidence":{"type":"number"}},"required":["box","confidence"]}]},"description":"Per question id: noul {noul}; choice {choice, probabilities, confidence}; score {score, probabilities, confidence}; box {box: {x, y, w, h} fractions of the picture, confidence}"}},"required":["model","answers"]},"judge_ask_args":{"type":"object","properties":{"state":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]{0,63}$"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"at_seconds":{"description":"The frame of a video at this media time; needed for video","type":"number","minimum":0}},"required":["media_id"],"additionalProperties":false},{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"at_seconds":{"type":"number","minimum":0,"description":"Timeline seconds"}},"required":["timeline_id","at_seconds"],"additionalProperties":false},{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}]},"description":"What the judgment model sees, entry by entry: name to a string, a JSON object or array, or a picture: {media_id} (an image), {media_id, at_seconds} (a video frame) or {timeline_id, at_seconds} (a frame of an edit as it renders). Questions refer to entries by name in backticks"},"questions":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]{0,63}$"},"additionalProperties":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"noul"},"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"criteria":{"type":"object","properties":{"true":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"false":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}}}},"required":["type","instructions"]},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"criteria":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},{"type":"null"}]},"description":"option: what it means"}},"required":["type","instructions","criteria"]},{"type":"object","properties":{"type":{"type":"string","const":"score"},"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"criteria":{"minItems":2,"maxItems":10,"type":"array","items":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]},"description":"levels, lowest first"}},"required":["type","instructions","criteria"]},{"type":"object","properties":{"type":{"type":"string","const":"box"},"instructions":{"anyOf":[{"type":"string","minLength":1},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}},"required":["type","instructions"]}]},"description":"id (yours, not shown to the model) to question; up to 300, all answered about the same state"}},"required":["state","questions"]},"create_motion_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]}},"required":["job_id","status","status_uri","hint"]},"create_motion_args":{"type":"object","properties":{"html":{"type":"string","minLength":1,"maxLength":1048576,"description":"An animated HTML page or fragment laid out at width × height. Anything that animates in a browser renders frame-exactly: CSS animations and transitions, the Web Animations API, SVG, requestAnimationFrame and timers (canvas, WebGL), window.__seek(seconds) for hand-driven drawing. Libraries load from lib/: anime.umd.min.js, three.module.js, lottie.min.js, d3.min.js."},"duration_seconds":{"type":"number","exclusiveMinimum":0,"maximum":60},"width":{"default":1920,"type":"integer","minimum":16,"maximum":3840},"height":{"default":1080,"type":"integer","minimum":16,"maximum":3840},"fps":{"default":30,"type":"number","exclusiveMinimum":0,"maximum":60},"transparent":{"default":true,"description":"Alpha (ProRes 4444) so it composites over video; false gives H.264","type":"boolean"},"assets":{"default":[],"maxItems":32,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$","description":"The page refers to it as assets/<name>"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"An imported image or font"}},"required":["name","media_id"]}},"name":{"type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["html","duration_seconds"]},"create_still_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]}},"required":["job_id","status","status_uri","hint"]},"create_still_args":{"type":"object","properties":{"html":{"type":"string","minLength":1,"maxLength":1048576,"description":"An HTML page or fragment, laid out at width × height"},"width":{"default":1920,"type":"integer","minimum":16,"maximum":3840},"height":{"default":1080,"type":"integer","minimum":16,"maximum":3840},"transparent":{"default":true,"description":"Unpainted areas stay transparent","type":"boolean"},"assets":{"default":[],"maxItems":32,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$","description":"The page refers to it as assets/<name>"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"An imported image or font"}},"required":["name","media_id"]}},"name":{"type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["html"]},"create_matte_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]}},"required":["job_id","status","status_uri","hint"]},"create_matte_args":{"type":"object","properties":{"color":{"description":"A solid colour","type":"string"},"gradient":{"type":"object","properties":{"from":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"to":{"type":"string","description":"#RRGGBB, or #RRGGBBAA where AA is opacity (00 clear, FF solid)"},"angle":{"default":180,"description":"Degrees; 180 runs top to bottom","type":"number","minimum":0,"maximum":360},"kind":{"default":"linear","type":"string","enum":["linear","radial"]}},"required":["from","to"]},"width":{"default":1920,"type":"integer","minimum":16,"maximum":3840},"height":{"default":1080,"type":"integer","minimum":16,"maximum":3840},"name":{"type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}}},"create_voiceover_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]}},"required":["job_id","status","status_uri","hint"]},"create_voiceover_args":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":5000,"description":"What to say, in English"},"voice":{"default":"af_heart","description":"a/b: American/British; f/m: female/male; the rest is a name, not a description of the voice","type":"string","enum":["af_alloy","af_aoede","af_bella","af_heart","af_jessica","af_kore","af_nicole","af_nova","af_river","af_sarah","af_sky","am_adam","am_echo","am_eric","am_fenrir","am_liam","am_michael","am_onyx","am_puck","am_santa","bf_alice","bf_emma","bf_isabella","bf_lily","bm_daniel","bm_fable","bm_george","bm_lewis"]},"speed":{"default":1,"type":"number","minimum":0.5,"maximum":2},"words":{"default":true,"description":"Time each word","type":"boolean"},"name":{"type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["text"]},"create_cutout_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]}},"required":["job_id","status","status_uri","hint"]},"create_cutout_args":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"subject":{"default":"auto","description":"people: MODNet, fast, for video of people; any: BiRefNet, any subject (products, animals, objects), about 1 s a frame and 3 GB of memory; auto: any for pictures, people for video","type":"string","enum":["auto","people","any"]},"smooth":{"default":0.3,"description":"Video: steadies the edge","type":"number","minimum":0,"maximum":0.9},"region":{"description":"The item in this box (top-left x, y, size w, h; fractions) and/or at these points (keep false: not it) at at_seconds, outlined through the video (EdgeTAM, ~0.5 s a frame)","type":"object","properties":{"at_seconds":{"default":0,"type":"number","minimum":0},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.005,"maximum":1},"h":{"type":"number","minimum":0.005,"maximum":1},"points":{"maxItems":16,"type":"array","items":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"keep":{"default":true,"type":"boolean"}},"required":["x","y"]}}}},"name":{"type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["media_id"]},"create_stabilized_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]}},"required":["job_id","status","status_uri","hint"]},"create_stabilized_args":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Video to steady"},"shakiness":{"default":5,"description":"How shaky the footage is: 1 a little, 10 a lot","type":"integer","minimum":1,"maximum":10},"smoothing":{"default":10,"description":"Frames each side the camera path is smoothed over: more is steadier but follows intended moves (pans) more slowly","type":"integer","minimum":0,"maximum":500},"tripod":{"default":false,"description":"Hold the picture still against its first frame, as if on a tripod","type":"boolean"},"edges":{"default":"zoom","description":"What fills the edges steadying moves into view. zoom: one zoom for the whole video, enough to hide them; adaptive_zoom: as little zoom as each moment needs; black: no zoom, black edges; keep: no zoom, edges filled from earlier frames","type":"string","enum":["zoom","adaptive_zoom","black","keep"]},"name":{"type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["media_id"]},"create_upscaled_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]}},"required":["job_id","status","status_uri","hint"]},"create_upscaled_args":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Video or image to enlarge"},"scale":{"default":2,"description":"How many times wider and taller the result is","type":"number","minimum":1.25,"maximum":4},"denoise":{"default":"medium","description":"How much noise and compression blocking is cleaned while detail is drawn in: light keeps grain and fine texture, strong gives the smoothest picture","type":"string","enum":["light","medium","strong"]},"name":{"type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["media_id"]},"create_stems_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media the stems came from"},"model":{"type":"string"},"stems":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]},"description":"Per stem asked for: the new audio media (32-bit float WAV, 44.1 kHz stereo)"}},"required":["media_id","model","stems"]}},"required":["job_id","status","status_uri","hint"]},"create_stems_args":{"type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Video or audio with sound"},"stems":{"default":["vocals","drums","bass","other"],"description":"vocals: voices, spoken or sung; drums, bass, other: the rest, by kind (other holds everything else: guitars, keys, effects, room noise); no_vocals: all but the voice in one file. Each becomes its own media","minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["vocals","drums","bass","other","no_vocals"]}},"name":{"type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["media_id"]},"create_lipsync_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"name":{"type":"string"},"url":{"description":"media.get: a signed download of the file itself, once it has one","type":"string"},"page_url":{"description":"media.get: a page that plays or shows the file in any browser, with no sign-in, to give a person; works until expires_at","type":"string"},"expires_at":{"description":"When url and page_url stop working","type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after last use; any use (a read, an edit, a render) pushes it back","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"origin":{"type":"object","properties":{"from":{"type":"string","enum":["upload","url","path","render","created","still"],"description":"upload: a file the user sent; url: downloaded; path: a media root; render: an export.video; created: a create.* tool; still: a frame of a video or an edit"},"url":{"description":"url: the address it was downloaded from, without its query string","type":"string"},"attached":{"description":"url: the file the user attached in the chat, passed as media.import file","type":"boolean"},"path":{"description":"path: the file it was imported from","type":"string"},"upload_id":{"type":"string","pattern":"^u_[0-9a-z]{26}$","description":"Upload handle from media.upload"},"file_name":{"description":"upload: the name the file was sent with","type":"string"},"via":{"description":"upload: sent through a media.upload link, dropped on the cuttingfloor site, or a data: URI","type":"string","enum":["media.upload","account_page","data_uri"]},"job_id":{"description":"render: the export.video job; created: the create.* job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"timeline_id":{"description":"render: the timeline that was exported; still: the edit the frame is from","type":"string","pattern":"^tl_[0-9a-f]{32}$"},"media_id":{"description":"still: the video the frame is from","type":"string","pattern":"^m_[0-9a-z]{26}$"},"frame":{"description":"still: the frame","type":"number"},"preset":{"description":"render: the export preset","type":"string"},"range":{"description":"render: the frames exported, when not the whole timeline","type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"required":["start","end"]},"sources":{"description":"render: where each stretch of this file comes from, per track, read from the timeline when it was exported (kept after the timeline expires). With a speed curve, source_in and source_out are the clip's whole source range","type":"array","items":{"type":"object","properties":{"track_id":{"type":"string","description":"Track of the timeline; outer/inner inside a nested one"},"kind":{"type":"string","enum":["video","audio"]},"start":{"type":"number","description":"Seconds into this file"},"end":{"type":"number"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The media this stretch plays"},"source_in":{"type":"number","description":"Seconds into that media"},"source_out":{"type":"number"},"speed":{"description":"The clip's speed change, as clip.set_speed set it","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["track_id","kind","start","end","media_id","source_in","source_out"]}},"tool":{"description":"created: the create.* tool that made it","type":"string"},"recipe":{"description":"created: a hash of what it was made from; the same recipe makes the same media","type":"string"},"media_ids":{"description":"created: the media it was made from (a cutout's source, a page's assets)","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}}},"required":["from"],"description":"Where it came from, to tell one version from another: the import source, the export of which timeline, or the create.* tool and the media it was made from"},"created_at":{"description":"When it was imported or made","type":"string"},"fingerprint":{"description":"Identity of the file (BLAKE3 of its size and first, middle and last 4 MB), as export.video gives","type":["string","null"]},"status":{"type":"string","enum":["importing","processing","ready","failed"],"description":"importing: not probed yet; processing: usable in edits, proxy still rendering; ready; failed"},"kind":{"anyOf":[{"type":"string","enum":["video","audio","image","font","lut"]},{"type":"null"}]},"extension":{"description":"The extension its format takes (.png, .mp4), from the file itself, not its name","type":"string"},"mime_type":{"description":"Its MIME type, likewise","type":"string"},"probe":{"description":"media.get: everything FFprobe read from the file, as it gives it: the format and every stream (codec, pix_fmt, color_space, color_primaries, color_transfer, color_range, bit depth, sample rate, channel layout, tags, side data). Not for fonts and LUTs","type":"object","properties":{"format":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"streams":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["format","streams"]},"font_family":{"description":"Fonts: the family; use font_media_id in a text style to set text in it","type":"string"},"duration_seconds":{"type":["number","null"]},"fps":{"anyOf":[{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number"}},"required":["num","den"]},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"has_video":{"type":"boolean"},"has_audio":{"type":"boolean"},"codecs":{"type":"object","properties":{"video":{"type":["string","null"]},"audio":{"type":["string","null"]}},"required":["video","audio"]},"sound_seconds":{"description":"How long the sound runs; under duration_seconds, the end is soundless","type":"number"},"picture_seconds":{"description":"How long the picture runs; under duration_seconds, the end has no picture","type":"number"},"conform":{"type":"array","items":{"type":"string"},"description":"Why a mezzanine was made (vfr, rotation, hdr, codec); empty when not needed"},"analysis":{"anyOf":[{"type":"object","properties":{"loudness_lufs":{"description":"Integrated loudness at import","type":["number","null"]},"channels":{"description":"Each channel at import","type":"array","items":{"type":"object","properties":{"channel":{"type":"integer","exclusiveMinimum":0},"rms_dbfs":{"type":["number","null"]},"peak_dbfs":{"type":["number","null"]},"noise_floor_dbfs":{"type":["number","null"]}},"required":["channel","rms_dbfs","peak_dbfs","noise_floor_dbfs"]}}},"required":["loudness_lufs"]},{"type":"null"}]},"analyses":{"description":"Summaries of media.analyze results (counts, not data); include puts each in full at the top level","type":"object","properties":{"transcript":{"type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"words":{"type":"number","description":"How many words; the words themselves are in transcript.words"}},"required":["model","language","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"number"}},"required":["bpm","beats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames_with_faces":{"type":"number"}},"required":["rate","frames_with_faces"]},"speech":{"type":"object","properties":{"model":{"type":"string"},"frames":{"type":"number"},"frame_seconds":{"type":"number"}},"required":["model","frames","frame_seconds"]},"look":{"description":"frames and questions: the latest run","type":"object","properties":{"runs":{"type":"number"},"frames":{"type":"number"},"questions":{"type":"array","items":{"type":"string"}}},"required":["runs","frames","questions"]},"sounds":{"description":"heard: the sounds the latest run found at or above its min_probability","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"heard":{"type":"array","items":{"type":"string"}}},"required":["model","min_probability","heard"]},"speakers":{"type":"object","properties":{"model":{"type":"string"},"speakers":{"type":"number"},"turns":{"type":"number"}},"required":["model","speakers","turns"]},"voice":{"description":"frames, and the summary media.analyze voice gives","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"colour":{"type":"object","properties":{"frames":{"type":"number"},"regions":{"type":"array","items":{"type":"string"}}},"required":["frames","regions"]},"picture":{"type":"object","properties":{"frames":{"type":"number"},"from":{"type":"number"}},"required":["frames","from"]}}},"transcript":{"description":"With include [\"transcript\"]: every word as {text, start, end, confidence}","type":"object","properties":{"model":{"type":"string"},"language":{"type":"string"},"text":{"type":"string"},"aligned_by":{"description":"The model that moved word edges to where the letters sound (English); null: the times are whisper's own, up to about a second off","type":["string","null"]},"from":{"description":"The stretch transcribed, if not all","type":"number"},"until":{"type":["number","null"]},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"confidence":{"type":"number","description":"0–1: how sure whisper is of the word itself"},"timing_confidence":{"description":"0–1: how clearly the letters were heard between start and end; null: not aligned (digits, symbols, other languages), times fitted between neighbours","type":["number","null"]},"speaker":{"description":"Who says it, from the latest speakers run","type":["number","null"]}},"required":["text","start","end","confidence"]},"description":"Media seconds. Aligned words start and end within about 0.05 s of where their letters sound; an end on a soft consonant (s, t, k, f) or a breath can ring on up to about 0.1 s more. Short ums are often missing from the words; kind speech finds them as speech. A word \"-\" (or one starting with it) is whisper marking a new speaker, as subtitles do: a hint only; kind speakers measures who speaks when"}},"required":["model","language","text","words"]},"beats":{"type":"object","properties":{"bpm":{"type":"number"},"beats":{"type":"array","items":{"type":"number"}},"downbeats":{"type":"array","items":{"type":"number"}},"strengths":{"description":"Per beat: its onset strength, 0–1 of the strongest in the sound","type":"array","items":{"type":"number"}}},"required":["bpm","beats","downbeats"]},"faces":{"type":"object","properties":{"rate":{"type":"number"},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"faces":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"score":{"type":"number"}},"required":["x","y","w","h","score"],"description":"Top-left corner x, y and size w, h, fractions of the picture (centre: x + w/2, y + h/2); score 0–1"}}},"required":["time","faces"]}}},"required":["rate","frames"]},"look":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"questions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"with_previous":{"type":"boolean"},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"frames":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number"},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["time","answers"]}}},"required":["id","model","questions","with_previous","frames"]}}},"required":["runs"]},"pages":{"description":"media.get with a range, offset or limit: per included analysis, which piece of its list came back","type":"object","propertyNames":{"type":"string","enum":["transcript","beats","faces","look","speech","sounds","speakers","voice","colour","picture"]},"additionalProperties":{"type":"object","properties":{"list":{"type":"string","description":"The list paged: transcript.words, beats.beats, faces.frames, speech.probabilities (one per frame_seconds from `from`), speakers.turns, voice.frames, colour.frames, picture.columns (every column alike), or look runs[].frames (each run is cut the same way; first and the counts are the latest run's)"},"first":{"type":"integer","description":"Index in the whole list of the first item returned (transcript: the word index clip.add source {words} takes)"},"returned":{"type":"integer"},"matching":{"type":"integer","description":"Items in the time range (the whole list without one)"},"total":{"type":"integer","description":"Items in the whole list"},"next_offset":{"description":"The offset that gives the next page of this range, or null at its end","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["list","first","returned","matching","total","next_offset"]}},"speech":{"description":"With include [\"speech\"]: the speech probability of every 32 ms frame","type":"object","properties":{"model":{"type":"string"},"frame_seconds":{"type":"number","description":"Each probability covers this long"},"from":{"type":"number","description":"Seconds where the first probability starts"},"probabilities":{"type":"array","items":{"type":"number"},"description":"Speech probability 0–1, one per frame, in order"}},"required":["model","frame_seconds","from","probabilities"]},"sounds":{"description":"With include [\"sounds\"]: the latest media.analyze sounds run, every probability included","type":"object","properties":{"model":{"type":"string"},"min_probability":{"type":"number"},"spans":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number","description":"Where the run of matching 40 ms frames starts: media seconds, or timeline seconds for a timeline"},"end":{"type":"number","description":"Where it ends, on the same clock"},"peak_seconds":{"type":"number","description":"The middle of the most likely frame"},"peak_probability":{"type":"number"}},"required":["start","end","peak_seconds","peak_probability"]}},"description":"Per sound: the runs of 40 ms frames at or above min_probability, in time order; empty when it never is"},"peaks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Per sound reported: the highest probability it reaches anywhere"},"scores":{"type":"object","properties":{"start_seconds":{"type":"number","description":"Where the first value starts: media seconds, or timeline seconds for a timeline"},"step_seconds":{"type":"number","description":"Seconds each value covers: 0.04 (every frame) unless asked or too long"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"number"}},"description":"Per sound, the highest probability in each step, 0 to 1"}},"required":["start_seconds","step_seconds","values"],"description":"Every probability, for your own cut-off or arithmetic"}},"required":["model","min_probability","spans","peaks"]},"warnings":{"description":"create.motion and create.still: what went wrong in the page as it rendered (uncaught errors, console errors, files blocked or not found, tags never closed). It rendered anyway","type":"array","items":{"type":"string"}},"job":{"description":"media.get, while importing or being made: the job doing it","type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"progress":{"type":"number"},"status_message":{"type":"string"},"seconds_left":{"type":"number"}},"required":["job_id","tool","status"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["media_id","name","status","kind","duration_seconds","fps","width","height","has_video","has_audio","codecs","conform","analysis"]}},"required":["job_id","status","status_uri","hint"]},"create_lipsync_args":{"type":"object","properties":{"video":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The video of the person speaking, whose mouth is redrawn"},"audio":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"The speech they should say: audio media, or a video whose sound is used (e.g. create.voiceover, a re-recorded line)"},"range":{"description":"Only this span of the video, in the video's seconds (e.g. the sentence or word being replaced). The result is that span alone, re-synced; place it over the same span on the timeline. Default: the whole video","type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"end_seconds":{"type":"number","exclusiveMinimum":0}},"required":["start_seconds","end_seconds"]},"audio_range":{"description":"Only this span of the audio, in the audio's seconds. Default: all of it","type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"end_seconds":{"type":"number","exclusiveMinimum":0}},"required":["start_seconds","end_seconds"]},"sync_mode":{"default":"remap","description":"When the picture and the speech differ in length. remap: the picture is sped up or slowed to the speech (result as long as the speech); cut_off: the longer one is cut (as long as the shorter); silence: the speech is padded with silence (as long as the longer); loop / bounce: the picture repeats, or plays back and forth, to cover longer speech (as long as the speech)","type":"string","enum":["remap","cut_off","silence","loop","bounce"]},"model":{"default":"lipsync-2","description":"The provider's model: lipsync-2 (the standard), lipsync-2-pro (finer teeth, beards and detail), sync-3 (close-ups, profiles, hands or mics in front of the mouth). Billed to the user's own key","type":"string","enum":["lipsync-2","lipsync-2-pro","sync-3"]},"provider":{"default":"sync","description":"sync: sync. labs (sync.so), with the user's SYNC_API_KEY","type":"string","enum":["sync"]},"name":{"type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["video","audio"]},"render_frames_result":{"type":"object","properties":{"images":{"type":"array","items":{"type":"object","properties":{"uri":{"type":"string","description":"MCP resource for the image"},"frames":{"type":"array","items":{"type":"integer","minimum":0}},"url":{"type":"string","description":"Signed download of this image"},"expires_at":{"type":"string"},"mime_type":{"type":"string"},"bytes":{"type":"number"}},"required":["uri","frames","url","expires_at","mime_type","bytes"]}}},"required":["images"]},"render_frames_args":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"media_id":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"},"frames":{"minItems":1,"maxItems":16,"type":"array","items":{"type":"integer","minimum":0},"description":"Timeline frames, or media frames at the media rate"},"layout":{"default":"grid","description":"grid: one contact sheet","type":"string","enum":["single","grid"]},"long_edge":{"default":640,"type":"integer","minimum":64,"maximum":1920},"size":{"default":"preview","description":"full: the sequence size from original media (long_edge ignored)","type":"string","enum":["preview","full"]},"format":{"default":"webp","description":"jpeg: for places that take nothing else; png: lossless","type":"string","enum":["webp","png","jpeg"]},"quality":{"description":"WebP and JPEG, 1–100 (default 82 WebP, 85 JPEG)","type":"integer","minimum":1,"maximum":100}},"required":["frames"]},"export_video_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"url":{"type":"string","description":"Signed download URL"},"page_url":{"type":"string","description":"A page that plays the file in any browser, with no sign-in: the link to give a person to watch or share it. Works until expires_at"},"expires_at":{"type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after the export finished","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"uri":{"type":"string","description":"MCP resource for the output"},"file":{"description":"Where the file was written in the exports folder (local mode)","type":"string"},"bytes":{"type":"number"},"frames":{"type":"number"},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"preset":{"type":"string","enum":["mp4_h264","mp4_h264_fast","mp4_av1","mov_prores_422hq","gif","wav","mp3"]},"mime_type":{"type":"string"},"sha256":{"description":"SHA-256 of the whole file: equal only for equal bytes","type":"string"},"fingerprint":{"description":"The fingerprint media.get gives the file once imported","type":"string"}},"required":["url","page_url","expires_at","uri","bytes","frames","preset","mime_type"]}},"required":["job_id","status","status_uri","hint"]},"export_video_args":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"preset":{"type":"string","enum":["mp4_h264","mp4_h264_fast","mp4_av1","mov_prores_422hq","gif","wav","mp3"],"description":"A format; the picture comes out at the sequence size unless overrides set another. video://catalog/presets lists what each takes"},"overrides":{"type":"object","properties":{"width":{"type":"integer","minimum":16,"maximum":7680},"height":{"type":"integer","minimum":16,"maximum":7680},"fps":{"type":"number","exclusiveMinimum":0,"maximum":120},"bitrate":{"description":"Video bitrate like 8M, instead of constant quality","type":"string","pattern":"^\\d+(\\.\\d+)?[kM]$"},"crf":{"type":"integer","minimum":0,"maximum":63}},"description":"Change the preset: a size box (aspect kept), frame rate, bitrate or quality"},"range":{"description":"Frames, end exclusive","type":"object","properties":{"start":{"type":"integer","minimum":0},"end":{"type":"integer","minimum":0}},"required":["start","end"]},"filename":{"description":"Output file name without extension. Default: timeline name and id","type":"string","pattern":"^[\\w][\\w .-]{0,120}$"},"overwrite":{"default":false,"type":"boolean"},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["timeline_id","preset"]},"qa_check_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"range":{"type":"object","properties":{"start":{"type":"integer","minimum":0},"end":{"type":"integer","minimum":0}},"required":["start","end"]},"gaps":{"type":"array","items":{"type":"object","properties":{"start":{"type":"integer","minimum":0},"end":{"type":"integer","minimum":0}},"required":["start","end"]},"description":"Frames with no picture on any visible video track"},"offline_media":{"type":"array","items":{"type":"string"},"description":"Media ids that are offline; nothing was rendered"},"frames":{"description":"null when offline media stopped the render","anyOf":[{"type":"object","properties":{"expected":{"type":"number"},"rendered":{"type":"number"}},"required":["expected","rendered"]},{"type":"null"}]},"black":{"description":"With black settings: black stretches, frames","type":"array","items":{"type":"object","properties":{"start":{"type":"integer","minimum":0},"end":{"type":"integer","minimum":0}},"required":["start","end"]}},"silences":{"description":"With silence settings: silent stretches, frames","type":"array","items":{"type":"object","properties":{"start":{"type":"integer","minimum":0},"end":{"type":"integer","minimum":0}},"required":["start","end"]}},"integrated_lufs":{"description":"null below the EBU R128 -70 LUFS gate","type":["number","null"]},"true_peak_dbtp":{"type":["number","null"]},"cuts":{"description":"With speech settings: every cut in the range, in order (up to 500)","type":"array","items":{"type":"object","properties":{"frame":{"type":"integer","minimum":0},"seconds":{"type":"number"},"speech_before":{"type":"number","description":"Speech probability of the mix just before the cut"},"speech_after":{"type":"number","description":"Speech probability of the mix just after the cut"},"silence_before_seconds":{"type":"number","description":"Seconds without speech before the cut (to the range start if none)"},"silence_after_seconds":{"type":"number","description":"Seconds without speech after the cut (to the range end if none)"},"edges":{"type":"array","items":{"type":"object","properties":{"track_id":{"type":"string"},"out_clip_id":{"description":"The clip ending here","type":["string","null"]},"in_clip_id":{"description":"The clip starting here","type":["string","null"]},"out_word":{"description":"The transcript word the ending clip stops inside; seconds_cut of it is lost","anyOf":[{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number","description":"Media seconds"},"end":{"type":"number"},"at":{"type":"number","description":"Where the clip edge is, media seconds"},"seconds_cut":{"type":"number"}},"required":["text","start","end","at","seconds_cut"]},{"type":"null"}]},"in_word":{"description":"The transcript word the starting clip begins inside; seconds_cut of it is lost","anyOf":[{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number","description":"Media seconds"},"end":{"type":"number"},"at":{"type":"number","description":"Where the clip edge is, media seconds"},"seconds_cut":{"type":"number"}},"required":["text","start","end","at","seconds_cut"]},{"type":"null"}]}},"required":["track_id","out_clip_id","in_clip_id","out_word","in_word"]},"description":"Media clip edges on each track at this frame"}},"required":["frame","seconds","speech_before","speech_after","silence_before_seconds","silence_after_seconds","edges"]}},"cuts_total":{"description":"With speech settings: how many cuts there are","type":"number"}},"required":["range","gaps","offline_media","frames","integrated_lufs","true_peak_dbtp"]}},"required":["job_id","status","status_uri","hint"]},"qa_check_args":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"range":{"type":"object","properties":{"start":{"type":"integer","minimum":0},"end":{"type":"integer","minimum":0}},"required":["start","end"]},"black":{"description":"Find black stretches with these settings; left out, none are looked for","type":"object","properties":{"pixel_threshold":{"type":"number","minimum":0,"maximum":1,"description":"A pixel this dark or darker is black"},"picture_share":{"type":"number","minimum":0,"maximum":1,"description":"A frame with this share of black pixels is black"},"min_seconds":{"type":"number","minimum":0.01,"maximum":3600}},"required":["pixel_threshold","picture_share","min_seconds"]},"silence":{"description":"Find silent stretches in the mix with these settings; left out, none are looked for","type":"object","properties":{"threshold_db":{"type":"number","minimum":-100,"maximum":0,"description":"Quieter than this, dBFS"},"min_seconds":{"type":"number","minimum":0.01,"maximum":3600}},"required":["threshold_db","min_seconds"]},"speech":{"description":"List every cut with speech facts (Silero VAD on the mix, and the transcript word each clip edge cuts through); left out, cuts are not listed. Only junctions between two clips are listed, so a lone clip reports none and its own head and tail are never examined. A null word means the edge falls between words: that is a clean cut, not a missing reading","type":"object","properties":{"min_probability":{"type":"number","minimum":0,"maximum":1,"description":"A 32 ms frame of the mix with at least this speech probability is speech"}},"required":["min_probability"]}},"required":["timeline_id"]},"job_get_result":{"type":"object","anyOf":[{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_message":{"description":"What it is doing; while it waits, its place in the queue and what it waits for (a job slot, a render slot or the sandbox)","type":"string"},"progress":{"type":"number","minimum":0,"maximum":1},"for":{"type":"object","properties":{"media_id":{"description":"The media it imports, makes or reads","type":"string","pattern":"^m_[0-9a-z]{26}$"},"media_ids":{"description":"Stems it makes","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}},"inputs":{"description":"Media it is made from","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"kind":{"type":"string"},"preset":{"type":"string"}},"description":"What it is for, known from the start"},"seconds_left":{"description":"Running: seconds left at its recent rate of progress, once it has moved steadily (later steps may differ)","type":"number"},"starts_in_seconds":{"description":"Queued next in line: seconds until a slot should free, when every job holding one has seconds_left","type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"result":{"description":"The tool's structured result once completed"},"result_summary":{"description":"result \"summary\": the result in brief; result \"full\" has all of it","type":"object","properties":{"value":{"description":"Lists cut to 5 items, long text cut"},"cut":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Path of each cut (a.b.0.c): its full length"}},"required":["value","cut"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["job_id","tool","status","created_at","updated_at"]},{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_message":{"description":"What it is doing; while it waits, its place in the queue and what it waits for (a job slot, a render slot or the sandbox)","type":"string"},"progress":{"type":"number","minimum":0,"maximum":1},"for":{"type":"object","properties":{"media_id":{"description":"The media it imports, makes or reads","type":"string","pattern":"^m_[0-9a-z]{26}$"},"media_ids":{"description":"Stems it makes","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}},"inputs":{"description":"Media it is made from","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"kind":{"type":"string"},"preset":{"type":"string"}},"description":"What it is for, known from the start"},"seconds_left":{"description":"Running: seconds left at its recent rate of progress, once it has moved steadily (later steps may differ)","type":"number"},"starts_in_seconds":{"description":"Queued next in line: seconds until a slot should free, when every job holding one has seconds_left","type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"result":{"description":"The tool's structured result once completed"},"result_summary":{"description":"result \"summary\": the result in brief; result \"full\" has all of it","type":"object","properties":{"value":{"description":"Lists cut to 5 items, long text cut"},"cut":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Path of each cut (a.b.0.c): its full length"}},"required":["value","cut"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["job_id","tool","status","created_at","updated_at"]},"description":"The jobs found, in the order asked"},"not_found":{"type":"array","items":{"type":"string"},"description":"Ids with no job of yours (finished jobs are kept 7 days)"}},"required":["jobs","not_found"]}]},"job_get_args":{"type":"object","properties":{"job_id":{"description":"One job: the answer is that job","type":"string","pattern":"^j_[0-9a-z]{26}$"},"job_ids":{"description":"Many jobs at once (up to 100): the answer is {jobs, not_found}","minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"}},"wait_seconds":{"default":0,"description":"Wait up to this long (at most 50 s) for any job asked for to finish (its status changes); progress along the way does not end the wait; 0 answers at once","type":"number","minimum":0,"maximum":50},"result":{"description":"Default full for one job_id; summary for job_ids, so a check on many stays small (full gives them whole)","type":"string","enum":["full","summary","none"]}}},"job_list_result":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_message":{"description":"What it is doing; while it waits, its place in the queue and what it waits for (a job slot, a render slot or the sandbox)","type":"string"},"progress":{"type":"number","minimum":0,"maximum":1},"for":{"type":"object","properties":{"media_id":{"description":"The media it imports, makes or reads","type":"string","pattern":"^m_[0-9a-z]{26}$"},"media_ids":{"description":"Stems it makes","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}},"inputs":{"description":"Media it is made from","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"kind":{"type":"string"},"preset":{"type":"string"}},"description":"What it is for, known from the start"},"seconds_left":{"description":"Running: seconds left at its recent rate of progress, once it has moved steadily (later steps may differ)","type":"number"},"starts_in_seconds":{"description":"Queued next in line: seconds until a slot should free, when every job holding one has seconds_left","type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"result":{"description":"The tool's structured result once completed"},"result_summary":{"description":"result \"summary\": the result in brief; result \"full\" has all of it","type":"object","properties":{"value":{"description":"Lists cut to 5 items, long text cut"},"cut":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Path of each cut (a.b.0.c): its full length"}},"required":["value","cut"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["job_id","tool","status","created_at","updated_at"]}}},"required":["jobs"]},"job_list_args":{"type":"object","properties":{"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"tool":{"description":"Only jobs of this tool, e.g. media.import","type":"string"},"media_id":{"description":"Only jobs for this media (importing, making or reading it)","type":"string","pattern":"^m_[0-9a-z]{26}$"},"limit":{"default":50,"type":"integer","minimum":1,"maximum":200},"result":{"default":"none","description":"none (default): each job without its result, to find one; summary: lists cut short; full: every result whole","type":"string","enum":["full","summary","none"]}}},"job_cancel_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"tool":{"type":"string"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_message":{"description":"What it is doing; while it waits, its place in the queue and what it waits for (a job slot, a render slot or the sandbox)","type":"string"},"progress":{"type":"number","minimum":0,"maximum":1},"for":{"type":"object","properties":{"media_id":{"description":"The media it imports, makes or reads","type":"string","pattern":"^m_[0-9a-z]{26}$"},"media_ids":{"description":"Stems it makes","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}},"inputs":{"description":"Media it is made from","type":"array","items":{"type":"string","pattern":"^m_[0-9a-z]{26}$","description":"Media handle from media.import or a create.* tool"}},"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"kind":{"type":"string"},"preset":{"type":"string"}},"description":"What it is for, known from the start"},"seconds_left":{"description":"Running: seconds left at its recent rate of progress, once it has moved steadily (later steps may differ)","type":"number"},"starts_in_seconds":{"description":"Queued next in line: seconds until a slot should free, when every job holding one has seconds_left","type":"number"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"result":{"description":"The tool's structured result once completed"},"result_summary":{"description":"result \"summary\": the result in brief; result \"full\" has all of it","type":"object","properties":{"value":{"description":"Lists cut to 5 items, long text cut"},"cut":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"},"description":"Path of each cut (a.b.0.c): its full length"}},"required":["value","cut"]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","no_audio","not_found","expired","media_not_ready","media_offline","engine_error","render_failed","interrupted","stalled","cancelled","credential_required","credential_invalid","output_exists","path_not_allowed","limit_exceeded","quota_exceeded","subscription_required","email_unverified","service_unavailable","server_busy"]},"message":{"type":"string"},"detail":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"hint":{"type":"string"}},"required":["code","message"]}},"required":["job_id","tool","status","created_at","updated_at"]},"job_cancel_args":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"}},"required":["job_id"]},"export_timeline_result":{"type":"object","properties":{"job_id":{"type":"string","pattern":"^j_[0-9a-z]{26}$","description":"Job handle; the same value is the MCP task id"},"status":{"type":"string","enum":["working","completed","failed","cancelled"]},"status_uri":{"type":"string"},"media_id":{"description":"The media it is making: an import is usable in edits once its status is processing, a created media once this job completes","type":"string","pattern":"^m_[0-9a-z]{26}$"},"hint":{"type":"string"},"result":{"description":"The result, when status is completed; otherwise job.get gives it once completed","type":"object","properties":{"url":{"type":"string","description":"Signed download URL"},"expires_at":{"type":"string"},"kept_until":{"description":"When the server deletes it: 7 days after the export finished","type":"string"},"expiry":{"description":"kept_until in words: how long is left, and what keeps it longer or how to keep it","type":"string"},"uri":{"type":"string","description":"MCP resource for the output"},"file":{"description":"Where it was written in the exports folder (local mode)","type":"string"},"bytes":{"type":"number"},"format":{"type":"string"},"mime_type":{"type":"string"},"media":{"type":"number","description":"Media files referenced (or collected)"},"warnings":{"type":"array","items":{"type":"string"},"description":"What the format could not carry"}},"required":["url","expires_at","uri","bytes","format","mime_type","media","warnings"]}},"required":["job_id","status","status_uri","hint"]},"export_timeline_args":{"type":"object","properties":{"timeline_id":{"type":"string","pattern":"^tl_[0-9a-f]{32}$","description":"Timeline handle; every edit returns a new one"},"format":{"type":"string","enum":["fcpxml","otio","edl","srt","vtt"],"description":"fcpxml: Final Cut Pro, Resolve; otio: Premiere, Resolve, any OTIO app; edl: CMX 3600; srt/vtt: captions"},"media":{"default":"reference","description":"reference: point at the media where it is; collect: a .zip with the media in it","type":"string","enum":["reference","collect"]},"filename":{"description":"Output file name without extension. Default: timeline name and id","type":"string","pattern":"^[\\w][\\w .-]{0,120}$"},"overwrite":{"default":false,"type":"boolean"},"idempotency_key":{"type":"string","minLength":1,"maxLength":200}},"required":["timeline_id","format"]},"skills_search_result":{"type":"object","properties":{"matched":{"type":"boolean","description":"true: these skills fit the query, best first; false: none did, and this is a page of every skill"},"skills":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string"},"description":{"type":"string"}},"required":["slug","name","description"]}},"total":{"type":"integer","description":"Skills in the whole answer, across its pages"},"next_offset":{"description":"offset for the next page; null on the last","anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["matched","skills","total","next_offset"]},"skills_search_args":{"type":"object","properties":{"query":{"description":"What the user wants done, in their words, e.g. \"remove the ums from my video\". Without it, the list of every skill","type":"string","minLength":1,"maxLength":500},"limit":{"default":5,"description":"Most skills in one answer","type":"integer","minimum":1,"maximum":20},"offset":{"default":0,"description":"Where a page of the list starts: the next_offset of the page before","type":"integer","minimum":0}}},"skills_get_result":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"name":{"type":"string"},"description":{"type":"string"},"version":{"type":"number"},"author":{"type":"string","description":"Who wrote the skill; credit them when you name it"},"author_url":{"description":"A link to the author or the work the skill came from; null when there is none","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"related":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"relationship":{"type":"string","enum":["prerequisite","alternative","extends","related"]}},"required":["slug","relationship"]}},"markdown":{"type":"string","description":"The whole skill, frontmatter included: follow its Steps"}},"required":["slug","name","description","version","author","author_url","related","markdown"]},"skills_get_args":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$","description":"From skills.search, e.g. \"cut-pauses-ums-and-restarts\""}},"required":["slug"]}}}}