# 给沉浸式翻译换一个更省的翻译引擎

> https://router.one/zh/integrations/immersive-translate 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-08-16

沉浸式翻译是最流行的双语对照翻译扩展——网页、PDF、电子书、字幕，边读边译。翻译是持续烧 token 的场景：每开一页都在花钱，模型单价在这里比任何场景都敏感。它的自定义 OpenAI 兼容接口只要一个地址和一个 Key：指向 Router One 后，目录里任意对话模型随便换——大陆直连、无需代理，按量计费，部分模型最低官方价 1 折，每次翻译请求都有成本 trace，读了多少、花了多少一目了然。

## 把 Immersive Translate 配置到 Router One base URL

打开沉浸式翻译 设置 → 翻译服务 → OpenAI，把 API Key 切换为「自定义 API Key」，展开更多自定义选项，填「自定义 API 接口地址」——注意要填含 /chat/completions 的完整路径，不是只填 base URL——再把「自定义模型」填成 /models 页的模型 ID：

`immersive-translate-settings`

```bash
# Immersive Translate → Settings → Translation Services → OpenAI
# 沉浸式翻译 → 设置 → 翻译服务 → OpenAI
API Key type（API Key 类型）:  Custom API Key（自定义 API Key）
APIKEY:  sk-your-router-one-key
Custom endpoint（自定义 API 接口地址，须含 /chat/completions）:
  https://api.router.one/v1/chat/completions
Custom model（自定义模型）:  <model-id-from-/models>
```

## Immersive Translate 该填哪个模型 ID？

从 /models 页复制精确的模型 ID——ID 区分大小写，页面同时列出每个模型的上下文窗口、能力和当前单价。建议为每个工具单独建一个 API Key，并设置 maxSpend 消费上限，这样单个工具跑飞不会影响其他工作负载。

## 在 trace 里验证 Immersive Translate 的调用

发出第一个请求后，到 Dashboard → Logs 查看它的完整 trace：模型、tokens、花费、延迟和状态码。Immersive Translate 的每一次调用从此都有账本和轨迹，不再是黑盒。

## 常见问题

### 「自定义 API 接口地址」填 base URL 为什么不行？

沉浸式翻译的「自定义 API 接口地址」要求带 /chat/completions 的完整路径——https://api.router.one/v1/chat/completions，而不是大多数 SDK 用的 /v1 base URL。翻译立刻报错时先检查这个后缀，再核对模型 ID 与 /models 页完全一致。

### Immersive Translate 能通过网关用哪些模型？

目录里任何具备对话能力的模型——GPT、Claude、Gemini、Grok、DeepSeek、GLM、Kimi 等系列。/models 页是模型 ID 与单价的事实来源。

### 中国大陆能直连吗？

能。网关在大陆可直连、无需 VPN，配置与全球环境完全一致。

### 报 401/403/429 怎么排查？

先到 Dashboard → Logs 看请求有没有到达网关以及状态码，再对照错误码速查页逐项检查环境变量、Key 状态和限额。

## 相关页面

- 全部接入指南：https://router.one/zh/integrations
- Immersive Translate 的 401/403/429 排查：https://router.one/zh/llm-api-error-codes
- Cline 接入：https://router.one/zh/integrations/cline
- Aider 接入：https://router.one/zh/integrations/aider
- 网关层负责什么：https://router.one/zh/llm-api-gateway
- OpenAI 兼容 API：https://router.one/zh/openai-compatible-api
- API 文档：https://router.one/zh/docs
- 本页规范地址：https://router.one/zh/integrations/immersive-translate
- 模型与每模型 token 价格：https://router.one/zh/models（markdown：https://router.one/zh/models.md）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md