#翻译接口指南

工具集成了 7 种经典翻译 API 和 24 种大语言模型，可按文本类型、预算与隐私需求自由选择。

#我应该挑哪个接口？

详细对比和申请方式往下看 ↓

#经典翻译 API

要点说明：

• DeepL 不允许浏览器直连，工具默认走内置代理；如有自建代理可在设置中填入自定义 URL。
• Qwen-MT 是阿里云专为翻译训练的模型，详见下文 Qwen-MT 使用要点。
• TranslateGemma 是 Google 开源的翻译专用 Gemma，需要本地用 LM Studio / Ollama / llama.cpp 跑起来，详见下文 本地模型接入。
• GTX API / Edge API 都是零配置的免费机器翻译，互为备胎——一个连不上就换另一个；细节见下文 免费机器翻译使用要点。

需要更稳定的服务，可自行申请商业 API Key，详见 接口申请教程。

#大语言模型（LLM）

支持的 LLM 接口：DeepSeek、OpenAI、Claude、Gemini、Qwen、Moonshot (Kimi)、Zhipu GLM、Doubao、Xiaomi MiMo、MiniMax、Tencent Hunyuan、Baidu ERNIE、Cohere、xAI (Grok)、Mistral、Perplexity、YandexGPT (AI Studio)、OpenRouter、Groq、SiliconFlow、GitHub Models、Nvidia NIM、Azure OpenAI、LiteLLM（自建网关），以及兼容 OpenAI 协议的自定义接口。

适合处理：

• 文学作品、技术文档等需要深度理解的内容
• 需要保持术语风格一致的多语种资料
• 想用自定义提示词控制翻译风格的场景

主要参数：

• 模型：填所选接口提供的模型名；Azure OpenAI 填部署名。
• 温度（Temperature）：默认 0.7。技术文档建议 0.2 左右，营销/意译可以放到 0.9。
• 思考模式：让 AI 多想一步再翻译，质量更高但更慢/更贵——支持的模型 UI 会显示开关。开关按模型独立保存，切模型不影响别的设置。具体 UI 形态因 provider 而异：
  • 三档调节（off / low / medium / high）：Claude、Gemini、OpenAI GPT-5、Qwen3、Azure OpenAI、Nvidia NIM、OpenRouter、Groq (GPT-OSS)、Perplexity Sonar Deep Research
  • 两档开关（off / on）：DeepSeek（开启即最高档，底层 API 的中间档位对翻译无意义）、Doubao、Zhipu GLM、Moonshot (Kimi)、Xiaomi MiMo、SiliconFlow、ERNIE 5.0 Thinking、Mistral（Medium 3.5 / Small 4）、Cohere Command A Reasoning（底层 API 只接受 on/off，不接受 effort）
  • 仅 low / high：xAI Grok 4.3（API 限制）
  • 三态（off / on / auto）：在支持思考的 provider 上填写未列出的自定义模型时（含 Mistral、Perplexity、自定义 OpenAI 兼容接口）。Auto = 省略思考参数、跟随模型自带默认（用于严格 provider 对非思考 SKU 会报错时的兜底）；默认 Off
  • 选了即开启（思考是模型自身特性，UI 不显示开关）：MiniMax M2.x、Tencent Hunyuan（TurboS / 2.0 Thinking / T1）、Mistral Magistral、Perplexity Sonar Reasoning Pro、Grok 4.20 Reasoning / Multi-Agent
  • 无思考开关：GitHub Models、YandexGPT（网关/API 不支持 reasoning 参数）、LiteLLM（网关不注入思考参数，跟随上游模型默认）

#部分接口的特别说明

• GitHub Models：用 GitHub PAT（需 models:read 权限）鉴权，免费额度按模型分级，适合没有付费 Key 的入门用户。
• Tencent Hunyuan：腾讯官方端点目前拒绝浏览器的跨域预检请求（直连必败），「中转 API」默认开启以保证开箱可用；官方修复后可在 API 设置中关掉开关改回直连。详见 中转 API。
• YandexGPT (AI Studio)：除 API Key 外还需填写 Folder ID（在 Yandex AI Studio 控制台的目录页获取）。模型字段填 SKU 名（如 yandexgpt-5.1，也提供 Qwen3、DeepSeek、GPT-OSS 等开源 SKU），或直接粘贴完整的 gpt://<folder_id>/<model>/latest URI。Yandex 官方接口无 CORS 头，浏览器无法直连，「中转 API」默认开启（开关可关闭，也可改填自建中转地址）。

#区域端点切换

不少接口在国内、海外、美国有不同的接入地址，URL 输入框上方会以快捷标签列出官方地址，点击即可切换：

#URL 自动补全

