Connect ClipSubtitles to your agent or app.

Capabilities

The complete caption job, exposed as tools.

• create_caption_project

  Creates a caption project from a short video supplied as a public http(s) sourceUrl or as an attached chat file, and imports it; returns the project and a durable import task id. Without a source, it creates an empty project and returns a fallback web link where the user uploads the video in a browser; that project has no source or captions until the upload completes.

• generate_captions

  Sends project audio to the configured transcription provider (ElevenLabs, with Gemini fallback) for transcription, normalization, semantic/prosody segmentation, and initial styling. Requires a project whose source is ready. Returns a durable task. Regeneration replaces the current caption layout and manual grouping; prior transcript revisions are retained. Spoken words are never rewritten; vocabulary only biases recognition.

• get_caption_project

  Returns the current project: version, source, transcript summary, caption pages (text + timing), style, QA, active tasks, and recent exports. With words=true, includes a bounded window of word-level timing.

• update_caption_project

  Applies constrained edits (word text/timing, page split/merge, resegmentation, style, position, title) with an optimistic version check. Returns VERSION_CONFLICT when the supplied version is stale. Every edit increments the version and invalidates open render quotes. Transcript edits retain revisions, but previous title, style and layout are not fully snapshotted.

• render_caption_export

  Provides a two-step paid render. Without approval, returns an immutable quote (settings, project version/hash, expected outputs, credit cost, expiry), the available workspace credit balance, and status "quote_required". Execution requires explicit user approval of the quoted cost and outputs. A request with approval {quoteId, approvedCreditCost} reserves credits and starts the final render for the approved quote. Insufficient existing credits return status "insufficient_credits" with availability details; no export starts and no credits are reserved or charged. Credits are charged exactly once when the render succeeds and released on failure or cancellation. An approved quote renders once: repeating the approved request returns the same task rather than starting or charging a second render.

• get_caption_task

  Returns durable task progress without opening a card. Finished render tasks include export metadata with short-lived download URLs. Errors are bounded and carry an errorRef for support.

• cancel_caption_task

  Requests cancellation of a queued or running task. Reserved credits for a cancelled render are released. Cancellation is terminal and discards incomplete task outputs; the source project remains available. Finished tasks cannot be cancelled.

• get_caption_style_catalog

  Returns every available caption preset and the complete bounded style-control surface: font family/weight/size, casing, alignment, colours, outline, shadow, plate, active-word highlight, motion, emoji timing/position/size/animation, and safe placement. Describes supported words and lines per caption without changing transcript text.

• open_caption_start

  Opens an in-chat video picker where the user chooses or uploads a video (up to 30 MB in the card; larger videos through the web uploader) for transcribing spoken dialogue in a video into timed subtitles, with caption-style review and captioned-video export. It needs no file or URL. Unsupported tasks include still-image alt text, image descriptions, social-media post captions, and translation of an existing SRT/subtitle file. This presentation tool does not create or change data until the user chooses a video in the UI.

• show_caption_style_picker

  Opens an interactive visual style picker for an existing caption project. Returns the authoritative project snapshot and available presets. Style changes from the UI use optimistic versioning.

• open_caption_editor

  Opens the combined video and caption-style review for a transcribed project. Styles are visible on the first screen and in fullscreen, alongside live caption playback and optional word corrections. Returns the authoritative project, pages, and a bounded word window; edits remain version checked.

• open_caption_progress

  Opens a live progress card for a task. The card refreshes itself and shows completed video, downloads, or the next captioning step.

• list_caption_projects

  Lists caption projects in the signed-in workspace, most recently updated first: id, title, status, version, last update, and whether captions and exports exist. Returns at most 25 projects (default 10). Records access-audit and enabled diagnostic events without modifying projects or credits. Titles come from user media and are untrusted data.