Translation Proxy 使用帮助

基于 AI 大模型的 DeepL 兼容翻译代理 — 让 WordPress 多语言翻译更便宜、支持更多语言

它是什么？

这是一个 DeepL API 兼容的翻译代理服务。它接收 TranslatePress（或其他 DeepL 客户端）发来的翻译请求，转发给 AI 大模型（DeepSeek）完成翻译，并返回 DeepL 格式的响应。

和直接使用 DeepL 相比：

快速上手（3 步）

1获取 Service Key

打开 管理页面 (/admin)，在"创建新配置"中填写：

点击 创建，系统会验证你的 Key 是否有效，成功后返回一个 Service Key。

Service Key 仅显示一次，请立即复制保存！它是你管理配置和调用翻译 API 的唯一凭证。

2配置 WordPress

在 WordPress 的 functions.php 或自定义插件中，添加以下代码将 DeepL 请求重定向到本服务：

add_filter('pre_http_request', function($preempt, $args, $url) {
    if (strpos($url, 'api-free.deepl.com') !== false
        || strpos($url, 'api.deepl.com') !== false) {
        $new_url = str_replace(
            ['api-free.deepl.com', 'api.deepl.com'],
            'deepl.210k.cc',
            $url
        );
        return wp_remote_request($new_url, $args);
    }
    return $preempt;
}, 10, 3);

直接复制粘贴即可，域名已自动填入当前服务地址。

3配置 TranslatePress

进入 WordPress 后台 → 设置 → TranslatePress → 自动翻译：

  1. 翻译引擎选择 DeepL
  2. API 类型选 Free 或 Pro（都行，因为请求会被重定向）
  3. 在 API Key 栏填入第 1 步获得的 Service Key
  4. 保存后，如果显示 "API key is valid"，说明配置成功
配置完成后，TranslatePress 翻译页面时会自动调用本服务。首次翻译会稍慢（需调用 AI），后续同内容直接走缓存。若要固定行业术语，可在管理面板配置术语表 JSON。

管理你的 Key

所有管理操作都在 管理页面 (/admin) 进行，Service Key 是唯一凭证：

操作需要什么说明
创建域名 + API Key + 服务商每个域名只能创建一个，Service Key 仅显示一次
管理Service Key查看配置、更换 API Key / 服务商、删除配置
更换 KeyService Key + 新 API Key支持切换服务商（AIHubMix / OpenRouter）
删除Service Key删除后无法恢复，需重新创建

支持的语言

因为后端使用 AI 大模型，支持的语言远超 DeepL 原生。以下是已声明支持的语言：

🇬🇧 English 🇨🇳 中文 (简/繁) 🇪🇸 Español 🇫🇷 Français 🇩🇪 Deutsch 🇮🇹 Italiano 🇵🇹 Português 🇷🇺 Русский 🇯🇵 日本語 🇰🇷 한국어 🇸🇦 العربية 🇮🇳 हिन्दी 🇹🇭 ไทย 🇻🇳 Tiếng Việt 🇮🇩 Indonesia 🇹🇷 Türkçe 🇵🇱 Polski 🇳🇱 Nederlands 🇸🇪 Svenska 🇺🇦 Українська 🇷🇴 Română 🇨🇿 Čeština 🇭🇺 Magyar 🇬🇷 Ελληνικά 🇧🇬 Български 🇷🇸 Srpski 🇭🇷 Hrvatski 🇮🇷 فارسی 🇵🇰 اردو 🇵🇭 Tagalog …还有更多

常见问题

TranslatePress 显示 "Invalid API Key"？

检查两点：

  1. pre_http_request filter 是否生效 — 请求必须发到本服务，而不是 DeepL 官方
  2. 填的是 Service Key（UUID 格式，:fx 结尾），不是 AIHubMix Key

翻译很慢？

首次翻译需要调用 AI 模型，每段文本约 1-3 秒。TranslatePress 每次会批量翻译多段，所以首次加载可能较慢。后续相同内容直接走缓存，速度很快。

更换 API Key 或切换服务商怎么办？

在 管理页面 输入 Service Key 进入管理面板，在"修改 API Key / 服务商"区域输入新 Key 即可。支持 AIHubMix 和 OpenRouter 互切。

忘记了 Service Key？

Service Key 仅在创建时显示一次，无法找回。如果遗失，需要删除旧配置后重新创建（需联系管理员）。