forked from Ms-Studio/appstore-1panel
122 lines
3.2 KiB
Markdown
122 lines
3.2 KiB
Markdown
# DeepLX
|
||
|
||
强大的 DeepL 翻译 API
|
||
|
||
|
||
|
||
|
||
|
||
## 简介
|
||
|
||
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)
|
||
|
||
---
|
||
|
||
|