Use your own key

用你自己的 Key

The extension works with no setup at all. This page is only for people who want a better translation than the free engine gives — you bring an API key, the extension uses it, and nobody sits in between.

扩展本身开箱即用，什么都不用配。这一页是给想要比免费引擎更好的译文的人看的——你自备一个 API Key，扩展直接用它，中间没有任何人经手。

🧭

Three things before you start

开始之前，先说三件事

1. What it costs

1. 花多少钱

You pay the provider directly for what you use — the extension takes no cut and has no server. Subtitles are short, so a video costs very little, but it is not free by default: check the provider's own pricing page before you rely on it. All three providers below have a free tier — though signup rules and card requirements vary by region — and their limits change often enough that we link to the source instead of copying numbers here.

你按用量直接付给服务商——扩展不抽成、也没有服务器。字幕文本很短，一个视频的花费很小，但默认并不是免费的：依赖它之前先看服务商自己的定价页。下面三家都有免费额度——但注册规则和是否要绑卡因地区而异——而额度和限速变动频繁，所以这里只给出处、不抄数字。

2. Network and region

2. 网络与区域

An API only works if your browser can reach it. Chinese endpoints can be slow or flaky from outside mainland China; Google's Gemini API is not available in every region. If a key tests fine one minute and fails the next, this is usually why — the extension retries a dropped connection once and then tells you.

接口能不能用，取决于你的浏览器能不能连上它。国内的接口从境外访问可能慢或不稳；Google Gemini 的接口在部分地区不可用。如果 Key 刚才测通、过一会儿又失败，通常就是这个原因——扩展会对掉线自动重试一次，再失败才提示你。

3. Is my key safe?

3. Key 安全吗

The key is stored in this browser on this computer only (chrome.storage.local). It is never synced to your Google account and never sent anywhere except the provider you picked, as the authorization header of the translation request. You can wipe it any time with Clear next to the key field, and “Reset all settings” wipes it too. Treat a key like a wallet anyway: don't paste it into random websites, and revoke it in the provider's console if you ever suspect it leaked.

Key 只保存在这台电脑的这个浏览器里（chrome.storage.local）。它不会同步到你的 Google 账号，也不会发往除你所选服务商之外的任何地方——只作为翻译请求的认证头。随时可以用 Key 输入框旁边的「清除」删掉，「重置全部设置」也会一并清掉。不过还是把 Key 当钱包看：别往来路不明的网站里粘，一旦怀疑泄露就去服务商后台吊销。

⚡

The whole thing in three steps

整个流程就三步

  1. Open the extension popup → set Engine to Your own key → click Configure….
  2. 打开扩展弹窗 → 把「翻译引擎」切到「自带 Key」 → 点「配置…」。
  3. Pick a provider in the list, paste your API key, leave the model on the recommended one. Want a different one? Hit List models with my key and choose from what your key can actually reach — the list comes from the provider, so it is never out of date.
  4. 在列表里选一个服务商，粘贴你的 API Key，模型保持推荐值即可。想换别的？点「用我的 Key 拉取模型」，从你这把 Key 真正能用的模型里挑——列表是服务商现给的，不会过期。
  5. Click Save and test. Chrome asks once for permission to reach that provider's domain — allow it, and you should see “Connected”.
  6. 点「保存并测通」。Chrome 会问一次是否允许访问该服务商的域名——同意后应该看到「连接成功」。
Why the permission prompt?为什么会弹权限？ The extension ships with no access to any AI provider. It asks for one domain, only when you choose that provider — so an unused provider can never be contacted. 扩展默认对所有 AI 服务商都没有访问权限。只有你选中某一家时，它才申请那一个域名——没用到的服务商永远联系不上。

Alibaba Cloud Model Studio (Qwen / DeepSeek)Alibaba 百炼 (Qwen / DeepSeek)

Tested已实测

Best pick inside mainland China, and the fastest of the three in our measurements. One key gives you both the Qwen models and DeepSeek models hosted there.

中国大陆首选，也是我们实测里最快的一家。一把 Key 同时能用平台上的通义千问系列和 DeepSeek 系列模型。

