# 在沉浸式翻译中使用 OAIRoute
> 浏览器扩展，对照翻译网页
> 支持自定义 AI 翻译服务
> 用大模型翻译，长句与专业术语比传统机翻更通顺
## 第一步：获取 API Key
在 [OAIRoute 控制台](https://api.oairoute.com/keys) 创建。
## 第二步：添加自定义翻译服务
打开沉浸式翻译扩展的设置，进入 **翻译服务**，点 **添加自定义翻译服务**：
- `名称` (string / 必填) — 自定义，例如 `OAIRoute`。
- `接口地址` (string / 必填) — `https://api.oairoute.com/v1/chat/completions` 注意这里要填**完整端点**，不是 base URL。
- `API Key` (string / 必填) — 你的 OAIRoute Key。
- `模型` (string / 必填) — 建议选便宜且速度快的模型，例如 `gpt-4o-mini`。
- `Prompt` (string / 可选) — 使用扩展内置的翻译提示词即可。需要特定风格时再改。
## 第三步：测试
在设置页点 **测试服务**，看到「验证成功」即可。之后打开任意英文网页，按快捷键触发翻译。
## 模型选择建议
翻译是高频、短文本、强并发的场景，与对话场景的取舍不同：
| 关注点 | 建议 |
|---|---|
| 成本 | 选小模型，翻译不需要强推理 |
| 速度 | 小模型首 token 更快，翻译体验更好 |
| 质量 | 专业文档可切到大模型，日常网页小模型足够 |
| 并发 | 长网页会并发多次请求，注意限流 |
> **Note:** 
> 沉浸式翻译会把网页切成多个段落并发请求。一篇长文可能瞬间发出几十次调用。用按次计费的模型时成本会偏高，建议先翻译一篇试试。
## 常见问题
**测试服务失败**
接口地址填成了 base URL。要填完整的 `/v1/chat/completions`。
**翻译出来是原文**
模型返回了拒绝或空内容。换一个指令遵循更好的模型。
**翻译很慢**
并发数设得太高导致限流。在扩展的「高级设置」里把并发调低。
**术语翻错**
在内置提示词里补充术语表，或换用更强的模型。
**配置项{Configuration}**
```
名称
oairoute
接口地址
https://api.oairoute.com/v1/chat/completions
API Key
sk-xxxxxxxxxxxxxxxx
模型
gpt-4o-mini
```
**验证端点{Verify endpoint}**
```
curl https://api.oairoute.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OAIRoute_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role":"system","content":"把用户输入翻译成中文，只输出译文。"},
      {"role":"user","content":"Hello, world."}
    ]
  }'
```