沉浸式翻译 API 配置:自定义 AI 翻译源完整教程

先给结论:五步配好沉浸式翻译自定义模型

kkaiapi 是面向中文开发者的 OpenAI 兼容模型中转,一个 Key 可同时调用 DeepSeek、GLM、Kimi、Claude、GPT 等模型,支付宝或微信充值,按量计费,没有订阅。翻译是高频小请求场景:译文质量按 AI 模型走,账单按便宜模型的 token 价格走。还没有 Key 的话,先到充值页开通,再在控制台生成令牌。

• 第一步:点浏览器工具栏的沉浸式翻译图标,进入 设置,打开 翻译服务 列表
• 第二步:选择 OpenAI 服务,APIKEY 一栏粘贴 kkaiapi 控制台生成的 sk- 开头的 Key
• 第三步:模型下拉选到 自定义模型,填入 deepseek-v4-flash
• 第四步:展开更多自定义选项,把 自定义 API 接口地址 改成 https://api.kkaiapi.com/v1/chat/completions
• 第五步:点 点此测试服务,显示成功后回到网页,用快捷键或悬浮球触发整页双语翻译

关键字段填法:接口地址必须是完整端点

沉浸式翻译和 Cherry Studio、LobeChat 这类客户端最大的不同是:它的 自定义 API 接口地址 要填完整端点,也就是带 /v1/chat/completions 的整条 URL,只填域名或只填到 /v1 都会请求失败。这是配置失败的第一大原因。 模型名必须逐字符一致。当前可用模型 ID:deepseek-v4-flash、deepseek-v4-pro、glm-5、kimi-k2.6、claude-sonnet-4-6、claude-opus-4-7、gpt-5.5、grok-4.5。把 claude-sonnet-4-6 写成 claude-sonnet-4.6 就会报模型不存在。填完先用下面的 curl 在插件外验证一次,能把 Key 问题和插件配置问题分开排查。

翻译服务: OpenAI
APIKEY: sk-你的密钥
模型: 自定义模型 -> deepseek-v4-flash
自定义 API 接口地址: https://api.kkaiapi.com/v1/chat/completions
每秒最大请求数: 5
每次请求最大段落数: 3

curl https://api.kkaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4-flash", "messages": [{"role": "user", "content": "把这句话翻译成中文: Hello world"}]}'

便宜模型推荐:DeepSeek Flash 每月几块钱的账

网页翻译对模型的要求是快、稳、便宜,不需要深度推理。deepseek-v4-flash 是这个场景的默认答案:译文比传统机翻自然得多,速度快,价格是全站最低档。专业文档或文学性内容想要更讲究的译文,可以切 glm-5 或 claude-sonnet-4-6,同一个 Key 改一下模型名就行。价格全文只列这一次:

算一笔月账,以及为什么不选按次计费

英文技术文章一页正文约 3000 tokens,中文译文输出约 2000 tokens。每天翻 50 页,一个月输入约 4.5M tokens、输出约 3M tokens,按上表 deepseek-v4-flash 的价格算,月成本五块多。阅读量翻倍也就十来块,不用的月份零支出。 反面案例是按次计费的模型。整页翻译会被插件切成几十个分段请求,按次计费会迅速放大成本。翻译只选按 token 计费的模型,优先选输入输出单价都低的那一档。

每秒请求数与分段并发调优

沉浸式翻译把整页文本切成分段,并发发给翻译服务,两个参数决定体验:每秒最大请求数控制并发节奏,每次请求最大段落数控制单次请求打包几段原文。 调优思路:段落数适当调大,一次请求带上前后几段,术语和人称的前后一致性明显更好,请求总数也更少;但调太大容易触发单次输出截断,失败重试的代价也更高。每秒请求数从 5 起步,翻译顺畅就不动,遇到 429 就往下调。换到 claude-sonnet-4-6 这类旗舰模型时,每秒请求数降到 2 到 3,单请求响应慢,并发太高反而更卡。

常见问题