# 沉浸式翻译接入指南

沉浸式翻译（Immersive Translate）是一款流行的双语网页翻译浏览器扩展，支持调用自定义 AI 模型进行翻译。本文介绍如何让它通过 UModelverse 平台调用模型。

## **系统要求**

-   Chrome、Edge、Firefox 等主流浏览器，或其移动端 App。
    
-   网络连接。
    

## **1. 安装沉浸式翻译**

前往 [沉浸式翻译官网](https://immersivetranslate.com/) 或浏览器扩展商店搜索「沉浸式翻译」安装。

## **2. 获取 API Key**

访问 [UModelverse 控制台](https://console.ucloud.cn/modelverse/api) 获取您的 API 密钥。可用模型见 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)。

## **3. 配置 UModelverse 模型**

UModelverse 走 OpenAI 兼容协议，因此使用沉浸式翻译的「OpenAI」翻译服务接入。

1.  点击扩展图标，进入 **设置** → **翻译服务**。

    ![沉浸式翻译翻译服务列表](https://cdnv2-cache.udelivrs.com/2026/06/9b449970b82dbfe8706d3c431ddf10f6_1781261163439.png)
    
2.  点击右上角 **Add Custom Translation Service**，在弹窗中选择 **OpenAI**。

    ![添加自定义翻译服务选择 OpenAI](https://cdnv2-cache.udelivrs.com/2026/06/69133be38e2040121b707f26deac8f7b_1781261163443.png)
    
3.  按下表填写：

| 项目 | 填写值 |
| --- | --- |
| APIKEY | 您的 UModelverse [API Key](https://console.ucloud.cn/modelverse/api) |
| Custom Translation Service Name | 自定义名称，例如 `UModelverse` |
| Model | UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一，例如 `qwen3.7-max`；需勾选 **Enter the name of the custom model** |
| Custom API interface address | `https://api.modelverse.cn/v1/chat/completions` |

![填写 APIKEY、服务名和模型](https://cdnv2-cache.udelivrs.com/2026/06/86482dddda44e71464f18674c66a3694_1781261163452.png)

![填写 Custom API 接口地址](https://cdnv2-cache.udelivrs.com/2026/06/cb1991323c3772a3ec53854bb4d65598_1781261163455.png)

4.  点击「测试服务」确认连通后保存，并将该服务设为默认翻译服务。

> 说明：部分版本的接口地址只需填到 `https://api.modelverse.cn/v1`，扩展会自动补全路径；若测试失败，可尝试在两种写法间切换。

## **常见问题**

### 测试服务失败或翻译报错？

请逐项确认：

1.  APIKEY 来自 UModelverse 平台，复制完整且无空格。
    
2.  API 接口地址为 `https://api.modelverse.cn/v1/chat/completions`（或 `https://api.modelverse.cn/v1`）。
    
3.  模型为 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一，没有写错。
    
4.  若提示请求过于频繁，可在设置中调低「每秒最大请求数」等并发参数。