mirror of
https://github.com/CJackHwang/ds2api.git
synced 2026-05-10 19:27:41 +08:00
feat: Implement DeepSeek account validation, testing, and queue status monitoring with corresponding admin API endpoints.
This commit is contained in:
CJACK
310
README.MD
310
README.MD
@@ -1,273 +1,149 @@
|
||||
# DeepSeek2API
|
||||
# DS2API
|
||||
|
||||
[](LICENSE)
|
||||
|
||||
|
||||
[](LICENSE)
|
||||
|
||||
|
||||
|
||||
支持高速流式输出、支持多轮对话、支持R1深度思考，多路账号支持。
|
||||
将 DeepSeek 网页版转换为 OpenAI 兼容 API，支持多账号轮询、自动 Token 刷新、可视化管理界面。
|
||||
|
||||
与ChatGPT接口完全兼容。
|
||||
## ✨ 特性
|
||||
|
||||
## 目录
|
||||
- 🚀 **OpenAI 兼容** - 完全兼容 OpenAI API 格式，无缝接入现有应用
|
||||
- 🔄 **多账号轮询** - Round-Robin 负载均衡，支持高并发
|
||||
- 🔐 **Token 自动刷新** - 过期自动重新登录，无需手动维护
|
||||
- 🌐 **WebUI 管理** - 可视化添加账号、测试 API、同步 Vercel
|
||||
- 🔍 **联网搜索** - 支持 DeepSeek 搜索增强模式
|
||||
- 🧠 **深度思考** - 支持 R1 推理模式
|
||||
- ☁️ **Vercel 部署** - 一键部署，无需服务器
|
||||
|
||||
* [免责声明](#免责声明)
|
||||
* [接入准备](#接入准备)
|
||||
* [多账号接入](#多账号接入)
|
||||
* [Vercel部署](#Vercel部署)
|
||||
* [接口列表](#接口列表)
|
||||
* [模型列表](#模型列表)
|
||||
* [对话补全](#对话补全)
|
||||
* [注意事项](#注意事项)
|
||||
* [Nginx反代优化](#Nginx反代优化)
|
||||
* [Token统计](#Token统计)
|
||||
* [Star History](#star-history)
|
||||
* [鸣谢](#鸣谢)
|
||||
## 📋 模型支持
|
||||
|
||||
## 免责声明
|
||||
| 模型 | 说明 |
|
||||
|-----|------|
|
||||
| `deepseek-chat` | DeepSeek V3.2 非推理模式 |
|
||||
| `deepseek-reasoner` | DeepSeek V3.2 推理模式（深度思考） |
|
||||
| `deepseek-chat-search` | 非推理 + 联网搜索 |
|
||||
| `deepseek-reasoner-search` | 推理 + 联网搜索 |
|
||||
|
||||
**逆向API是不稳定的，建议前往DeepSeek官方 https://platform.deepseek.com/ 付费使用API，避免封禁的风险。**
|
||||
## 🚀 快速开始
|
||||
|
||||
**本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！**
|
||||
### Vercel 部署（推荐）
|
||||
|
||||
**仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！**
|
||||
[](https://vercel.com/import/project?template=https://github.com/CJackHwang/ds2api)
|
||||
|
||||
**仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！**
|
||||
1. 点击上方按钮部署
|
||||
2. 设置环境变量 `DS2API_ADMIN_KEY`（管理密码，**必填**）
|
||||
3. 部署完成后访问 `/webui` 管理界面
|
||||
4. 添加 DeepSeek 账号和 API Key
|
||||
5. 点击「同步到 Vercel」完成配置
|
||||
|
||||
**仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！**
|
||||
> **首次同步会自动验证账号、保存 Token 和 Vercel 凭证，后续操作无需再输入。**
|
||||
|
||||
## 接入准备
|
||||
### 本地运行
|
||||
|
||||
一个或多个 DeepSeek 账号
|
||||
```bash
|
||||
# 克隆仓库
|
||||
git clone https://github.com/CJackHwang/ds2api.git
|
||||
cd ds2api
|
||||
|
||||
### 多账号接入
|
||||
# 安装依赖
|
||||
pip install -r requirements.txt
|
||||
|
||||
目前同个账号同时只能有*一路*输出，你可以通过提供多个账号并使用。
|
||||
# 配置
|
||||
cp config.example.json config.json
|
||||
# 编辑 config.json 添加账号
|
||||
|
||||
每次请求服务会从中挑选一个。
|
||||
# 运行
|
||||
python dev.py
|
||||
```
|
||||
|
||||
## Vercel部署
|
||||
## ⚙️ 配置说明
|
||||
|
||||
> [!NOTE]
|
||||
> Vercel免费账户的请求响应超时时间为10秒，但接口响应通常较久，可能会遇到Vercel返回的504超时错误！
|
||||
### 环境变量
|
||||
|
||||
[](https://vercel.com/import/project?template=https://github.com/iidamie/deepseek2api)
|
||||
| 变量 | 说明 | 是否必填 |
|
||||
|-----|------|---------|
|
||||
| `DS2API_ADMIN_KEY` | WebUI 管理密码 | Vercel 必填 |
|
||||
| `DS2API_CONFIG_JSON` | 配置 JSON（支持 Base64） | 可选 |
|
||||
| `VERCEL_TOKEN` | Vercel API Token（用于快捷同步） | 可选 |
|
||||
| `VERCEL_PROJECT_ID` | Vercel 项目 ID | 可选 |
|
||||
|
||||
### 部署步骤
|
||||
|
||||
1. **点击上方按钮一键部署到 Vercel**
|
||||
|
||||
2. **配置方式选择（二选一）**
|
||||
|
||||
#### 方式 A：使用配置文件（推荐用于开发测试）
|
||||
|
||||
部署完成后，返回你的 Github 仓库，创建/编辑 `config.json` 文件（可参考 `config.example.json`）：
|
||||
### 配置文件格式
|
||||
|
||||
```json
|
||||
{
|
||||
"keys": [
|
||||
"your-api-key-1",
|
||||
"your-api-key-2"
|
||||
],
|
||||
"keys": ["your-api-key"],
|
||||
"accounts": [
|
||||
{
|
||||
"email": "example1@example.com",
|
||||
"password": "password1",
|
||||
"token": ""
|
||||
},
|
||||
{
|
||||
"email": "example2@example.com",
|
||||
"password": "password2",
|
||||
"token": ""
|
||||
},
|
||||
{
|
||||
"mobile": "12345678901",
|
||||
"password": "password3",
|
||||
"email": "your@email.com",
|
||||
"password": "your-password",
|
||||
"token": ""
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
配置完成后，返回 Vercel 控制台，点击 "Redeploy" 重新部署即可。
|
||||
|
||||
> [!WARNING]
|
||||
> 一定要是私库，防止信息泄露！
|
||||
|
||||
#### 方式 B：使用环境变量（推荐用于生产环境）
|
||||
|
||||
在 Vercel 控制台的 Settings → Environment Variables 中添加以下环境变量：
|
||||
|
||||
- **环境变量名**：`DS2API_CONFIG_JSON` 或 `CONFIG_JSON`
|
||||
- **环境变量值**：配置内容的 JSON 字符串（可选：使用 base64 编码）
|
||||
|
||||
**JSON 字符串示例**：
|
||||
```json
|
||||
{"keys":["your-api-key-1"],"accounts":[{"email":"example@example.com","password":"your-password","token":""}]}
|
||||
```
|
||||
|
||||
**Base64 编码示例**（Linux/Mac）：
|
||||
```bash
|
||||
echo '{"keys":["your-api-key-1"],"accounts":[{"email":"example@example.com","password":"your-password","token":""}]}' | base64
|
||||
```
|
||||
|
||||
添加环境变量后，在 Vercel 控制台重新部署即可。
|
||||
|
||||
### 配置说明
|
||||
|
||||
* `keys` - 你的 API 鉴权密钥（可设置多个）
|
||||
* `accounts` - DeepSeek 账号列表，支持多个账号轮换，避免单账号受限
|
||||
* 支持使用 `email` 或 `mobile` 登录
|
||||
* `token` 字段可以留空，系统会在首次使用时自动登录并填充（注意：Vercel 环境下 token 无法回写）
|
||||
|
||||
### 注意事项
|
||||
|
||||
- 推荐使用**环境变量**方式配置，更加安全
|
||||
- 如使用配置文件方式，确保你的 GitHub 仓库是**私有仓库**
|
||||
- Vercel 免费版有请求时长限制（10秒），如遇 504 错误属正常现象
|
||||
- Vercel 环境下文件系统是只读的，token 自动更新功能可能受限
|
||||
|
||||
## 接口列表
|
||||
|
||||
目前支持与openai兼容的 `/v1/chat/completions` 接口，可自行使用与openai或其他兼容的客户端接入接口。
|
||||
## 📡 API 接口
|
||||
|
||||
### 模型列表
|
||||
|
||||
获取模型列表接口
|
||||
|
||||
**GET /v1/models**
|
||||
|
||||
响应数据:
|
||||
```json
|
||||
{
|
||||
"data": [
|
||||
{
|
||||
"created": 1677610602,
|
||||
"id": "deepseek-chat",
|
||||
"object": "model",
|
||||
"owned_by": "deepseek",
|
||||
"permission": []
|
||||
},
|
||||
{
|
||||
"created": 1677610602,
|
||||
"id": "deepseek-reasoner",
|
||||
"object": "model",
|
||||
"owned_by": "deepseek",
|
||||
"permission": []
|
||||
},
|
||||
{
|
||||
"created": 1677610602,
|
||||
"id": "deepseek-chat-search",
|
||||
"object": "model",
|
||||
"owned_by": "deepseek",
|
||||
"permission": []
|
||||
},
|
||||
{
|
||||
"created": 1677610602,
|
||||
"id": "deepseek-reasoner-search",
|
||||
"object": "model",
|
||||
"owned_by": "deepseek",
|
||||
"permission": []
|
||||
}
|
||||
],
|
||||
"object": "list"
|
||||
}
|
||||
```
|
||||
GET /v1/models
|
||||
```
|
||||
|
||||
### 对话补全
|
||||
|
||||
对话补全接口，与openai的 [chat-completions-api](https://platform.openai.com/docs/guides/text-generation/chat-completions-api) 兼容。
|
||||
|
||||
**POST /v1/chat/completions**
|
||||
|
||||
header 需要设置 Authorization 头部：
|
||||
|
||||
```
|
||||
Authorization: Bearer [userToken value or keys]
|
||||
POST /v1/chat/completions
|
||||
Authorization: Bearer your-api-key
|
||||
```
|
||||
|
||||
请求数据：
|
||||
请求示例：
|
||||
|
||||
```json
|
||||
{
|
||||
// model名称
|
||||
// 默认：deepseek-chat 或 deepseek-v3
|
||||
// 深度思考：deepseek-reasoner 或 deepseek-r1
|
||||
// 联网搜索：deepseek-chat-search 或 deepseek-v3-search
|
||||
// 联网搜索 + 深度思考：deepseek-reasoner-search 或 deepseek-r1-search
|
||||
"model": "deepseek-chat",
|
||||
// 多轮对话基于消息合并实现，某些场景可能导致能力下降且受单轮最大token数限制
|
||||
"messages": [
|
||||
{
|
||||
"role": "user",
|
||||
"content": "你是谁？"
|
||||
}
|
||||
],
|
||||
// 如果使用流式响应请设置为true，默认false
|
||||
"stream": false
|
||||
"model": "deepseek-chat",
|
||||
"messages": [{"role": "user", "content": "你好"}],
|
||||
"stream": true
|
||||
}
|
||||
```
|
||||
|
||||
响应数据：
|
||||
```json
|
||||
{
|
||||
"choices": [
|
||||
{
|
||||
"finish_reason": "stop",
|
||||
"index": 0,
|
||||
"message": {
|
||||
"content": "您好！我是由中国的深度求索（DeepSeek）公司开发的智能助手DeepSeek-R1。如您有任何任何问题，我会尽我所能为您提供帮助。",
|
||||
"reasoning_content": "您好！我是由中国的深度求索（DeepSeek）公司开发的智能助手DeepSeek-R1。如您有任何任何问题，我会尽我所能为您提供帮助。\n",
|
||||
"role": "assistant"
|
||||
}
|
||||
}
|
||||
],
|
||||
"created": 1738598554,
|
||||
"id": "bc223da6-f091-4687-9f59-b9f2a917bd49",
|
||||
"model": "deepseek-r1",
|
||||
"object": "chat.completion",
|
||||
"usage": {
|
||||
"completion_tokens": 37,
|
||||
"prompt_tokens": 1,
|
||||
"total_tokens": 38
|
||||
}
|
||||
}
|
||||
```
|
||||
### 管理接口
|
||||
|
||||
## 注意事项
|
||||
| 接口 | 说明 |
|
||||
|-----|------|
|
||||
| `GET /webui` | 管理界面 |
|
||||
| `GET /admin/config` | 获取配置 |
|
||||
| `POST /admin/accounts/test` | 测试单个账号 |
|
||||
| `POST /admin/accounts/test-all` | 批量测试账号 |
|
||||
| `POST /admin/vercel/sync` | 同步到 Vercel |
|
||||
|
||||
### Nginx反代优化
|
||||
|
||||
如果您正在使用Nginx反向代理deepseek2api，请添加以下配置项优化流的输出效果，优化体验感。
|
||||
## 🔧 Nginx 反代配置
|
||||
|
||||
```nginx
|
||||
# 关闭代理缓冲。当设置为off时，Nginx会立即将客户端请求发送到后端服务器，并立即将从后端服务器接收到的响应发送回客户端。
|
||||
proxy_buffering off;
|
||||
# 启用分块传输编码。分块传输编码允许服务器为动态生成的内容分块发送数据，而不需要预先知道内容的大小。
|
||||
chunked_transfer_encoding on;
|
||||
# 开启TCP_NOPUSH，这告诉Nginx在数据包发送到客户端之前，尽可能地发送数据。这通常在sendfile使用时配合使用，可以提高网络效率。
|
||||
tcp_nopush on;
|
||||
# 开启TCP_NODELAY，这告诉Nginx不延迟发送数据，立即发送小数据包。在某些情况下，这可以减少网络的延迟。
|
||||
tcp_nodelay on;
|
||||
# 设置保持连接的超时时间，这里设置为120秒。如果在这段时间内，客户端和服务器之间没有进一步的通信，连接将被关闭。
|
||||
keepalive_timeout 120;
|
||||
```
|
||||
|
||||
### Token统计
|
||||
|
||||
符合 OPENAI 接口规范
|
||||
|
||||
示例:
|
||||
```json
|
||||
"usage": {
|
||||
"completion_tokens": 37,
|
||||
"prompt_tokens": 1,
|
||||
"total_tokens": 38
|
||||
location / {
|
||||
proxy_pass http://localhost:5001;
|
||||
proxy_buffering off;
|
||||
chunked_transfer_encoding on;
|
||||
tcp_nopush on;
|
||||
tcp_nodelay on;
|
||||
keepalive_timeout 120;
|
||||
}
|
||||
```
|
||||
|
||||
## Star History
|
||||
## ⚠️ 免责声明
|
||||
|
||||
[](https://star-history.com/#iidamie/deepseek2api&Date)
|
||||
**逆向 API 不稳定，建议前往 [DeepSeek 官方](https://platform.deepseek.com/) 付费使用 API。**
|
||||
|
||||
## 鸣谢
|
||||
**本项目仅供学习交流，禁止商用或对外提供服务，风险自担！**
|
||||
|
||||
本项目部分代码参考了 [LLM-Red-Team/deepseek-free-api](https://github.com/LLM-Red-Team/deepseek-free-api)，在此表示感谢
|
||||
## 📜 鸣谢
|
||||
|
||||
本项目基于以下开源项目并进行了大量修改：
|
||||
|
||||
- [iidamie/deepseek2api](https://github.com/iidamie/deepseek2api) - 二开版本
|
||||
- [LLM-Red-Team/deepseek-free-api](https://github.com/LLM-Red-Team/deepseek-free-api) - 早期原始项目
|
||||
|
||||
## 📊 Star History
|
||||
|
||||
[](https://star-history.com/#CJackHwang/ds2api&Date)
|
||||
|
||||
Reference in New Issue
Block a user