打赏

**DS2API 项目新手完整教程：零基础把 DeepSeek 聊天能力变成 OpenAI / Claude / Gemini 兼容 API**

DS2API 项目新手完整教程：零基础把 DeepSeek 聊天能力变成 OpenAI / Claude / Gemini 兼容 API

大家好！如果你是第一次接触这个项目，别担心——这篇教程就是为完全新手准备的。我会用最简单、最详细的语言，一步一步带你从“完全不懂”走到“能正常使用”。

1. 先搞清楚：DS2API 到底是干什么的？

简单来说：
DS2API 是一个“中间件”（就像一个翻译器 + 流量管家）。它把 DeepSeek 官网的网页聊天功能，包装成标准的 OpenAI、Claude、Gemini API 接口。

这样你就可以：

  • 用熟悉的 OpenAI Python/JS SDK 直接调用 DeepSeek 模型
  • 在 Cursor、Windsurf、Claude Desktop、LangChain、OpenWebUI 等工具里直接选 DeepSeek 模型
  • 实现高并发、多账号轮询、自动 Token 刷新、Tool Calling 等高级功能

一句话总结：它让你用 DeepSeek 像用 ChatGPT 官方 API 一样方便，而且支持更多协议和并发控制。

项目地址：https://github.com/CJackHwang/ds2api（Go 语言开发，性能很高）

2. 你需要准备什么？（超低门槛）

最推荐的方式（新手首选）：

  • 一台能运行 Docker 的电脑/服务器（Windows、Mac、Linux 都行）
  • DeepSeek 账号（邮箱或手机号 + 密码）

可选：

  • 如果你想自己编译代码，需要安装 Go 1.23+（不推荐新手第一步这么做）

3. 最简单部署方式：Docker 一键启动（推荐 99% 新手）

步骤 1：下载项目文件

打开终端（命令行），执行：

git clone https://github.com/CJackHwang/ds2api.git
cd ds2api

步骤 2：复制配置文件

cp .env.example .env
cp config.example.json config.json

步骤 3：编辑 config.json（最重要！）

用 VS Code 或任何文本编辑器打开 config.json，把里面的内容改成你的真实信息：

{
  "_comment": "DS2API 配置文件 - 新手请认真看注释",
  "keys": [
    "sk-1234567890abcdef"          // ← 这里填你自己定义的 API Key（给客户端用的）
  ],
  "api_keys": [
    {
      "key": "sk-1234567890abcdef",
      "name": "我的主Key",
      "remark": "给 Cursor / Claude Desktop 用"
    }
  ],
  "accounts": [
    {
      "name": "主账号",
      "email": "你的邮箱@example.com",     // 用邮箱登录
      "password": "你的DeepSeek密码"
    }
    // 可以继续加第二个、第三个账号，实现轮询
  ],
  "model_aliases": {                     // 模型别名（超级实用！）
    "gpt-4o": "deepseek-v4-flash",
    "gpt-5": "deepseek-v4-pro",
    "claude-3-5-sonnet": "deepseek-v4-flash",
    "gemini-2.5-pro": "deepseek-v4-pro"
  },
  "runtime": {
    "account_max_inflight": 2,           // 每个账号同时最多跑 2 个请求
    "account_max_queue": 5               // 排队上限
  }
}

小贴士：

  • keys 是你给外部客户端用的密钥（可以随便写）
  • accounts 里填你的 DeepSeek 真实账号（支持邮箱和手机号）
  • model_aliases 让你可以用 gpt-4o、claude-3-5-sonnet 等熟悉的名字调用 DeepSeek

步骤 4：启动 Docker

docker-compose up -d

看到类似 ds2api-ds2api-1 启动成功的提示就行了！

服务默认运行在 http://localhost:6011

4. 验证是否成功

打开浏览器访问以下地址：

如果都能正常返回，恭喜你！部署成功了 🎉

5. 管理后台 WebUI（超级好用）

访问：http://localhost:6011/admin

第一次进入需要登录，默认管理员密码在启动日志里（或通过环境变量 DS2API_ADMIN_KEY 设置）。

在管理后台你可以：

  • 查看实时并发队列
  • 添加/删除 DeepSeek 账号
  • 热更新配置（不用重启）
  • 测试账号是否可用
  • 管理聊天记录
  • 抓包调试（开发者模式）

6. 如何在各种工具里使用？

示例 1：Python OpenAI SDK（最常见）

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:6011/v1",   # 改成你的 ds2api 地址
    api_key="sk-1234567890abcdef"          # config.json 里填的 key
)

response = client.chat.completions.create(
    model="gpt-4o",                        # 会自动映射成 deepseek-v4-flash
    messages=[{"role": "user", "content": "你好！"}],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content or "", end="")

示例 2：Claude SDK / Cursor / Windsurf

把 base_url 改成 http://localhost:6011/anthropic/v1 或直接用 /v1/messages 快捷方式，model 填 claude-3-5-sonnet 即可。

示例 3：Gemini SDK

使用 /v1beta/models/gemini-2.5-pro:streamGenerateContent 路径即可。

7. 进阶功能快速了解（新手也可以慢慢玩）

  • Thinking 思考模式：deepseek-v4-flash 默认开启思考，-nothinking 后缀可强制关闭
  • Tool Calling：支持结构化工具调用（自动防泄漏）
  • 多账号轮询：加多个账号实现负载均衡
  • 并发控制：防止被 DeepSeek 限流
  • Vercel / Zeabur 一键部署：项目支持 Serverless 部署（适合不想开服务器的人）

8. 常见问题 & 解决办法

Q1：启动报错 config.json 找不到？
→ 确认文件在项目根目录，且命名为 config.json

Q2：账号登录失败？
→ 检查密码是否正确；DeepSeek 网页版能正常登录就行；建议先用一个账号测试

Q3：并发太慢？
→ 增加 accounts 数量，或调高 account_max_inflight

Q4：想在公网使用？
→ 用 Nginx 反向代理 + HTTPS（教程很多），或直接部署到 Vercel/Zeabur

9. 最后提醒

  • 本项目仅供个人学习、研究、内部使用，请遵守 DeepSeek 服务条款
  • 作者不提供商业授权，也不承担任何使用导致的责任
  • 有问题可以去 GitHub Issues 提（记得先看 README 和 API.md）

恭喜你！
现在你已经掌握了 DS2API 的完整使用流程。
从今天开始，你可以用 OpenAI 的方式愉快地调用 DeepSeek 的强大模型了！

有任何一步卡住了，欢迎在评论区留言，我会尽量帮你解答。
祝你玩得开心，AI 玩得飞起！🚀

（教程基于 2026 年最新版本编写，项目持续更新，建议关注 GitHub 仓库）

posted @ 2026-05-03 16:58  gyc567  阅读(2162)  评论(0)    收藏  举报