在沉浸式翻译中使用 BeatAPI

沉浸式翻译可以把网页、PDF 与视频字幕渲染成双语对照。它支持任意 OpenAI 兼容端点作为自定义翻译服务，所以 BeatAPI 可以直接驱动它。

准备工作

1. 已安装插件 —— 从 Chrome 应用商店、Edge 扩展、Firefox 附加组件或官网安装。
2. 一把 BeatAPI 密钥 —— 在控制台 → API 密钥创建。

第一步：打开设置

点浏览器工具栏中的沉浸式翻译图标，再点弹窗左下角的设置，然后在左侧菜单选择翻译服务。

第二步：添加为自定义服务

点列表顶部的 + 添加自定义翻译服务，填写：

保存后回到插件弹窗，在翻译服务下拉里选择 BeatAPI。

第三步：开始翻译

• 整页翻译 —— 点插件图标选择翻译，或按 Alt+A。
• PDF 翻译 —— 在浏览器中打开在线 PDF 后按 Alt+A。本地文件需要先在网页阅读器中打开。
• 视频字幕 —— 在支持的平台播放视频，双语字幕会自动出现。
• 划词翻译 —— 选中文本后使用划词面板，默认快捷键 Alt+W。

怎么选模型

翻译是大多数人会跑的量最大、最重复的任务。整页翻译会拆成很多小请求，所以在这里选模型对账单的影响比在别处都大。

完整目录见文本 API 各页与价目页。

常见问题

配置完不翻译

1. 确认插件弹窗的翻译服务下拉里选中的是 BeatAPI，光在设置里保存不算。
2. 接口地址必须是完整路径 https://api.beatapi.io/v1/chat/completions。
3. 在控制台 → API 密钥确认密钥仍然可用。
4. 模型编号区分大小写。

翻译很慢或超时

先把每秒最大请求数降到 3。一个页面会扇出很多并发请求，卡住的通常是请求频率而不是模型。然后再换成更快的档位，例如 glm-5.3-flash 或 gemini-3.7-flash。

429 rate_limit_exceeded

和上一条同源，只是更进一步。先降每秒请求数；账户的每分钟额度随累计充值提升，当前值在控制台可见。

翻译质量不理想

换到更高档位 —— 散文用 claude-sonnet-5，技术文档用 gpt-5.6-terra —— 并把「AI 专家」风格调成与内容匹配。对反复出现的专业术语，请配置插件的术语表，这能解决换更大模型也解决不了的一致性问题。

402 insufficient_credits

余额已用尽，在控制台充值。

怎么看它花了多少

给插件单独发一把 BeatAPI 密钥。浏览会产生大量零碎小请求，用独立密钥就能在 GET /v1/usage 的 by_api_key 和控制台里，把它和应用流量分开看。

获取支持

在控制台提交工单，并附上失败响应里的 request_id。