mirror of
https://github.com/CJackHwang/ds2api.git
synced 2026-05-16 06:05:07 +08:00
CJackHwang
344
README.MD
Normal file
344
README.MD
Normal file
@@ -0,0 +1,344 @@
|
||||
# DeepSeek2API
|
||||
|
||||
[](LICENSE)
|
||||
|
||||
|
||||
|
||||
支持高速流式输出、支持多轮对话、支持R1深度思考，多路账号支持。
|
||||
|
||||
与ChatGPT接口完全兼容。
|
||||
|
||||
## 目录
|
||||
|
||||
* [免责声明](#免责声明)
|
||||
* [接入准备](#接入准备)
|
||||
* [多账号接入](#多账号接入)
|
||||
* [Docker部署](#Docker部署)
|
||||
* [Docker-compose部署](#Docker-compose部署)
|
||||
* [Vercel部署](#Vercel部署)
|
||||
* [原生部署](#原生部署)
|
||||
* [接口列表](#接口列表)
|
||||
* [模型列表](#模型列表)
|
||||
* [对话补全](#对话补全)
|
||||
* [注意事项](#注意事项)
|
||||
* [Nginx反代优化](#Nginx反代优化)
|
||||
* [Token统计](#Token统计)
|
||||
* [Star History](#star-history)
|
||||
* [鸣谢](#鸣谢)
|
||||
|
||||
## 免责声明
|
||||
|
||||
**逆向API是不稳定的，建议前往DeepSeek官方 https://platform.deepseek.com/ 付费使用API，避免封禁的风险。**
|
||||
|
||||
**本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！**
|
||||
|
||||
**仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！**
|
||||
|
||||
**仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！**
|
||||
|
||||
**仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！**
|
||||
|
||||
## 接入准备
|
||||
|
||||
一个或多个 DeepSeek 账号
|
||||
|
||||
### 多账号接入
|
||||
|
||||
目前同个账号同时只能有*一路*输出，你可以通过提供多个账号并使用。
|
||||
|
||||
每次请求服务会从中挑选一个。
|
||||
|
||||
## Docker部署
|
||||
|
||||
请准备一台具有公网IP的服务器并将5001端口开放。
|
||||
|
||||
配置 config.json
|
||||
|
||||
在 `deepseek` 目录下，创建 config.json文件
|
||||
```json
|
||||
{
|
||||
"keys": [
|
||||
"key1",
|
||||
"key2"
|
||||
],
|
||||
"accounts": [
|
||||
{
|
||||
"email": "example1@example.com",
|
||||
"password": "password1",
|
||||
"token": ""
|
||||
},
|
||||
{
|
||||
"email": "example2@example.com",
|
||||
"password": "password2",
|
||||
"token": ""
|
||||
},
|
||||
{
|
||||
"mobile": "12345678901",
|
||||
"password": "password3",
|
||||
"token": ""
|
||||
},
|
||||
{
|
||||
"mobile": "12345678901",
|
||||
"password": "password4",
|
||||
"token": ""
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
* keys - 你的 API 鉴权密钥
|
||||
* accounts - DeepSeek 账号列表，支持多个账号轮换，避免单账号受限
|
||||
|
||||
拉取镜像并启动服务。
|
||||
|
||||
```shell
|
||||
docker run -d -p 5001:5001 -v "$(pwd)/config.json:/app/config.json" --name deepseek2api ghcr.io/iidamie/deepseek2api:latest
|
||||
```
|
||||
|
||||
查看服务实时日志
|
||||
|
||||
```shell
|
||||
docker logs -f deepseek2api
|
||||
```
|
||||
|
||||
重启服务
|
||||
|
||||
```shell
|
||||
docker restart deepseek2api
|
||||
```
|
||||
|
||||
停止服务
|
||||
|
||||
```shell
|
||||
docker stop deepseek2api
|
||||
```
|
||||
|
||||
## Docker-compose部署
|
||||
|
||||
拉取该项目
|
||||
```shell
|
||||
git clone https://github.com/iidamie/deepseek2api.git
|
||||
cd deepseek2api
|
||||
```
|
||||
配置 config.json
|
||||
|
||||
在当前目录下，修改 config.json 文件
|
||||
* keys - 你的 API 鉴权密钥
|
||||
* accounts - DeepSeek 账号列表，支持多个账号轮换，避免单账号受限
|
||||
|
||||
启动服务
|
||||
|
||||
```shell
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
查看服务实时日志
|
||||
|
||||
```shell
|
||||
docker logs -f deepseek2api
|
||||
```
|
||||
|
||||
重启服务
|
||||
|
||||
```shell
|
||||
docker restart deepseek2api
|
||||
```
|
||||
|
||||
停止服务
|
||||
|
||||
```shell
|
||||
docker stop deepseek2api
|
||||
```
|
||||
|
||||
## Vercel部署
|
||||
|
||||
> [!NOTE]
|
||||
> Vercel免费账户的请求响应超时时间为10秒，但接口响应通常较久，可能会遇到Vercel返回的504超时错误！
|
||||
|
||||
[](https://vercel.com/import/project?template=https://github.com/iidamie/deepseek2api)
|
||||
|
||||
部署完后，返回你的 Github 仓库配置 config.json
|
||||
* keys - 你的 API 鉴权密钥
|
||||
* accounts - DeepSeek 账号列表，支持多个账号轮换，避免单账号受限
|
||||
|
||||
> [!WARNING]
|
||||
> 一定要是私库，防止信息泄露！
|
||||
|
||||
配置完后，返回 Vercel 控制台，重新部署即可
|
||||
|
||||
## 原生部署
|
||||
|
||||
请准备一台具有公网IP的服务器并将5001端口开放。
|
||||
|
||||
请先安装好 Python 环境并且配置好环境变量，确认 python 命令可用。
|
||||
|
||||
安装依赖
|
||||
|
||||
```shell
|
||||
git clone https://github.com/iidamie/deepseek2api.git
|
||||
cd deepseek2api
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
配置 config.json
|
||||
|
||||
在当前目录下，修改 config.json 文件
|
||||
* keys - 你的 API 鉴权密钥
|
||||
* accounts - DeepSeek 账号列表，支持多个账号轮换，避免单账号受限
|
||||
|
||||
启动服务
|
||||
|
||||
```shell
|
||||
python app.py
|
||||
```
|
||||
|
||||
使用 nohup 启动
|
||||
|
||||
```shell
|
||||
nohup uvicorn app:app --host 0.0.0.0 --port 5001 > uvicorn.log 2>&1 &
|
||||
```
|
||||
|
||||
## 接口列表
|
||||
|
||||
目前支持与openai兼容的 `/v1/chat/completions` 接口，可自行使用与openai或其他兼容的客户端接入接口。
|
||||
|
||||
### 模型列表
|
||||
|
||||
获取模型列表接口
|
||||
|
||||
**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"
|
||||
}
|
||||
```
|
||||
|
||||
### 对话补全
|
||||
|
||||
对话补全接口，与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]
|
||||
```
|
||||
|
||||
请求数据：
|
||||
```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
|
||||
}
|
||||
```
|
||||
|
||||
响应数据：
|
||||
```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
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
### Nginx反代优化
|
||||
|
||||
如果您正在使用Nginx反向代理deepseek2api，请添加以下配置项优化流的输出效果，优化体验感。
|
||||
|
||||
```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
|
||||
}
|
||||
```
|
||||
|
||||
## Star History
|
||||
|
||||
[](https://star-history.com/#iidamie/deepseek2api&Date)
|
||||
|
||||
## 鸣谢
|
||||
|
||||
本项目部分代码参考了 [LLM-Red-Team/deepseek-free-api](https://github.com/LLM-Red-Team/deepseek-free-api)，在此表示感谢
|
||||
Reference in New Issue
Block a user