> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Immersive Translate

> 了解如何在 Immersive Translate 中配置 Chat Completions endpoint，接入 siflow endpoint，为网页、PDF、EPUB 和字幕翻译提供模型后端。

Immersive Translate 是一个双语对照翻译 extension，可使用大语言模型进行跨语言理解。它支持网页、PDF、EPUB 电子书和视频字幕的实时翻译，并提供浏览器 extension 等多种形式。它的使用场景如下：

* 阅读外文文章或文档时，原文和译文并排显示。
* 翻译 PDF 报告或 EPUB 图书，同时保留布局和结构。
* 生成或翻译视频字幕，用于学习或无障碍访问。

您可以将 Immersive Translate 配置为使用 OpenAI 或 compatible API 选项，并将其指向 siflow Chat Completions endpoint，从而使用 siflow endpoint 作为翻译后端。

## 配置

### 1. 安装 extension

打开 [Immersive Translate](https://immersivetranslate.com/en/) 官方网站，选择 **Install browser extension** 或等效选项。根据浏览器类型（Chrome、Edge、Firefox 等）选择对应版本并安装。

### 2. 配置模型

单击 Immersive Translate extension 图标并打开 **Settings**。在设置页面中填写以下参数，并保存设置。

| 参数                  | 示例                                                                                                          |
| ------------------- | ----------------------------------------------------------------------------------------------------------- |
| API Key             | 您在 [API 密钥](https://console.siflow.cn/model-inference/api_keys) 页面创建的 API Key。请妥善保管 API Key，不要分享或提交到版本控制系统。 |
| Model               | 模型名称，例如 `Qwen/Qwen3.5-397B-A17B` 或 `DeepSeek-V4-Flash`。                                                     |
| Custom API endpoint | `https://api.siflow.cn/model-api/chat/completions`                                                          |

**提示**

* 通用或多语言模型（例如 Qwen、DeepSeek 模型）适合翻译场景。翻译长文档时，请选择上下文长度足够的模型。
* 长文本翻译可能消耗较多 token，请关注平台价格和速率限制。

<img src="https://mintcdn.com/siflow/MnqDOrFLyFtwF7sA/model-inference/media/immersive-translation-setup.png?fit=max&auto=format&n=MnqDOrFLyFtwF7sA&q=85&s=0bcb42565d8ca13683494d4408f6f2e3" alt="Immersive Translate 中配置 siflow API 和模型" width="2966" height="1520" data-path="model-inference/media/immersive-translation-setup.png" />

### 3. 将 translation service 设置为 OpenAI

将 **translation service** 设置为 **OpenAI**，或设置为允许自定义 API endpoint 的选项。

<img src="https://mintcdn.com/siflow/MD6YC9TIaGxx7fBG/model-inference/media/select-api.png?fit=max&auto=format&n=MD6YC9TIaGxx7fBG&q=85&s=8c5e81b307cb6e4140a5db02e22f71f9" alt="Immersive Translate 中打开 API 设置入口" width="2984" height="1470" data-path="model-inference/media/select-api.png" />

## 验证

单击左上角的 **Translate document** 打开翻译界面。打开任意支持的页面、PDF 或 EPUB，然后使用 extension 获取双语翻译。

以下示例展示了原文和译文并排显示的页面。

<img src="https://mintcdn.com/siflow/MD6YC9TIaGxx7fBG/model-inference/media/sample-translation.png?fit=max&auto=format&n=MD6YC9TIaGxx7fBG&q=85&s=7eb18ca8df42de55b11a8dd62d0b50cd" alt="Immersive Translate 使用算秩模型生成双语翻译结果" width="3000" height="1422" data-path="model-inference/media/sample-translation.png" />