Make subtitle files
Get a word-timed .srt or .vtt for a video or audio file the account holds, up to 20 minutes, free.
Every word is timed by the same ear the video editor cuts by, then cut into cues of at most two 42-character lines and six seconds, breaking at sentence ends. Pass names to spell the brand your way. The file text comes back inline and is filed in the library; for captions burned into the picture, edit the video instead.
Ask in plain words
- "make an srt for this video"
- "subtitle file API"
- "generate vtt captions for my podcast clip"
From an agent host (MCP)
Server: https://shapelessai.com/mcp (add it to your host).
caption_file: Transcribe a video or audio file in the media library (up to 20 minutes) into a word-timed .srt or .vtt. Filed next to the source; the text also comes back inline. Free: nothing is charged. Needs the write scope.
From code (REST)
Bearer API key with the scope each call names (auth, OpenAPI).
POST /api/captions(write scope): Subtitle file (tool caption_file): {media_key, format? (srt|vtt, default srt), names? ("ShapelessAI, shapelessai.com")}. Output: captionsKey plus the file text inline. Free.
The body
media_keystring, required: The video or audio in your library, e.g. from an upload.formatstring (srt,vtt): Default srt.namesstring: Brand and product names to spell your way, comma-separated: "ShapelessAI, shapelessai.com".budgetUsdnumber: The most this call may spend, in USD (default 2, max 10). Held while the tool runs, released after.
From a terminal (CLI)
shapeless tools run caption_file --input '<json>'(tools show caption_fileprints the schema)
Example
Refusals
| Status | Meaning |
|---|---|
| 400 | The input does not match the tool's schema; the message names the field. |
| 402 | Not enough credit to hold budgetUsd, or the call costs more than budgetUsd. |
| 404 | No such tool on this deployment. |
| 422 | The tool refused this input; nothing was charged. |
| 502 | The tool failed; nothing was charged. |
Where else
More in Media
Generate an image · Generate AI video · Edit a video · Record a product demo · Render a carousel · Render a thumbnail · Turn text into speech · Call any agent tool
