Wyzie Subs

Intro to Wyzie Subs#

Wyzie Subs is a subtitle API with a free tier. Use the NPM package if you work in TypeScript or JavaScript. Otherwise, call the API directly.

Every request needs an API key. Get a free key at sub.wyzie.io/redeem: verify your email and get 1,000 requests a day. For more, see the Pro and top-up plans. The API Keys page has the details.

What Else Wyzie Subs Does#

The API does more than search and download:

  • Wyzie Synced: line a subtitle up to your video from a speech timestamp list or the audio itself, up to a whole 4K file (Pro, 60 requests).
  • Download options: a second language under each line with dual=<lang>, or per-request offset, fps, plain, sdh and clean. See Direct Fetching.
  • AI Translation: get any subtitle in 90+ languages on demand. 1 request on any key, free keys included, the same as a download.
  • Status API: uptime and per-provider health as JSON, for your own status page or monitoring.
  • Wyzie Transcribe: make subtitles for any audio or video, such as podcasts, YouTube videos and lectures, with speech recognition (Pro, 85 requests per started minute of audio). You can label speakers, translate the result or send up to 50 files at once.
  • Fix Subtitles: correct wrong words, re-time and add missing lines of a subtitle by listening to the video (Pro, 85 requests per started minute of audio).
  • Search by Quote: remember a line but not the title? Find the movie or episode it is said in (free on a free key, 1 request on Pro).
  • Best match: send the video's file name and hash with a search. The subtitle for that exact file comes first, with a match score.
  • Webhooks for Transcribe, Fix Subtitles and bulk jobs, and browser-safe keys you can use in a web page.
  • Extract Subtitles: pull the subtitle tracks out of an MKV or MP4 you already have (1 request per track, any key).
  • Batch search for up to 50 titles in one call, and Usage and Balance for your balance, a breakdown and a low-balance webhook.
  • Clients and Tools: Python, Go and an MCP server, an OpenAPI description, and a live API Playground.
  • Wyzie Censored: bleep, mute or cover chosen words in a video, or live while it plays (Pro, 95 requests per started minute for a file, 1 live).

A download costs 1 request, and a search costs 1 request per source it runs (1 by default). API Keys lists the price of every other call and the free and Pro limits.

Protecting Your API Key#

Real incident: developers pasted their key into a streaming site's frontend JavaScript. Within hours, someone else copied it from the JS bundle and used it until the daily limit or paid balance ran out. We do not refund quota lost this way. Under our Terms, the key owner is responsible.

Keep your API key private. It must never appear in:

  • Browser JavaScript (anything served to a script tag)
  • Mobile app binaries (Android/iOS, including obfuscated ones)
  • Browser extensions
  • Electron / desktop apps distributed to end users
  • Public Git repositories, gists, paste sites, or screenshots

If the key reaches a user's device, it is public. Use one of these two safe setups:

Option 1: Use Wyzie Worker#

Wyzie Worker is a small Cloudflare Worker proxy that adds your API key on the server. Deploy it to Cloudflare Workers and set two secrets: NITRO_API_TOKEN (your Wyzie API key) and NITRO_WORKER_KEY (a secret you choose). Every request to the worker must send Authorization: Bearer <NITRO_WORKER_KEY>. Without it, the worker answers 401. If NITRO_WORKER_KEY is not set, it answers 503 to every request. Keep the worker key on the server too: call the worker from your own backend, never from browser or app code. The worker forwards each request to sub.wyzie.io with your API key.

Your backend → your-worker.workers.dev/search?id=286217
               Authorization: Bearer <NITRO_WORKER_KEY>
Worker       → sub.wyzie.io/search?id=286217&key=<NITRO_API_TOKEN>

Option 2: Build Your Own Proxy#

You can also write a small proxy in any server framework. Your backend gets the request from your client, adds the API key and forwards it to sub.wyzie.io.

// Example: a simple proxy endpoint
const API_KEY = process.env.WYZIE_API_KEY;
 
app.get('/subtitles', async (req, res) => {
  const params = new URLSearchParams(req.query);
  params.set('key', API_KEY);
  const response = await fetch(`https://sub.wyzie.io/search?${params}`);
  res.json(await response.json());
});