自托管与多区域类接口（Custom、LiteLLM、TranslateGemma、Qwen / Qwen-MT、Doubao、Nvidia）的 URL 字段在切走焦点时会立即补全为完整路径；其余接口填写的自定义 URL 也会在请求发出前自动规范化。粘贴 http://host:port 或 http://host:port/v1 即可，不会再出现"少写 /v1/chat/completions 导致连不上"的问题。

#免费机器翻译使用要点

工具内置三个零配置的免费机器翻译——GTX (Free)、Edge (Free)、DeepLX (Free)，都不需要 API Key，从你的浏览器直连官方接口，文本不经过本工具的服务器。它们走不同的链路，互为备胎：一个连不上，下拉换另一个即可，不必申请任何 Key。GTX 是默认服务。

#GTX 网关可切换

GTX 默认走 translate-pa.googleapis.com（Google 网页翻译组件用的同一个网关，跨域规范、可用性好）。URL 输入框上方提供快捷切换：

• translate-pa（默认）：推荐，多数网络环境可用
• Legacy gtx：旧版 translate.googleapis.com/translate_a 端点。Google 已对它收紧反滥用策略（很多 IP 会被跳转到验证页，浏览器据此报 CORS），但封锁按 IP 信誉判定，部分地区/网络仍可用，故保留作备选
• 自建镜像：URL 填你自己用 Cloudflare Worker 等搭的镜像地址即可，工具按地址形态自动识别协议

#速率限制与自动降速

免费共享端点按使用方限流。GTX 现在采用整批分块翻译——把多行拼成约 5000 字符一块、一块一个请求，请求数相比逐行翻译大幅减少，日常使用基本不会触发限流。短时间超大批量仍可能限流，工具会自动处理：

• 触发限流后自动暂停该服务的所有请求，稍候自动恢复，并提示「请求过于频繁，已自动暂停片刻后重试」
• 期间翻译变慢但会继续推进，绝大多数情况无需任何操作
• 若失败面板仍频繁出现限流提示：等几分钟再点「再试一次」（缓存会跳过已完成的行），或换 Edge (Free) / DeepLX (Free) 这两个免费备胎；长期大批量任务建议换 DeepL / Qwen-MT / DeepSeek 等带 Key 的服务

连不上或控制台出现 CORS 报错？先换网关或换 Edge (Free)——多数情况一步解决；仍不行再排查网络环境（大陆屏蔽、公司网络拦截、浏览器扩展拦截），步骤见 常见问题 → GTX 连不上。

#Qwen-MT 使用要点

阿里云的 Qwen-MT 是机器翻译类服务，与通用 LLM 不同——它没有 system prompt 概念，只用源/目标语言代码工作，因此 Prompt 设置对它不生效。

#模型选择

API 设置的 模型 字段需要手动填写：

#领域提示（domains）

domains 字段告诉模型当前文本所处的行业，让术语更专业。注意：填一段英文自然语言，不是关键词列表。阿里官方示例：

The sentence is from Ali Cloud IT domain. It mainly involves computer-related
software development and usage methods, including many terms related to computer
software and hardware. Pay attention to professional troubleshooting terminologies
and sentence patterns when translating. Translate into this IT domain style.

不需要时留空即可。

#原生术语表通道

Qwen-MT 是少数支持原生术语表的 MT 服务：启用 术语表 后，命中的词条会通过官方 translation_options.terms 参数随请求发送，由模型在翻译时原生应用，比提示词注入更可靠。

#不支持的语言

Qwen-MT 官方约 92 种语言，部分低资源语言暂未覆盖，UI 会自动提示并阻止使用（以应用内实际拦截为准）：如柯尔克孜（ky）、土库曼（tk）、塔吉克（tg）、蒙古（mn）、马拉雅拉姆（ml）、维吾尔（ug）、阿姆哈拉（am）等数十种。

#中转 API 与内置代理

部分接口的官方端点不允许浏览器直连（CORS 限制）。工具提供两类代理通道，文本都不经过本工具的服务器存储。

#中转 API（可控开关）

DeepSeek、OpenAI、Claude、Qwen、Moonshot (Kimi)、Doubao、Zhipu GLM、Mistral、xAI (Grok)、Perplexity、Tencent Hunyuan、YandexGPT 这 12 个接口在 API 设置里提供「中转 API」开关，开启后请求经由内置的 Cloudflare 转发（只转发请求本体与鉴权头）：

• 大多数接口默认关闭——直连遇到 CORS / 403 报错时，界面会用可行动提示引导你开启
• Hunyuan 与 YandexGPT 默认开启：两家官方端点目前都无法从浏览器直连，默认开才能开箱即用；开关保留，官方修复后可自行切回直连
• 自建中转：不想走共享中转，把自己部署的转发地址填入 URL 字段即可。优先级固定为 自定义 URL > 中转开关 > 官方直连——URL 已填时中转开关会置灰，并提示「清空 URL 后恢复」
• 中转会透传服务器的 Retry-After 响应头，限流时的自动降速与直连一样精确

