Make subtitle files

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).

• tools_run with { "name": "caption_file", "input": { ... } }: the input is the REST body below; tools_list prints its JSON Schema.

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.

From a terminal (CLI)#

• shapeless tools run caption_file --input '<json>' (tools show caption_file prints the schema)

Example#

curl -s https://shapelessai.com/api/captions -H "Authorization: Bearer $SHAPELESS_API_KEY" -H "Content-Type: application/json" -d '{"media_key":"<mediaKey>","format":"srt","names":["Shapeless"]}'

Refusals#

Where else#

• The api docs (markdown)