Skip to content

kirileec/deeplx-pro

 
 

Repository files navigation

deeplx-pro

Docker Image CI

简介

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

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

获得 COOKIES

  1. 进入 DeepL 网站,按下 F12 打开开发者工具,选择 "Application" 标签页。
  2. 复制 Cookies 下的 dl_session
  • 2024-11: 更新 dl_session 目前在uuid前多了个 fa. 这样的前缀, 因此去掉源码里的36长度的判断
  • 2024-11: 更新Dockerfile, 和action配置
  • 2024-11: 修改为使用 OwO-Network/DeepLX , 并加入了TOKEN校验

环境变量

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

DEEPL_COOKIES=
PORT=9000
PROXY_LIST=
TOKENS=
  • DEEPL_COOKIES: (必需)通过浏览器获取的 dl_session Cookie 值(多个值用逗号分隔)。
  • TOKENS: (可选)自定义鉴权TOKEN(多个值用逗号分隔)。
  • 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>" slk1133/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' / 'auto' -> 'EN')。
    • target_lang:目标语言(可选,默认为 'ZH')。
    • tag_handling:标签处理(可选),可选值为 'html' 或 'xml',默认为 空。

示例请求

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 来贡献更多语言支持。

About

free deeplx-pro

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 96.5%
  • Dockerfile 3.5%