Source: https://wiki.niceai.dev/guide/clients/immersive-translate

# 沉浸式翻译接入自定义 API

在沉浸式翻译的 **设置 → 翻译服务 → OpenAI** 中切换到“自定义 API Key”，填入 NiceAI 密钥，并把 **自定义 API 接口地址** 设为完整地址 `https://api.niceai.dev/v1/chat/completions`，再添加模型名即可。

## 准备工作

1. 安装沉浸式翻译浏览器扩展。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥。建议为翻译单独创建一个密钥，方便在使用记录里区分消耗。

## 配置步骤

1. 打开沉浸式翻译 **设置 → 翻译服务**，选择 **OpenAI**。
2. 切换为 **自定义 API Key** 模式，在 APIKEY 中粘贴 NiceAI 密钥。
3. 点击 **展开更多自定义选项**，**自定义 API 接口地址** 填：

   ```text
   https://api.niceai.dev/v1/chat/completions
   ```

4. 在 **设置更多模型**（或“输入自定义模型名称”）中添加 [模型广场](https://niceai.dev/model-plaza) 里的模型名，并在“模型”中选中。
5. 点击 **测试服务**，再打开一个外文网页试翻译。

**为什么填完整地址**
沉浸式翻译不同版本对 Base URL 的补全规则不完全一样，填到 `/chat/completions` 的完整地址在各版本里都按原样使用，最省心。


## 控制消耗和频率

- **选轻量模型**：网页翻译调用量大，速度快、单价低的非推理模型更合适，推理模型会明显变慢变贵。
- **调低请求频率**：在“更多自定义选项”里调低“每秒最大请求数”。遇到 429 时先降到每秒几个。
- **单独的密钥**：翻译一本书可能产生大量请求，单独的密钥便于观察用量，出现异常也可以单独停用。

## 常见问题

### 测试服务提示 404？

接口地址要包含 `/v1/chat/completions`。只填 `https://api.niceai.dev` 时，部分版本会拼成缺少 `/v1` 的地址。

### 翻译一部分段落失败？

多半是请求太频繁触发了限流（429），调低每秒请求数后重试。见 [限流、超时与重试](https://wiki.niceai.dev/guide/api/rate-limits)。

## 下一步

- [Cherry Studio 接入](https://wiki.niceai.dev/guide/clients/cherry-studio)
- [限流、超时与重试](https://wiki.niceai.dev/guide/api/rate-limits)