Console控制台 Models & pricing模型与资费
  1. Sign in to the Alibaba Cloud Model Studio (Bailian) console with your Alibaba Cloud account, and activate the model service if it asks you to.
  2. 用阿里云账号登录百炼控制台，如果提示需要开通模型服务，先开通。
  3. In the console sidebar open System tools → API-KEY and create a key. (The link above goes straight there; console layouts do get reshuffled, so trust the link over the menu names.)
  4. 在控制台左侧栏打开「系统工具 → API-KEY」，创建一把 Key。（上面的链接直达该页；控制台偶尔改版，菜单名不对就以链接为准。）
  5. Copy the key — it starts with sk-. Paste it into the extension and press Save and test.
  6. 复制这把 Key（以 sk- 开头），粘贴进扩展，点「保存并测通」。
  • Recommended model: qwen-flash — the default, and by far the quickest we measured. deepseek-v4-flash also works well if you prefer DeepSeek's wording.
  • 推荐模型：qwen-flash——默认值，也是我们实测最快的。想要 DeepSeek 的语感就填 deepseek-v4-flash，一样能用。
  • Keep the default endpoint. A workspace-scoped key (one that starts sk-ws-) works fine on the standard endpoint, so you do not need the workspace-specific host — and the standard one proved more reliable in testing.
  • 接口地址保持默认。工作空间级的 Key（以 sk-ws- 开头）在标准接口上照样能用，不需要填工作空间专属域名——而且实测标准接口更稳。
  • Avoid “thinking” models for subtitles: they spend most of their time reasoning. The extension already turns that off for this provider where the API allows it.
  • 字幕别用推理（thinking）类模型，它们大部分时间花在思考上。这一家的接口支持关闭思考，扩展已经自动帮你关了。

Google Gemini

Tested已实测

Easiest key to obtain — a couple of clicks in Google AI Studio, no separate billing setup to get started.

最容易拿到 Key 的一家——在 Google AI Studio 点两下就有，开始用不需要另外配置付费。

Get a key去申请 Key Pricing & free tier资费与免费额度
  1. Open Google AI Studio and go to the API Keys page.
  2. 打开 Google AI Studio，进入 API Keys 页面。
  3. Click Create API key and copy the value.
  4. 点 Create API key，复制生成的值。
  5. Paste it into the extension and press Save and test.
  6. 粘贴进扩展，点「保存并测通」。
  • Recommended model: gemini-flash-latest — the default. Do not pin a specific version: we found gemini-2.0-flash already answering “quota exceeded” on free keys, which looks exactly like a broken extension.
  • 推荐模型：gemini-flash-latest——默认值。别把版本号钉死：我们实测 gemini-2.0-flash 在免费 Key 上已经直接返回「额度用尽」，看起来就像插件坏了。
  • Not available in every country. If the test fails with a network error while other sites work, this is the likely reason.
  • 并非所有国家/地区都能访问。如果别的网站都正常、只有测通报网络错误，大概就是这个原因。

DeepL

Tested已实测

Not a chat model — a dedicated translator. Wording is conservative and consistent, which many people prefer for subtitles. It also gets the per-line alignment right, because its API accepts the surrounding sentence as context.

它不是聊天模型，而是专业翻译引擎。用词稳、前后一致，很多人就喜欢这种字幕。它也能做到逐行对齐，因为它的接口支持把整句作为上下文传进去。

DeepL API plansDeepL API 方案 Pricing资费
  1. Sign up for a DeepL API plan — the Free one is enough. Note this is the API product, not the website translator or the desktop app.
  2. 注册 DeepL API 方案，Free 版就够。注意要的是 API 产品，不是网页翻译或桌面客户端。
  3. In your DeepL account page, open the section for API keys and copy the authentication key.
  4. 在 DeepL 账户页面里找到 API 密钥那一节，复制认证密钥。
  5. Paste it into the extension and press Save and test. There is no model to choose for DeepL.
  6. 粘贴进扩展，点「保存并测通」。DeepL 不需要选模型。
  • The single most common mistake: a DeepL Pro subscription (website / apps) is a different product from a DeepL API account, and the key you see in a Pro account does not work here. A 401/403 almost always means this.
  • 最常见的错就这一条：DeepL Pro（网页版／客户端订阅）和 DeepL API 是两种不同的产品，Pro 账户里看到的密钥在这里用不了。报 401/403 基本都是这个原因。
  • A key ending in :fx is a Free-plan key. The extension reads that suffix and talks to the right endpoint automatically — you never pick one.
  • 以 :fx 结尾的是 Free 版 Key。扩展会读这个后缀自动选对应的接口地址——你不用管。
  • Signing up needs a card. The API Free plan (about 500,000 characters a month) still asks for a VISA/Mastercard issued in a region DeepL supports — cards issued in mainland China are generally not accepted, which is why many users here end up on an LLM instead.
  • 注册要绑卡。API Free 方案（每月约 50 万字符）仍然需要一张 DeepL 支持地区发行的 VISA／Mastercard——中国大陆发行的卡普遍不被接受，所以国内用户往往最后选大模型那条路。
  • DeepL covers every language this extension offers. If that ever changes, you get a clear message asking you to change the language or the engine, and nothing is sent.
  • DeepL 支持的目标语言比大模型少。遇到不支持的语言，扩展会直接提示你换语言或换引擎，请求不会发出去。