#内置代理（无开关）

DeepL 与 Nvidia NIM 默认经另一组内置代理转发；在设置里填了自定义 API URL 时代理被绕过，请求直接发到你填的地址。

#本地模型接入

希望自己跑模型保护隐私？工具支持任何兼容 OpenAI 协议的本地服务。为了翻译质量，通用 LLM 建议 qwen3-14b 及以上参数规模（32B 级更好）；显存有限时可改用翻译专用的 TranslateGemma，4B 起就有不错的翻译质量。

国内用户下载模型推荐 魔搭 ModelScope，比 Hugging Face 直连 / LM Studio 内置源快得多，TranslateGemma 官方仓库也有同步。

#默认接口地址

URL 输入框旁会列出这些常用地址作为快捷选项。

#LiteLLM 自建网关

LiteLLM 是把 100+ 上游模型统一成 OpenAI 协议的自建代理。服务列表里直接选 LiteLLM 即可——与 Custom 的差别在于独立的配置槽位：常驻 LiteLLM、偶尔切换其他自建端点时，不必来回改 Custom 的 URL。

• 默认地址 http://127.0.0.1:4000/v1/chat/completions（litellm 默认端口），URL 即凭证
• API Key 可选：本地裸跑无需填写；代理配置了 master / virtual key 时填上即可
• 模型名可留空：用 litellm --model X 启动（官方 quick start 方式）或设置了 completion_model 服务端默认时，留空即走服务端默认模型；config.yaml 多模型部署则填模型别名
• LiteLLM 默认放行浏览器跨域请求，无需额外 CORS 配置

#TranslateGemma

Google 推出的翻译专用 Gemma 模型，针对翻译质量做了专门训练。使用要点：

• 请在服务列表里直接选「TranslateGemma」——不要走「Custom (OpenAI-compatible)」+ 填 translategemma-4b-it 模型名。两者是完全不同的代码路径：独立的 TranslateGemma 服务走逐行调用，专门匹配 Gemma 翻译模型的输入输出格式；Custom 走的是带批次/上下文标记的 LLM 通用路径，对 14B 以下的小模型容易漏行、速度也更慢。
• 默认地址指向 LM Studio 1234 端口，可一键切换到 Ollama / llama.cpp
• API Key 可选：本地裸跑无需填写；若服务端开了鉴权（LM Studio 的 "require API key"、vLLM 的 --api-key、或反向代理加的认证层），填上即可，请求会附带 Authorization: Bearer 头
• 推荐模型：translategemma-4b-it（轻量快速）、translategemma-12b-it（质量更好）或 translategemma-27b-it（最强）
• Prompt 设置对它不生效：和 Qwen-MT 一样属于机器翻译类服务，提示词已内置在调用格式里，系统/用户 Prompt 只对 LLM 类接口生效
• 必须明确指定源语言——这个模型不支持"自动检测"
• 语言覆盖较小：只支持约 55 种主流语言（对齐 Google WMT24++ benchmark）；约 68 种小语种——包括粤语 yue、博杰普尔 bho、沃洛夫 wo、阿拉贡 an、瓜拉尼 gn、库尔德 ckb/kmr——会被 UI 直接拦截。需要更广语种请改用 DeepL / Google / Azure / Qwen-MT

#解决 CORS 跨域

浏览器调用本地模型时若连不上，最常见的两个原因：

步骤 1｜排查广告/隐私插件：先暂时禁用浏览器的拦截扩展，刷新重试。

步骤 2｜为本地服务开启 CORS：

#Ollama

在 PowerShell（Win + X 打开终端）粘贴一行命令永久启用：

[System.Environment]::SetEnvironmentVariable('OLLAMA_ORIGINS', '*', 'User')

* 允许所有来源；想更严格可换成具体域名，例如 http://192.168.2.20:3000。

设置后重启 Ollama 服务即可生效。临时启用也可以在启动时加环境变量：

OLLAMA_ORIGINS="*" ollama serve

#LM Studio

1. 打开左侧菜单的「Developer」图标
2. 进入本地服务器设置页，点顶部「Settings」
3. 勾选「Enable CORS」复选框

完成后即可正常调用本地模型。仍连不上的话，检查端口占用情况和浏览器控制台的报错信息。（特别感谢 mrfragger 分享配置经验）

#语言支持

本工具支持 120+ 种主流语言互译，按地区分组展示。

#语言代码对照表

批量配置多语言时，使用下方语言代码（如 en, zh, ja, ko）：

#常用

#欧洲

#中东

#中亚

#南亚

#东南亚

#非洲

#美洲与大洋洲

#API 支持文档

LLM 可支持所有语言，机器翻译 API 语言支持如下：

• DeepL 支持的语言
• Google Translate 支持的语言
• Azure Translator 支持的语言
• Qwen-MT 支持的语言