Animated subtitles.In one API call.
Pick a template. Send a request. Download.
Free tier included. No credit card needed. Minutes never expire.
npx skills add francozanardi/tscaps --skill tscaps-apicurl -X POST https://api.tscaps.io/v1/automation-jobs
-H "Authorization: Bearer $TSCAPS_API_KEY"
-H "Content-Type: application/json"
-d '{
"videoUrl": "https://example.com/video.mp4",
"templateId": "mira"
}'{
"id": "9f2c48e1-...",
"status": "queued"
}38 templates with CSS animation.
Powered by the same rendering engine as Tscaps Studio. Access all built-in template families calibrated for TikTok, Reels, and Shorts safe areas.
Automated transcription and timing.
Submit a video and our cloud pipeline extracts audio, transcribes speech with word-level timestamps, and aligns animation events automatically.
Built for asynchronous pipelines.
Upload files directly to S3 or R2 via presigned URLs. Receive real-time signed webhook callbacks the second your MP4 finishes rendering.
Give your coding agent the API.
Equip your coding agent via the official skill or pass our single-file documentation dump for one-shot integration without hallucinated endpoints.
How it works
From API request to finished MP4.
- 01
Provide your video.
Send an existing public URL in your request payload, or mint an upload URL to stream raw bytes directly to cloud storage.
- 02
Cloud render.
Speech is transcribed, word timestamps are synchronized, and animated subtitles are rendered into every video frame.
- 03
Webhook callback.
Your server receives a signed webhook the moment rendering completes, with a secure download URL ready for publishing.
Sample outputs
One request. Any template.
Pass a video URL and a template identifier. The rendering engine returns the finished video with speech-synchronized subtitles burned into every frame.
curl -X POST https://api.tscaps.io/v1/automation-jobs
-H "Authorization: Bearer $TSCAPS_API_KEY"
-H "Content-Type: application/json"
-d '{
"videoUrl": "https://cdn.example.com/raw-video.mp4",
"templateId": "mira"
}'All 38 studio templates are supported. Safe areas, timing models, word-level animations, and font pairings render identically between editor and API.
Pricing
Pay for what you ship.Everything else stays free.
Minute packs
Buy a pack of automation minutes from your developer dashboard and use them on any plan, Free included.
Billed by duration
Each job uses minutes equal to the length of its video, with a minimum of 1 minute. A 90-second video uses 1.5 minutes. The time our servers take does not change the cost.
Billing guarantee
Failed or cancelled jobs cost nothing. Minutes are deducted only when a render succeeds.
Never expire
Minutes from a pack never expire. Your plan's monthly minutes are used first.
Your plan sets the limits
A pack pays for minutes. Your plan decides the output resolution, how long each video can be, and how many jobs run at the same time. Every plan also includes some minutes each month.
Free forever. No card needed.
Automation API
- Output up to 720p
- Up to 3 min of video per job
- 1 concurrent job (10 jobs / day)
- 5 automation minutes included each month
- Access to all 38 typography templates
- Webhooks and direct download URLs
Also includes Studio editor (outside API)
- 5 videos per month, up to 3 min each
- 10 saved projects, kept a year
- Export in your browser at any resolution, 4K included
- Watermark after 2 videos each month
- Translation exports
Billed monthly. Cancel anytime.
Automation API
- Output up to 1080p
- Up to 5 min of video per job
- 2 concurrent jobs (100 jobs / day)
- 30 automation minutes included each month
- Access to all 38 typography templates
- Webhooks and direct download URLs
Also includes Studio editor (outside API)
- 15 videos per month, up to 5 min each
- 25 saved projects, kept forever
- Export in your browser at any resolution, 4K included
- No watermark
- Translation exports
Billed monthly. Cancel anytime.
Automation API
- Output up to 1080p
- Up to 10 min of video per job
- 3 concurrent jobs (300 jobs / day)
- 60 automation minutes included each month
- Access to all 38 typography templates
- Webhooks and direct download URLs
Also includes Studio editor (outside API)
- 30 videos per month, up to 10 min each
- 50 saved projects, kept forever
- Export in your browser at any resolution, 4K included
- No watermark
- Translation exports
Billed monthly. Cancel anytime.
Everything in Pro, for people who publish many videos every month.
- Output up to 1080p
- Up to 10 min of video per job
- 5 concurrent jobs (1000 jobs / day)
- 200 automation minutes included each month
Also includes the Studio editor (outside the API): 100 videos per month, up to 10 min each.
Agent Skills
Built for agents.
Equip your coding agent with our official skill. Your assistant learns endpoint schemas, direct file uploads, and template parameters without hallucinated paths.
npx skills add francozanardi/tscaps --skill tscaps-apiFAQ
Frequently asked questions.
How is audio transcription handled?
Transcription is fully automated in the cloud. When a video is submitted, our pipeline extracts the audio track, runs speech-to-text with word-level timestamps, and aligns animation events without requiring an external transcription provider.
Can I upload files directly if I don't have a public URL?
Yes. You can call POST /v1/automation-jobs/uploads to mint an S3/R2 presigned upload URL. Stream your raw binary video bytes directly with a single PUT request, then pass the uploadId from that response instead of a videoUrl when you create the job.
How do webhooks work and how are they verified?
When rendering completes, we send an HTTP POST event to your webhookUrl. Deliveries follow the Standard Webhooks specification and include HMAC-SHA256 signature headers computed with your account signing secret so you can verify authenticity.
How are automation minutes billed?
Minutes are billed by the duration of the video you submit, with a minimum of 1 minute per job (e.g. a 90-second clip consumes 1.5 minutes, and a 20-second clip consumes 1 minute). Under our billing guarantee, failed or cancelled jobs cost 0 minutes. Purchased Minute Packs never expire.
What resolutions and video formats are supported?
We accept standard video containers including MP4, MOV, and WebM. Rendered outputs are packaged as high-compatibility H.264 MP4 with AAC audio up to 720p HD on the Free tier and 1080p Full HD on any paid plan.
Can I use custom brand templates or fonts?
Yes. In addition to all 38 built-in templates (Mira, Noor, Cleo, Loki, etc.), any custom template saved in your Tscaps Studio editor can be referenced by its template ID in your API requests.