🧩

The other providers

其他服务商

Endpoint checked, no key on hand接口已核，无 Key 实测

Every endpoint below was probed and answered — the host and path are right. What we could not check without a key is the model name and whether the provider lets a browser extension call it directly. So don't guess a model: press List models with my key in the settings page and pick from what your own account returns.

下面每一家的接口我们都探过、都有响应——域名和路径是对的。没有 Key 就无法验证的是模型名，以及服务商是否允许浏览器扩展直连。所以别猜模型名：在设置页点「用我的 Key 拉取模型」，从你自己账号返回的列表里选。

Provider服务商 Get a key拿 Key Notes备注
OpenAI API keys · pricing资费 Model line moves fast — fetch the list rather than typing a name.模型更新很快——用「拉取模型」而不是手打名字。
DeepSeek API keys · pricing资费 DeepSeek's own platform. Also reachable through Alibaba Cloud Model Studio above.DeepSeek 官方平台。上面的百炼也能用到它的模型。
Anthropic Claude API keys · pricing资费 Its OpenAI-compatible endpoint is live, but Anthropic blocks browser-originated calls by default. The extension sends the documented opt-in header; whether that is enough from an extension is unverified.它的 OpenAI 兼容接口确认存在，但 Anthropic 默认拦截浏览器发起的调用。扩展已带上官方文档里的放行请求头，但从扩展里是否够用未经验证。
xAI Grok Console · pricing资费 OpenAI-compatible API.OpenAI 兼容接口。
Kimi (Moonshot) API keys · pricing资费 The console moved to kimi.com; the API host is still the moonshot.cn one filled in here.控制台已迁到 kimi.com，但接口主机仍是这里预填的 moonshot.cn。
Zhipu GLM智谱 GLM API keys · pricing资费 Mainland China endpoint.国内接口。
Doubao (Volcano Ark)豆包（火山方舟） Ark console控制台 · pricing资费 Takes an endpoint id (ep-…) in the model field, not a public model name.模型栏要填接入点 ID（ep-…），不是公开模型名。
SiliconFlow API keys · pricing资费 Hosts many open models; names are long — fetch the list.托管很多开源模型，名字都很长——用「拉取模型」。
OpenRouter Keys · pricing资费 One key, many vendors. Model names look like vendor/model — its catalogue is public, so the model list loads reliably.一把 Key 通多家。模型名形如 vendor/model——它的模型目录是公开的，所以「拉取模型」很稳。
🔧

When it doesn't work

出问题了怎么办

The extension tries to name the actual problem instead of just failing. Here is what each message means.

扩展会尽量说出到底哪里出了问题，而不是只报个失败。下面是每种提示的含义。

Message提示 What to do怎么办
Key was rejected (401/403)Key 被拒绝（401/403） Re-copy the whole key (a trailing space or a missing character is the usual cause), and check the key is active and the service is enabled on that account.重新完整复制一遍 Key（多一个空格、少一个字符是最常见原因），并确认该 Key 有效、账号已开通对应服务。
Model name or base URL may be wrong模型名或接口地址可能不对 Use “List models with my key” and pick from the list. For a custom endpoint, both a base URL and a full endpoint URL are accepted.点「用我的 Key 拉取模型」从列表里选。自定义接口地址时，填 Base URL 或完整接口地址都可以。
Only chain-of-thought, no translation只输出了思考过程，没给译文 You picked a reasoning model. Switch to a normal “flash”/“turbo” style model.你选到了推理模型。换成普通的 flash／turbo 一类模型。
Rate-limited / out of quota被限流／额度用完 The extension slows down and retries by itself; already-translated lines keep working. If the quota is gone for the period, top up or switch engine.扩展会自动放慢并重试，已翻译的句子不受影响。如果是本期额度用尽，充值或换引擎。
Cannot reach that endpoint连不上这个接口 Network or regional restriction. Try again, try another provider, or use the free engine.网络或区域限制。稍后重试、换一家，或先用免费引擎。
Not authorized to reach that domain没有授权访问这个域名 The permission prompt was dismissed. Press Save and test again and allow it.权限弹窗被关掉了。再点一次「保存并测通」并允许。
Still stuck? Tell us还是不行？告诉我们 General FAQ常见问题