deeplx-pro

简介

deeplx-pro 是一个非官方的 DeepL web 翻译接口封装，允许通过 HTTP 请求访问 DeepL 翻译服务。

该项目仅供学习和参考，请勿用于商业用途。

获得 COOKIES

1. 进入 DeepL 网站，按下 F12 打开开发者工具，选择 "Application" 标签页。

2. 复制 Cookies 下的 dl_session 。

   

环境变量

在使用或部署 deeplx-pro 时，需要设置以下环境变量：

DEEPL_COOKIES=
PORT=9000
PROXY_LIST=

• DEEPL_COOKIES: （必需）通过浏览器获取的 dl_session Cookie 值（多个值用逗号分隔）。
• PORT: （可选）服务器运行端口，默认为 9000。
• PROXY_LIST: （可选）代理列表。

示例

DEEPL_COOKIES="1560565165-1811-481,515156-561561-11651"

注意: 如果有任何一个 dl_session 失效，将会影响到翻译服务的正常运行。

部署使用

Docker 部署

你可以通过 Docker 轻松部署 deeplx-pro：

docker run -d --name deeplx-pro -p 9000:9000 -e DEEPL_COOKIES="<your_dl_session_values>" xiaoxiaofeihh/deeplx-pro:latest

Windows 平台运行

在 Windows 系统上运行 deeplx-pro，请在包含 deeplx-pro 的目录下打开cmd ：

1. 设置 DEEPL_COOKIES 环境变量（注意不用引号）：

   set DEEPL_COOKIES=<dl_session_values>

2. 运行可执行文件：

   deeplx-pro-windows-amd64.exe

API 使用

你可以通过以下步骤来调用 deeplx-pro 提供的 API：

1. 确保已正确设置 DEEPL_COOKIES 环境变量。
2. 启动服务器并发送 POST 请求到 http://localhost:9000/translate。
3. 请求体应包含以下字段：
   • text：要翻译的文本内容。
   • source_lang：源语言（可选，默认为 'AUTO'）。
   • target_lang：目标语言（可选，默认为 'ZH'）。
   • quality：翻译质量（可选），可选值为 'normal' 或 'fast'，默认为 'normal'。

示例请求

Linux

curl 'http://127.0.0.1:9000/translate' \
--header 'Content-Type: application/json' \
--data '{
  "text": "Hello, world!",
  "source_lang": "EN",
  "target_lang": "ZH",
  "quality": "normal"
}'

Windows

需要将单引号替换为双引号，并转义 JSON 数据中的双引号

curl "http://127.0.0.1:9000/translate" ^
--header "Content-Type: application/json" ^
--data "{ \"text\": \"Hello, world!\", \"source_lang\": \"EN\", \"target_lang\": \"ZH\", \"quality\": \"normal\" }"

服务器将返回翻译结果的 JSON 响应。

有关 API 的更多使用细节，请参考 API 使用教程。

注意事项

• 请求频率: 请不要频繁发送大量请求，否则可能会导致 IP 被 DeepL 暂时封锁。
• 使用条款: 使用本项目时，请遵守 DeepL 的使用条款和限制。
• 语言支持: 不同语言的区域变体(RegionalVariant)可能不同，某些语言支持正式和非正式翻译。目前并未支持所有语言，欢迎通过 PR 来贡献更多语言支持。