# Immersive Translate 接入指南

https://omnimodel.me/apps/immersive-translate?lang=zh

> 浏览器双语对照翻译扩展，可把翻译服务换成大模型。

## 适用场景

适合阅读外文网页和文档时做双语对照翻译：把翻译服务换成平台上的大模型，译文更贴近上下文。

## 使用建议

翻译类插件调用频繁、单次内容短，优先选单价较低的文本模型，并设置每日消费上限。

## 连不通时检查

1. API 地址填 `https://omnimodel.me/v1`，不要多写 `/chat/completions`。
2. 密钥以 `key_` 开头且没有被暂停或撤销，错误码 `auth.invalid_key` 表示密钥不可用。
3. 模型 ID 与[模型目录](/catalog)一致，并且在这把密钥的可用模型里。
4. 余额不足会返回 `billing.insufficient_credit`，更多错误见[常见错误](/docs/errors)。

## 配置步骤

1. 在扩展设置里进入「翻译服务」，选择 OpenAI。
2. 展开自定义设置，填入下面的 API 地址与密钥。
3. 把模型改成要用的模型 ID 并点测试。

## 配置参数

- API 地址：`https://omnimodel.me/v1`
- API 密钥：`YOUR_API_KEY`
- 模型：`MODEL_ID`

## 常见问题

### 翻译整页会产生很多调用吗？

会。整页翻译会把页面分段发送，长页面可能产生较多调用，建议选单价较低的模型。

### 译文质量不满意怎么办？

换用能力更强的文本模型，或在插件里调整提示词。