> ## 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

Immersive Translate 是一款支持双语对照阅读的翻译扩展，利用大语言模型完成跨语言理解与翻译。它支持网页、PDF、EPUB 电子书和视频字幕的实时翻译，并提供浏览器扩展等多种使用方式。

### 1. 概览

* **跨语言理解**：借助 LLM 后端进行更流畅、具备上下文理解能力的翻译，而不只是逐句直译。
* **多种格式**：网页、PDF 文档、EPUB 电子书和视频字幕文件。
* **广泛使用**：自 2023 年推出以来，这款插件已被大量用户用于跨语言阅读和学习。

### 2. 使用场景

* 以原文和译文对照的方式阅读外语文章或文档。
* 在保持版式和结构的同时翻译 PDF 报告或 EPUB 图书。
* 为学习或无障碍访问生成或翻译视频字幕。

### 3. 与 Siflow Model Inference API 集成

您可以把 Siflow Model Inference API 作为翻译后端使用。做法是将 Immersive Translate 配置为使用 “OpenAI”（或兼容）API，并将请求指向平台的 Chat Completions 接入点。

#### 3.1 安装扩展

* 打开 [Immersive Translate](https://immersivetranslate.com/en/) 官方网站，选择 **“Install browser extension”**（或等效选项）。
* 选择适用于您的浏览器（Chrome、Edge、Firefox 等）的版本并安装。

#### 3.2 配置 API 和模型

点击 Immersive Translate 扩展图标并打开 **Settings**，然后在设置页面中填写：

| 设置项                     | 值                                                                                |
| ----------------------- | -------------------------------------------------------------------------------- |
| **API Key**             | 您在 Siflow [API 密钥管理](https://console.siflow.cn/maas-api/api_keys) 页面获取的 API 密钥   |
| **Model**               | Siflow 上显示的模型**调用名称**（例如 `Qwen/Qwen3.5-397B-A17B`、`deepseek-ai/DeepSeek-V4-Pro`） |
| **Custom API endpoint** | `https://api.siflow.cn/model-api/chat/completions`                               |

保存设置。

#### 3.3 将翻译服务设置为 OpenAI

将**翻译服务**设置为 **“OpenAI”**（或允许自定义 API 接入点的选项）。

<img src="https://mintcdn.com/siflow/vap4jT3tfBA1sSQZ/products/model-inference/img/select_api.png?fit=max&auto=format&n=vap4jT3tfBA1sSQZ&q=85&s=10f4cd0053d230fa30d8289fb209209d" alt="Immersive Translate — 选择 API / 打开设置" width="2984" height="1470" data-path="products/model-inference/img/select_api.png" />

#### 3.4 开始使用

点击左上角的 **Translate document** 打开翻译界面。配置完成后，Immersive Translate 会将翻译请求发送到 Siflow Model Inference API。此时您可以打开任意支持的网页、PDF 或 EPUB，直接查看由模型生成的双语对照翻译。下图展示了一个原文与译文并排显示的示例页面。

<img src="https://mintcdn.com/siflow/vap4jT3tfBA1sSQZ/products/model-inference/img/sample_translation.png?fit=max&auto=format&n=vap4jT3tfBA1sSQZ&q=85&s=4d840420b0d4fd3ef74922f3a452ff8a" alt="Immersive Translate — 双语翻译结果" width="3000" height="1422" data-path="products/model-inference/img/sample_translation.png" />

### 4. 注意事项

* **API 密钥**：请妥善保管您的密钥；不要分享它，也不要将其提交到版本控制中。
* **模型选择**：通用型或多语言模型（例如 Qwen、DeepSeek）适合用于翻译；对于长文档，请选择上下文长度足够的模型。
* **速率与限制**：长文本翻译可能消耗较多 token，请结合平台定价和速率限制合理使用。
