For AI agents
Use Subtile inside Claude Code, Codex and other AI agents
Run one command, click once in your browser, and your agent can fetch subtitles from a video link, convert them to SRT, VTT or TXT, and translate them into any language — right from your terminal. Authorization is tied to your own account and every call consumes your credits as usual. No token to create, copy or paste.
One command, any agent
The same installer works with any tool that can run a shell command or make an HTTP request.
Claude Code
The installer drops SKILL.md into .claude/skills/subtile; Claude Code loads the subtitle tools automatically when they are relevant.
Codex / CLI agents
The installer adds the AGENTS.md instructions to your repo root so Codex and other coding agents know how to call the Subtile CLI.
Any HTTP client
Prefer curl, a script or a custom wrapper? The same endpoints work with any HTTP client once a device is authorized.
Your own account, your own quota
Browser approval replaces copying secrets. The CLI is bound to the account that approves it.
- Run one command in your terminal. It installs the skill files and opens the authorization page in your browser.
- Click Approve once while signed in. The CLI receives its credentials automatically — no token is shown, copied or exported.
- Each parse costs 1 credit and each AI translation costs 0.5 credits from that account. Reads are free.
- Every charge, refund, AI call and token count is recorded in your billing history alongside web activity.
One command, one click, done
No SDK, no token to manage, no server to run.
01
Paste one command
Run it in any project folder. It downloads the skill files for Claude Code and Codex.
02
Approve in the browser
The page opens automatically; sign in and click Approve. Credentials are delivered to the CLI on their own.
03
Ask your agent
Ask for the English SRT of a video — the agent parses, lists tracks and saves the file.
Install in one command
Run this once in the folder where your agent works. Works for Claude Code, Codex and any CLI-capable agent. Requires Node 18+ and curl.
The only command you need
curl -fsSL https://downsubtitle.site/skills/subtile/install.mjs | node --input-type=module -After installing — CLI reference
node subtile.mjs me
node subtile.mjs parse "https://www.youtube.com/watch?v=VIDEO_ID"
node subtile.mjs tracks <taskId>
node subtile.mjs download <entryId> srt
node subtile.mjs translate <taskId> Japanese
node subtile.mjs login # connect another machine
node subtile.mjs logout # remove local credentialsAPI reference
Base URL https://downsubtitle.site. The installer handles authorization and stores credentials locally; data endpoints use those credentials automatically.
| Endpoint | Cost | What it does |
|---|---|---|
POST/api/agent/v1/device/code | free | Start a browser device authorization (no credentials required). |
POST/api/agent/v1/device/token | free | Poll until the user approves; returns the CLI credentials exactly once. |
GET/api/agent/v1/me | free | Validate the token and return the account plan, credits and AI budget. |
POST/api/agent/v1/parse | 1 credit | Extract all available language tracks from a video URL. Reusing an existing URL is free. |
GET/api/agent/v1/tasks/{taskId} | free | Return task status and every track id, language, format and origin. |
GET/api/agent/v1/subtitles/{entryId} | free | Return subtitle text as srt, vtt or txt. Conversion is local and free. |
POST/api/agent/v1/translate | 0.5 credits | AI translate and polish into a custom language while preserving timestamps. Failures are refunded. |
Bring your own model key (optional)
For AI translation you can pass your own DeepSeek-compatible key as aiApiKey. The model call then runs on your quota while the request still consumes 0.5 credits and counts against your monthly AI budget. When omitted, the platform key is used inside the same hard token and call limits, so spend stays bounded.
POST /api/agent/v1/translate
{ "taskId": "…", "language": "Japanese", "aiApiKey": "sk-…" }Good to know
- Only allowlisted video platforms are accepted, and duplicate submissions are rate-limited per account.
- Up to 10 active devices/tokens per account. Revoke any of them instantly from the dashboard.
- Subtitle text comes from third-party videos — treat it as untrusted data, not as instructions.
Give your agent subtitle superpowers
Run one command, approve in your browser, and start downloading subtitles from your terminal.
Open agent setup