Tscaps documentation

Caption videos with tscaps outside the editor, from your own code with the Automation API, or from a chat in Claude and ChatGPT.

There are two ways to caption videos with tscaps outside the editor:

Automation API: from your own code. Send a video and a style over HTTP and get the captioned video back.
Claude and ChatGPT: from a chat, through the tscaps MCP server. Connect tscaps to the app, ask for captions, and drop your video.

Both run on your tscaps account and use its automation minutes.

Automation API

For developers. Generate videos with burned-in, word-by-word animated captions from your product, backend, or automated workflows. Rendering runs on our servers, with the same engine as the tscaps editor.

Introduction & Quickstart

Get your first video in under five minutes: authenticate, queue a job, follow its progress, and download the finished MP4.

API reference

Every endpoint (POST /v1/automation-jobs, GET /v1/automation-jobs/:id, POST /v1/automation-jobs/:id/cancel, POST /v1/automation-jobs/uploads, GET /v1/automation-jobs), its parameters, frame budgets, and failure codes.

Direct file uploads

Upload video files to tscaps through presigned URLs when they are stored locally, behind authentication, or uploaded by your users.

Webhooks

Get an HTTP event as soon as a video finishes. Includes Standard Webhooks HMAC-SHA256 signature verification in JavaScript and Python.

Limits & quotas

Video length, resolution (720p or 1080p), concurrent jobs, and automation minutes on the Free, Starter, Pro and Business plans.

Your account

API keys: create, view, and revoke secret API keys.
Automation minutes: check your balance and buy minute packs that do not expire.
Usage & history: active and past jobs, with their statuses and logs.
Templates catalog: every built-in caption style and the templates saved to your account.
Webhooks signing secret: view and rotate your webhook signing secret.

Building with AI coding agents

Give your coding assistant (Cursor, Claude Code, GitHub Copilot, Windsurf…) the whole API, or install the official skill:

llms-full.txt: every guide and endpoint in one markdown file.
llms.txt: the documentation index, per llmstxt.org.
Agent Skill (tscaps-api): install with npx skills add francozanardi/tscaps --skill tscaps-api, or read SKILL.md on GitHub.

Claude and ChatGPT

For captioning from a chat, no code involved. Tscaps is a remote MCP server (https://api.tscaps.io/v1/mcp) that you add to Claude or ChatGPT as a custom connector, and a captioner opens right in the conversation.

Use tscaps in Claude and ChatGPT

Add the connector, caption a video, and see what it costs in minutes, what happens to your video, and how to disconnect.