{"id":20523077,"url":"https://github.com/llm-red-team/deepseek-free-api","last_synced_at":"2025-05-14T03:07:46.472Z","repository":{"id":238635143,"uuid":"797069797","full_name":"LLM-Red-Team/deepseek-free-api","owner":"LLM-Red-Team","description":"🚀 DeepSeek-V3 \u0026 R1大模型逆向API【特长：良心厂商】（官方贼便宜，建议直接走官方），支持高速流式输出、多轮对话，联网搜索，R1深度思考，零配置部署，多路token支持，仅供测试，如需商用请前往官方开放平台。","archived":false,"fork":false,"pushed_at":"2025-04-08T01:44:36.000Z","size":656,"stargazers_count":2366,"open_issues_count":27,"forks_count":687,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-04-14T02:57:13.181Z","etag":null,"topics":["chat-api","chatbot","chatgpt-api","deepseek","deepseek-api","deepseek-chat","deepseek-r1","deepseek-v3","llm"],"latest_commit_sha":null,"homepage":"https://platform.deepseek.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LLM-Red-Team.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-07T06:23:37.000Z","updated_at":"2025-04-13T17:12:52.000Z","dependencies_parsed_at":"2024-06-20T19:40:50.849Z","dependency_job_id":"73533686-3b40-44fd-bb49-44d258b4f1ce","html_url":"https://github.com/LLM-Red-Team/deepseek-free-api","commit_stats":{"total_commits":19,"total_committers":2,"mean_commits":9.5,"dds":"0.052631578947368474","last_synced_commit":"3c4013582d8beb2d86255df35471d4225c268947"},"previous_names":["llm-red-team/deepseek-free-api"],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLM-Red-Team%2Fdeepseek-free-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLM-Red-Team%2Fdeepseek-free-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLM-Red-Team%2Fdeepseek-free-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLM-Red-Team%2Fdeepseek-free-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LLM-Red-Team","download_url":"https://codeload.github.com/LLM-Red-Team/deepseek-free-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248813786,"owners_count":21165632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chat-api","chatbot","chatgpt-api","deepseek","deepseek-api","deepseek-chat","deepseek-r1","deepseek-v3","llm"],"created_at":"2024-11-15T22:37:53.956Z","updated_at":"2025-04-14T02:57:19.522Z","avatar_url":"https://github.com/LLM-Red-Team.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DeepSeek V3 Free 服务\n\n\u003cspan\u003e[ 中文 | \u003ca href=\"README_EN.md\"\u003eEnglish\u003c/a\u003e ]\u003c/span\u003e\n\n[![](https://img.shields.io/github/license/llm-red-team/deepseek-free-api.svg)](LICENSE)\n![](https://img.shields.io/github/stars/llm-red-team/deepseek-free-api.svg)\n![](https://img.shields.io/github/forks/llm-red-team/deepseek-free-api.svg)\n![](https://img.shields.io/docker/pulls/vinlic/deepseek-free-api.svg)\n\n# 风险警告\n\n## **近期，我们发现部分自媒体引导用户将本仓库源码或镜像部署至非个人使用渠道，并公开提供服务。此行为可能违反了DeepSeek的[《用户协议》](https://chat.deepseek.com/downloads/DeepSeek%20Terms%20of%20Use.html)。我们特此提醒，请相关自媒体和个人立即停止此类不当行为。若持续违规，DeepSeek官方将保留依法追究其法律责任的权利。**\n\n支持高速流式输出、支持多轮对话、支持联网搜索、支持R1深度思考和静默深度思考，零配置部署，多路token支持。\n\n与ChatGPT接口完全兼容。\n\n还有以下十个free-api欢迎关注：\n\nMoonshot AI（Kimi.ai）接口转API [kimi-free-api](https://github.com/LLM-Red-Team/kimi-free-api)\n\n智谱AI (智谱清言) 接口转API [glm-free-api](https://github.com/LLM-Red-Team/glm-free-api)\n\n阶跃星辰 (跃问StepChat) 接口转API [step-free-api](https://github.com/LLM-Red-Team/step-free-api)\n\n阿里通义 (Qwen) 接口转API [qwen-free-api](https://github.com/LLM-Red-Team/qwen-free-api)\n\n秘塔AI (Metaso) 接口转API [metaso-free-api](https://github.com/LLM-Red-Team/metaso-free-api)\n\n字节跳动（豆包）接口转API [doubao-free-api](https://github.com/LLM-Red-Team/doubao-free-api)\n\n字节跳动（即梦AI）接口转API [jimeng-free-api](https://github.com/LLM-Red-Team/jimeng-free-api)\n\n讯飞星火（Spark）接口转API [spark-free-api](https://github.com/LLM-Red-Team/spark-free-api)\n\nMiniMax（海螺AI）接口转API [hailuo-free-api](https://github.com/LLM-Red-Team/hailuo-free-api)\n\n聆心智能 (Emohaa) 接口转API [emohaa-free-api](https://github.com/LLM-Red-Team/emohaa-free-api)\n\n## 目录\n\n* [免责声明](#免责声明)\n* [效果示例](#效果示例)\n* [接入准备](#接入准备)\n  * [多账号接入](#多账号接入)\n* [Docker部署](#Docker部署)\n  * [Docker-compose部署](#Docker-compose部署)\n* [Render部署](#Render部署)\n* [Vercel部署](#Vercel部署)\n* [原生部署](#原生部署)\n* [推荐使用客户端](#推荐使用客户端)\n* [接口列表](#接口列表)\n  * [对话补全](#对话补全)\n  * [userToken存活检测](#userToken存活检测)\n* [注意事项](#注意事项)\n  * [Nginx反代优化](#Nginx反代优化)\n  * [Token统计](#Token统计)\n* [Star History](#star-history)\n  \n## 免责声明\n\n**逆向API是不稳定的，建议前往DeepSeek官方 https://platform.deepseek.com/ 付费使用API，避免封禁的风险。**\n\n**本组织和个人不接受任何资金捐助和交易，此项目是纯粹研究交流学习性质！**\n\n**仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！**\n\n**仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！**\n\n**仅限自用，禁止对外提供服务或商用，避免对官方造成服务压力，否则风险自担！**\n\n## 效果示例\n\n### 验明正身Demo\n\n![验明正身](./doc/example-1.png)\n\n### 多轮对话Demo\n\n![多轮对话](./doc/example-2.png)\n\n### 联网搜索Demo\n\n![联网搜索](./doc/example-3.png)\n\n## 接入准备\n\n请确保您在中国境内或者拥有中国境内的个人计算设备，否则部署后可能因无法访问DeepSeek而无法使用。\n\n从 [DeepSeek](https://chat.deepseek.com/) 获取userToken value\n\n进入DeepSeek随便发起一个对话，然后F12打开开发者工具，从Application \u003e LocalStorage中找到`userToken`中的value值，这将作为Authorization的Bearer Token值：`Authorization: Bearer TOKEN`\n\n![获取userToken](./doc/example-0.png)\n\n### 多账号接入\n\n目前同个账号同时只能有*一路*输出，你可以通过提供多个账号的userToken value并使用`,`拼接提供：\n\n`Authorization: Bearer TOKEN1,TOKEN2,TOKEN3`\n\n每次请求服务会从中挑选一个。\n\n### 环境变量（可选）\n\n| 环境变量 | 是否必填 | 说明                               |\n|------|------|----------------------------------|\n|  DEEP_SEEK_CHAT_AUTHORIZATION   | 否    | 当配置了token 则使用token，未配置则需要在请求头中传递Authorization |\n\n## Docker部署\n\n拉取镜像并启动服务。\n\n```shell\ndocker run -it -d --init --name deepseek-free-api -p 8000:8000 -e TZ=Asia/Shanghai  vinlic/deepseek-free-api:latest\n# 或将token配置在环境变量\ndocker run -it -d --init --name deepseek-free-api -p 8000:8000 -e TZ=Asia/Shanghai -e DEEP_SEEK_CHAT_AUTHORIZATION=xxx  vinlic/deepseek-free-api:latest\n```\n\n查看服务实时日志\n\n```shell\ndocker logs -f deepseek-free-api\n```\n\n重启服务\n\n```shell\ndocker restart deepseek-free-api\n```\n\n停止服务\n\n```shell\ndocker stop deepseek-free-api\n```\n\n### Docker-compose部署\n\n```yaml\nversion: '3'\n\nservices:\n  deepseek-free-api:\n    container_name: deepseek-free-api\n    image: vinlic/deepseek-free-api:latest\n    restart: always\n    ports:\n      - \"8000:8000\"\n    environment:\n      - TZ=Asia/Shanghai\n```\n\n### Render部署\n\n**注意：部分部署区域可能无法连接deepseek，如容器日志出现请求超时或无法连接，请切换其他区域部署！**\n**注意：免费账户的容器实例将在一段时间不活动时自动停止运行，这会导致下次请求时遇到50秒或更长的延迟，建议查看[Render容器保活](https://github.com/LLM-Red-Team/free-api-hub/#Render%E5%AE%B9%E5%99%A8%E4%BF%9D%E6%B4%BB)**\n\n1. fork本项目到你的github账号下。\n\n2. 访问 [Render](https://dashboard.render.com/) 并登录你的github账号。\n\n3. 构建你的 Web Service（New+ -\u003e Build and deploy from a Git repository -\u003e Connect你fork的项目 -\u003e 选择部署区域 -\u003e 选择实例类型为Free -\u003e Create Web Service）。\n\n4. 等待构建完成后，复制分配的域名并拼接URL访问即可。\n\n### Vercel部署\n\n**注意：Vercel免费账户的请求响应超时时间为10秒，但接口响应通常较久，可能会遇到Vercel返回的504超时错误！**\n\n请先确保安装了Node.js环境。\n\n```shell\nnpm i -g vercel --registry http://registry.npmmirror.com\nvercel login\ngit clone https://github.com/LLM-Red-Team/deepseek-free-api\ncd deepseek-free-api\nvercel --prod\n```\n\n## 原生部署\n\n请先安装好Node.js环境并且配置好环境变量，确认node命令可用。\n\n安装依赖\n\n```shell\nnpm i\n```\n\n安装PM2进行进程守护\n\n```shell\nnpm i -g pm2\n```\n\n编译构建，看到dist目录就是构建完成\n\n```shell\nnpm run build\n```\n\n启动服务\n\n```shell\npm2 start dist/index.js --name \"deepseek-free-api\"\n```\n\n查看服务实时日志\n\n```shell\npm2 logs deepseek-free-api\n```\n\n重启服务\n\n```shell\npm2 reload deepseek-free-api\n```\n\n停止服务\n\n```shell\npm2 stop deepseek-free-api\n```\n\n## 推荐使用客户端\n\n使用以下二次开发客户端接入free-api系列项目更快更简单，支持文档/图像上传！\n\n由 [Clivia](https://github.com/Yanyutin753/lobe-chat) 二次开发的LobeChat [https://github.com/Yanyutin753/lobe-chat](https://github.com/Yanyutin753/lobe-chat)\n\n由 [时光@](https://github.com/SuYxh) 二次开发的ChatGPT Web [https://github.com/SuYxh/chatgpt-web-sea](https://github.com/SuYxh/chatgpt-web-sea)\n\n## 接口列表\n\n目前支持与openai兼容的 `/v1/chat/completions` 接口，可自行使用与openai或其他兼容的客户端接入接口，或者使用 [dify](https://dify.ai/) 等线上服务接入使用。\n\n### 对话补全\n\n对话补全接口，与openai的 [chat-completions-api](https://platform.openai.com/docs/guides/text-generation/chat-completions-api) 兼容。\n\n**POST /v1/chat/completions**\n\nheader 需要设置 Authorization 头部：\n\n```\nAuthorization: Bearer [userToken value]\n```\n\n请求数据：\n```json\n{\n    // model名称\n    // 默认：deepseek\n    // 深度思考：deepseek-think 或 deepseek-r1\n    // 联网搜索：deepseek-search\n    // 深度思考+联网搜索：deepseek-r1-search 或 deepseek-think-search\n    // 静默模式（不输出思考过程或联网搜索结果）：deepseek-think-silent 或 deepseek-r1-silent 或 deepseek-search-silent\n    // 深度思考但思考过程使用\u003cdetails\u003e可折叠标签包裹（需要页面支持显示）：deepseek-think-fold 或 deepseek-r1-fold\n    \"model\": \"deepseek\",\n    // 默认多轮对话基于消息合并实现，某些场景可能导致能力下降且受单轮最大token数限制\n    // 如果您想获得原生的多轮对话体验，可以传入上一轮消息获得的id，来接续上下文\n    // \"conversation_id\": \"50207e56-747e-4800-9068-c6fd618374ee@2\",\n    \"messages\": [\n        {\n            \"role\": \"user\",\n            \"content\": \"你是谁？\"\n        }\n    ],\n    // 如果使用流式响应请设置为true，默认false\n    \"stream\": false\n}\n```\n\n响应数据：\n```json\n{\n    \"id\": \"50207e56-747e-4800-9068-c6fd618374ee@2\",\n    \"model\": \"deepseek\",\n    \"object\": \"chat.completion\",\n    \"choices\": [\n        {\n            \"index\": 0,\n            \"message\": {\n                \"role\": \"assistant\",\n                \"content\": \" 我是DeepSeek Chat，一个由深度求索公司开发的智能助手，旨在通过自然语言处理和机器学习技术来提供信息查询、对话交流和解答问题等服务。\"\n            },\n            \"finish_reason\": \"stop\"\n        }\n    ],\n    \"usage\": {\n        \"prompt_tokens\": 1,\n        \"completion_tokens\": 1,\n        \"total_tokens\": 2\n    },\n    \"created\": 1715061432\n}\n```\n\n### userToken存活检测\n\n检测userToken是否存活，如果存活live为true，否则为false，请不要频繁（小于10分钟）调用此接口。\n\n**POST /token/check**\n\n请求数据：\n```json\n{\n    \"token\": \"eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9...\"\n}\n```\n\n响应数据：\n```json\n{\n    \"live\": true\n}\n```\n\n## 注意事项\n\n### Nginx反代优化\n\n如果您正在使用Nginx反向代理deepseek-free-api，请添加以下配置项优化流的输出效果，优化体验感。\n\n```nginx\n# 关闭代理缓冲。当设置为off时，Nginx会立即将客户端请求发送到后端服务器，并立即将从后端服务器接收到的响应发送回客户端。\nproxy_buffering off;\n# 启用分块传输编码。分块传输编码允许服务器为动态生成的内容分块发送数据，而不需要预先知道内容的大小。\nchunked_transfer_encoding on;\n# 开启TCP_NOPUSH，这告诉Nginx在数据包发送到客户端之前，尽可能地发送数据。这通常在sendfile使用时配合使用，可以提高网络效率。\ntcp_nopush on;\n# 开启TCP_NODELAY，这告诉Nginx不延迟发送数据，立即发送小数据包。在某些情况下，这可以减少网络的延迟。\ntcp_nodelay on;\n# 设置保持连接的超时时间，这里设置为120秒。如果在这段时间内，客户端和服务器之间没有进一步的通信，连接将被关闭。\nkeepalive_timeout 120;\n```\n\n### Token统计\n\n由于推理侧不在deepseek-free-api，因此token不可统计，将以固定数字返回。\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=LLM-Red-Team/deepseek-free-api\u0026type=Date)](https://star-history.com/#LLM-Red-Team/deepseek-free-api\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fllm-red-team%2Fdeepseek-free-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fllm-red-team%2Fdeepseek-free-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fllm-red-team%2Fdeepseek-free-api/lists"}