⚠️ 说明: 原项目llm-red-team/deepseek-free-api已归档停止维护。本项目为 接替维护版本，旨在修复因 DeepSeek 官网更新导致的协议不兼容问题（如ERR_INVALID_CHAR和FINISHED状态码泄露），确保服务持续可用。
[ 中文 | English ]
本项目是基于 DeepSeek 服务的 API 适配器，而更强大的 AI 体验离不开优秀的前端界面。
如果你正在寻找如何更好地使用 Open WebUI，或者发现更多实用的 AI 插件与工具，欢迎访问我的核心项目：
汇集了 Open WebUI 的最佳实践、插件、教程与资源。如果你觉得本项目解决了你的燃眉之急，不妨去那里点个 Star ⭐️ 支持一下！
- 兼容性修复 (2025-02-11): 修复了因 DeepSeek 官网更新导致的
X-App-Version获取异常（ERR_INVALID_CHAR）的问题。 - 响应净化: 彻底解决了响应中偶现
FINISHED状态码泄露到正文的问题，现在通过严格的路径校验（Strict Path Validation）确保输出内容的纯净。 - 历史记录修复: 自动清理历史对话中可能存在的
FINISHED脏数据，防止上下文污染。 - R1 搜索支持 (2025-02-12): 完美适配 DeepSeek R1 模型的联网搜索功能。
- 自动解析并合并分段搜索结果。
- 引用（Citations）将以
**1.** [标题](链接)格式附加在回复末尾，确保在所有客户端可见。 - 过滤掉 "SEARCH" 等元数据干扰，提供纯净的输出体验。
- 深度思考协议适配 (2025-02-24): 针对 DeepSeek 官网最新的 Fragment-based 协议 进行了深度适配 (v1.0.2)。
- 完美解决 R1 模型思考过程（Thinking/Reasoning Content）与正式回答混淆的问题。
- 实现了基于 Fragment 类型的实时状态追踪，确保思考过程被正确放入
reasoning_content字段。 - 优化了“粘性路径”解析，显著提升了流式输出的稳定性。
近期，我们发现部分自媒体引导用户将本仓库源码或镜像部署至非个人使用渠道，并公开提供服务。此行为可能违反了DeepSeek的《用户协议》。我们特此提醒，请相关自媒体和个人立即停止此类不当行为。若持续违规，DeepSeek官方将保留依法追究其法律责任的权利。
支持高速流式输出、支持多轮对话、支持联网搜索、支持R1深度思考和静默深度思考，零配置部署，多路token支持。
与ChatGPT接口完全兼容。
逆向API是不稳定的，建议前往DeepSeek官方 https://platform.deepseek.com/ 付费使用API，避免封禁的风险。
本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！
仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！
仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！
仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！
请确保您在中国境内或者拥有中国境内的个人计算设备，否则部署后可能因无法访问DeepSeek而无法使用。
从 DeepSeek 获取userToken value
进入DeepSeek随便发起一个对话，然后F12打开开发者工具，从Application > LocalStorage中找到userToken中的value值，这将作为Authorization的Bearer Token值：Authorization: Bearer TOKEN
目前同个账号同时只能有一路输出，你可以通过提供多个账号的userToken value并使用,拼接提供：
Authorization: Bearer TOKEN1,TOKEN2,TOKEN3
每次请求服务会从中挑选一个。
| 环境变量 | 是否必填 | 说明 |
|---|---|---|
| DEEP_SEEK_CHAT_AUTHORIZATION | 否 | 当配置了token 则使用token，未配置则需要在请求头中传递Authorization |
我们提供自动构建的 Docker 镜像，支持 x86_64 和 ARM64 架构。
创建一个 docker-compose.yml 文件：
version: '3'
services:
deepseek-free-api:
container_name: deepseek-free-api
image: ghcr.io/fu-jie/deepseek-free-api:latest
restart: always
ports:
- "8000:8000"
environment:
- TZ=Asia/Shanghai启动服务：
docker compose up -ddocker run -it -d --init --name deepseek-free-api -p 8000:8000 -e TZ=Asia/Shanghai ghcr.io/fu-jie/deepseek-free-api:latest注意：部分部署区域可能无法连接deepseek，如容器日志出现请求超时或无法连接，请切换其他区域部署！ 注意：免费账户的容器实例将在一段时间不活动时自动停止运行，这会导致下次请求时遇到50秒或更长的延迟，建议查看Render容器保活
-
fork本项目到你的github账号下。
-
访问 Render 并登录你的github账号。
-
构建你的 Web Service（New+ -> Build and deploy from a Git repository -> Connect你fork的项目 -> 选择部署区域 -> 选择实例类型为Free -> Create Web Service）。
-
等待构建完成后，复制分配的域名并拼接URL访问即可。
使用以下二次开发客户端接入free-api系列项目更快更简单，支持文档/图像上传！
由 Clivia 二次开发的LobeChat https://github.com/Yanyutin753/lobe-chat
由 时光@ 二次开发的ChatGPT Web https://github.com/SuYxh/chatgpt-web-sea
目前支持与openai兼容的 /v1/chat/completions 接口，可自行使用与openai或其他兼容的客户端接入接口，或者使用 dify 等线上服务接入使用。
对话补全接口，与openai的 chat-completions-api 兼容。
POST /v1/chat/completions
header 需要设置 Authorization 头部：
Authorization: Bearer [userToken value]
请求数据：
{
// model名称
// 默认：deepseek
// 深度思考：deepseek-think 或 deepseek-r1
// 联网搜索：deepseek-search
// 深度思考+联网搜索：deepseek-r1-search (推荐) 或 deepseek-think-search
// 注意：搜索结果将自动以加粗数字列表形式附加在回复末尾
// 静默模式（不输出思考过程或联网搜索结果）：deepseek-think-silent 或 deepseek-r1-silent 或 deepseek-search-silent
// 深度思考但思考过程使用<details>可折叠标签包裹（需要页面支持显示）：deepseek-think-fold 或 deepseek-r1-fold
"model": "deepseek",
// 默认多轮对话基于消息合并实现，某些场景可能导致能力下降且受单轮最大token数限制
// 如果您想获得原生的多轮对话体验，可以传入上一轮消息获得的id，来接续上下文
// "conversation_id": "50207e56-747e-4800-9068-c6fd618374ee@2",
"messages": [
{
"role": "user",
"content": "你是谁？"
}
],
// 如果使用流式响应请设置为true，默认false
"stream": false
}响应数据：
{
"id": "50207e56-747e-4800-9068-c6fd618374ee@2",
"model": "deepseek",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": " 我是DeepSeek Chat，一个由深度求索公司开发的智能助手，旨在通过自然语言处理和机器学习技术来提供信息查询、对话交流和解答问题等服务。"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 1,
"completion_tokens": 1,
"total_tokens": 2
},
"created": 1715061432
}检测userToken是否存活，如果存活live为true，否则为false，请不要频繁（小于10分钟）调用此接口。
POST /token/check
请求数据：
{
"token": "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9..."
}响应数据：
{
"live": true
}如果您正在使用Nginx反向代理deepseek-free-api，请添加以下配置项优化流的输出效果，优化体验感。
# 关闭代理缓冲。当设置为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;由于推理侧不在deepseek-free-api，因此token不可统计，将以固定数字返回。