appstore-1panel/apps/deeplx/README.md
萌森 70849058f9 公告 && 支持应用
LinkDing
Docker Mailserver
Pixman
DeepLX API
Cookie Cloud
Telegram Bot Api

Signed-off-by: 萌森 <qyg2297248353@163.com>
2024-07-29 17:26:39 +08:00

116 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# DeepLX
强大的 DeepL 翻译 API
![DeepLX](https://file.lifebus.top/imgs/deeplx_cover.png)
## 简介
DeepLX 最初由 zu1k 命名并发布,尽管 zu1k 此后已停止维护它并删除了相关存储库。
感谢zu1k的贡献。
这是zu1k设计的DeepLX Docker镜像的备份没有任何修改。
## 安装说明
### http代理服务器地址
> 基本格式
```shell
# 无鉴权代理
http://127.0.0.1:7890
# 有鉴权代理
http://<username>:<password>@127.0.0.1:7890
```
### 访问令牌以保护您的 API
> 请注意,如果您不使用访问令牌,您的 API 可能会被滥用。
接口调用时,您可以使用 `X-Access-Token` 请求头来传递访问令牌。
### DeepL官方提供的API Auth Key
开通DeepL API后您将获得一个API Auth Key您可以使用它来访问DeepL API。
### DeepL Pro 帐户 dl_session cookie
如果您有DeepL Pro帐户您可以使用 `dl_session` cookie 来访问DeepL API。
## 接口简介
### 免费端点
模拟DeepL iOS客户端发起翻译请求。无限制但在一定时间内频繁请求会导致429错误。
接口:`/translate`
请求方式POST
请求头:
| Header | Description | Value |
|:----------------|:--------------------------------------|:---------------------------|
| `Content-Type` | The content type of the request body. | `application/json` |
| `Authorization` | The access token to protect your API. | `Bearer your_access_token` |
> 如果无法使用 `Authorization` 请求头,您可以使用 `URL Params` 传递 `Authorization`。
>
> 例如:`/translate?token=your_access_token`
请求体:
| 参数名 | 字段类型 | 描述 | 是否必须 |
|:--------------|:---------|:--------|:-------|
| `text` | `string` | 待翻译字段。 | `true` |
| `source_lang` | `string` | 源语言代码 | `true` |
| `target_lang` | `string` | 目标语言代码。 | `true` |
请求体 JSON 示例:
```json
{
"text": "你听说过这个吗?",
"source_lang": "ZH",
"target_lang": "EN"
}
```
响应体:
```json
{
"alternatives": [
"Did you hear about this?",
"You've heard about this?",
"You've heard of this?"
],
"code": 200,
"data": "Have you heard about this?",
"id": 8356681003,
"method": "Free",
"source_lang": "ZH",
"target_lang": "EN"
}
```
### 专业端点
模拟 DeepL 专业版账户发起翻译请求。无限制,可有效避免 429 问题,但需要提供专业账户的 dl_session 参数,否则无法使用。
接口:`/v1/translate`
请求方式POST
> 其他参数与免费端点相同。
### 官方端点
模拟 DeepL 官方 API 发起翻译请求。无限制,但在一定时间内频繁请求将导致 429 错误。
接口:`/v2/translate`
请求方式POST
> 其他参数与免费端点相同。
>
> 更多官方API配置请参考 [DeepL 官方文档](https://developers.deepl.com/docs/api-reference/translate)