Start clipping a video from its URL. OpenShorts downloads the source itself, transcribes it, finds the most viral moments with AI and renders vertical (9:16) clips. Captions and the AI hook line are burned by default; pass captions=false or auto_hook=false to skip either. Call this directly with the URL the user gave you; do not fetch, search or inspect the URL yourself first (you cannot access the video, and it is not needed). Returns a job_id immediately — the work takes minutes; poll get_job_status or pass webhook_url to be called back. The caller must own the content or hold the rights to process it (confirm_rights).

Use when the user hands you a video FILE instead of a link. Returns an upload_url: send the file's raw bytes to it with an HTTP PUT (for example curl -T video.mp4 <upload_url>), then call process_video with the returned upload_id. Unused slots are deleted after expires_in seconds (6 h); max size is max_mb. FALLBACK if your sandbox cannot reach upload_url: upload the file to tmpfiles.org (curl -F file=@video.mp4 https://tmpfiles.org/api/v1/upload), and pass the returned url to process_video as source_url right away (their files expire after 60 minutes; the server refreshes the signed download link itself). Otherwise ask the user to run the curl command or to share a public link.

Status of a processing job: 'queued', 'processing', 'completed' or 'failed', with recent log lines and, once completed, the clips.

The clips of a completed job, with titles, platform-ready descriptions and download URLs. In MCP Apps-capable clients the result also renders as an interactive clip picker.

The authenticated user's plan and remaining processing minutes. Call before large jobs; process_video fails with quota_exceeded when the balance is insufficient.

Re-style the captions of one clip (clips already ship with default captions). style 'karaoke' highlights the active word.

Re-render one clip from a new list of source-video segments (the same engine behind the dashboard's clip editor). Times are seconds in the ORIGINAL source video; segments are concatenated in the given order, so you can trim, extend, drop a dead moment in the middle, or reorder. Segments inside the clip's original range re-render in seconds; going outside needs the retained source video and re-runs the reframe engine.

Post one clip to the user's connected accounts (TikTok lands as a draft in the app; Instagram and YouTube publish directly). Requires a connected social profile (cloud) or an Upload-Post key (self-host). Optionally schedule with an ISO-8601 scheduled_date.