自定义 API 配置
如果您不使用内置翻译服务，而希望通过自己申请的 API 密钥接入第三方翻译平台，可在此进行配置。无论是传统机器翻译服务还是大语言模型，均支持自定义接入。
配置类型
在翻译引擎设置中，软件提供三种翻译模式：
- 内置翻译服务：开箱即用，无需配置 API 密钥。
- 自定义：使用您自己申请的 API 密钥接入第三方平台（通用机器翻译或 LLM 大模型）。
- 本地翻译：使用随附的 Hy-MT2 本地翻译模型进行完全离线的翻译，无需联网、无需 API 密钥。适合隐私敏感或网络不稳定的场景，本地模型会在空闲时自动卸载以释放内存。
语音翻译使用的翻译引擎同样支持自定义与本地两种模式（不支持内置模式）。
在选择"自定义"模式后，根据您要使用的服务类型再选择：
- 通用翻译服务
- LLM 大模型服务
1. 通用机器翻译配置
适用于腾讯翻译君、百度翻译、火山引擎、微软翻译、阿里云翻译等传统机器翻译 API。
| 配置项 | 说明 |
|---|---|
| API ID | 服务商分配的应用 ID 或 App ID（部分服务商不要求此项，可填写任意数字如 12345 跳过该字段）。 |
| API Key / Secret | 在服务商控制台生成的密钥字符串，用于验证您的身份。 |
2. LLM / 大模型 API 配置
适用于 OpenAI、DeepSeek、豆包、通义千问、Kimi、MiniMax、智谱等对话型大语言模型 API，通过向模型发送翻译指令来获取结果。
支持的 LLM 提供商（实时以软件内列表为准）：
| 服务商 | 说明 |
|---|---|
| OpenAI | GPT 系列模型 |
| DeepSeek | DeepSeek 大模型 |
| 阿里百炼（通义千问） | 阿里云通义系列模型 |
| 火山引擎（豆包） | 字节跳动豆包大模型 |
| 硅基流动 | SiliconFlow 模型平台 |
| Anthropic | Claude 系列模型 |
| 谷歌 Gemini | Gemini 系列模型 |
| 腾讯混元 | 腾讯混元大模型 |
| Kimi（月之暗面） | Kimi 系列模型 |
| MiniMax | MiniMax 大模型 |
| 百度千帆 | 百度文心系列模型 |
| xAI | Grok 系列模型 |
| 智谱 | GLM 系列模型 |
| 配置项 | 说明 |
|---|---|
| API Key | 服务商提供的接口密钥，通常以 sk- 开头。 |
| 模型名称 | 要使用的具体模型名称，如 gpt-4o、deepseek-chat、glm-4。在内置模式下会自动获取可用模型列表供选择。 |
| 自定义翻译提示词 | 控制模型翻译行为的系统指令，可用于指定翻译风格、语气或增加特殊要求。文字翻译默认提示词为："你是一个翻译专家，翻译的文本是使用OCR识别的结果……"；语音翻译默认提示词为："你是一个语音翻译专家，输入是语音识别的连续片段……"。 |
| 自定义请求地址 (API URL) | 如您使用本地部署的 Ollama、LM Studio 或第三方代理服务，可在此填写自定义接口地址（如 http://192.168.1.100:11434/v1/chat/completions）。留空则使用所选服务商的默认地址。 |
| 认证用户名 / 认证密码 | 部分服务商的内置或自定义认证方式需要提供服务商分配的账号与密码，按需填写。 |
如何获取 API 密钥？
- 腾讯/百度/微软/阿里云：在对应云服务控制台注册并创建应用，即可获取密钥。
- DeepSeek：推荐使用，语义理解效果出色，前往 平台控制台 注册获取。
- OpenAI：前往 官方网站 注册获取。
- 其余服务商请前往各自官方网站的开发者 / API 控制台申请。
本地翻译模式
本地翻译模式无需任何 API 密钥，完全离线运行：
- 使用随附的 Hy-MT2（约 1.8B）本地翻译模型，基于 CPU 推理。
- 可在设置中调节推理核心数（范围 1 ~ 设备核心数，默认 4）以平衡速度与资源占用。
- 本地模型默认在空闲 30 秒后自动卸载以释放内存，下次翻译时再按需加载。
- 支持与语音识别相同的语言范围（含自动检测）。
本地翻译模式主要在"翻译引擎设置"中通过将文字翻译或语音翻译引擎切换为"本地"来启用，同时需确保已正确安装本地翻译模型文件。