ds2api README

The project's README from github.com/CJackHwang/ds2api. As one markdown file: README.md.

DS2API icon

DS2API

CJackHwang%2Fds2api | Trendshift

License Stars Forks Release Docker

Deploy on Zeabur Deploy with Vercel

语言 / Language: 中文 | English

将 DeepSeek Web 对话能力转换为 OpenAI、Claude 与 Gemini 兼容 API。核心后端以 Go 实现，Vercel 流式桥接额外使用少量 Node Runtime，前端为 React WebUI 管理台（源码在 webui/，部署时自动构建到 static/admin）。

文档入口：文档导航 / 架构说明 / 接口文档

【感谢Linux.do社区及GitHub社区各位开发者对项目的支持与贡献】

Star History

Star History Chart

重要免责声明

本仓库仅供学习、研究、个人实验和内部验证使用，不提供任何形式的商业授权、适用性保证或结果保证。

作者及仓库维护者不对因使用、修改、分发、部署或依赖本项目而产生的任何直接或间接损失、账号封禁、数据丢失、法律风险或第三方索赔负责。

请勿将本项目用于违反服务条款、协议、法律法规或平台规则的场景。商业使用前请自行确认 LICENSE、相关协议以及你是否获得了作者的书面许可。

目录

架构概览（摘要）

flowchart LR
    Client["🖥️ 客户端 / SDK\n(OpenAI / Claude / Gemini)"]
    Upstream["☁️ DeepSeek API"]

    subgraph DS2API["DS2API 4.x（模块化 HTTP surface + PromptCompat 内核）"]
        Router["chi Router + 中间件\n(RequestID / RealIP / Logger / Recoverer / CORS)"]

        subgraph HTTP["HTTP API surface"]
            OA["OpenAI\nchat / responses / files / embeddings"]
            CA["Claude\n/anthropic/* + /v1/messages"]
            GA["Gemini\n/v1beta/models/* + /v1/models/*"]
            Admin["Admin API\n资源子包"]
            WebUI["WebUI\n/admin（静态托管）"]
            Vercel["Vercel Node Stream\n/v1/chat/completions"]
        end

        subgraph Runtime["运行时核心能力"]
            Compat["PromptCompat\n(API -> 网页纯文本上下文)"]
            Completion["Completion Runtime\n(Session / PoW / Completion)"]
            Turn["AssistantTurn\n(输出语义归一)"]
            Auth["Auth Resolver\n(API key / bearer / x-goog-api-key)"]
            Pool["Account Pool + Queue\n(并发槽位 + 等待队列)"]
            DSClient["DeepSeek Client\n(Session / Auth / Completion / Files)"]
            Pow["PoW 实现\n(纯 Go)"]
            Tool["Tool Sieve\n(Go/Node 语义对齐)"]
            History["Current Input File\n(DS2API_HISTORY.txt)"]
        end
    end

    Client --> Router
    Router --> OA & CA & GA
    Router --> Admin
    Router --> WebUI
    Router --> Vercel

    OA --> Compat
    CA & GA --> Compat
    Compat --> Completion
    Completion -.完整上下文.-> History
    Completion --> Turn
    Vercel -.Go prepare.-> Completion
    Vercel -.Node SSE.-> Tool
    Completion --> Auth
    Completion -.账号轮询.-> Pool
    Completion -.工具调用解析.-> Tool
    Completion -.PoW 计算.-> Pow
    Auth --> DSClient
    DSClient --> Upstream
    Upstream --> DSClient
    Turn --> Client
    Vercel --> Client

详细架构拆分与目录职责见 docs/ARCHITECTURE.md。

核心能力

能力 说明
OpenAI 兼容 GET /v1/models、GET /v1/models/{id}、POST /v1/chat/completions、POST /v1/responses、GET /v1/responses/{response_id}、POST /v1/embeddings、POST /v1/files、GET /v1/files/{file_id}
Claude 兼容 GET /anthropic/v1/models、POST /anthropic/v1/messages、POST /anthropic/v1/messages/count_tokens（及快捷路径 /v1/messages、/messages）
Gemini 兼容 POST /v1beta/models/{model}:generateContent、POST /v1beta/models/{model}:streamGenerateContent（及 /v1/models/{model}:* 路径）
Ollama 兼容 GET /api/version、GET /api/tags、POST /api/show
统一 CORS 兼容 /v1/*、/anthropic/*、/v1beta/models/*、/api/*、/admin/* 统一走同一套 CORS 策略；Vercel 上 /v1/chat/completions 的 Node Runtime 也对齐相同放行规则，尽量减少第三方预检请求头限制
多账号轮询 自动 token 刷新、邮箱/手机号双登录方式
并发队列控制 每账号 in-flight 上限 + 等待队列，动态计算建议并发值
DeepSeek PoW 纯 Go 高性能实现（DeepSeekHashV1），毫秒级响应
Tool Calling 防泄漏处理：非代码块高置信特征识别、delta.tool_calls 早发、结构化增量输出
Admin API 配置管理、运行时设置热更新、代理管理、账号测试 / 批量测试、会话清理、导入导出、Vercel 同步、版本检查
WebUI 管理台 /admin 单页应用（中英文双语、深色模式，支持查看服务器端对话记录）
运维探针 GET /healthz（存活）、GET /readyz（就绪）

OpenAI /v1/* 仍是推荐的规范路径；同时支持 /models、/chat/completions、/responses、/embeddings、/files、/files/{file_id} 等根路径快捷路由，方便只配置 DS2API 根地址的第三方客户端。

平台兼容矩阵

级别 平台 当前状态
P0 Codex CLI/SDK（wire_api=chat / wire_api=responses） ✅
P0 OpenAI SDK（JS/Python，chat + responses） ✅
P0 Vercel AI SDK（openai-compatible） ✅
P0 Anthropic SDK（messages） ✅
P0 Google Gemini SDK（generateContent） ✅
P1 LangChain / LlamaIndex / OpenWebUI（OpenAI 兼容接入） ✅

模型支持

OpenAI 接口（GET /v1/models）

模型类型 模型 ID thinking search
default deepseek-v4-flash 默认开启，可由请求参数控制 ❌
default deepseek-v4-flash-nothinking 永久关闭，不受请求参数影响 ❌
expert deepseek-v4-pro 默认开启，可由请求参数控制 ❌
expert deepseek-v4-pro-nothinking 永久关闭，不受请求参数影响 ❌
default deepseek-v4-flash-search 默认开启，可由请求参数控制 ✅
default deepseek-v4-flash-search-nothinking 永久关闭，不受请求参数影响 ✅
expert deepseek-v4-pro-search 默认开启，可由请求参数控制 ✅
expert deepseek-v4-pro-search-nothinking 永久关闭，不受请求参数影响 ✅
vision deepseek-v4-vision 默认开启，可由请求参数控制 ❌
vision deepseek-v4-vision-nothinking 永久关闭，不受请求参数影响 ❌

除原生模型外，也支持常见 alias 输入（如 gpt-4.1、gpt-5、gpt-5-codex、o3、claude-*、gemini-* 等），但 /v1/models 返回的是规范化后的 DeepSeek 原生模型 ID。若 alias 名本身追加 -nothinking 后缀，也会映射到对应的强制关思考模型。完整 alias 行为以 API.md 和 config.example.json 为准。 当前上游视觉模型只暴露 vision 通道，不提供独立的联网搜索视觉变体。

Claude 接口（GET /anthropic/v1/models）

当前常用模型 默认映射
claude-sonnet-4-6 deepseek-v4-flash
claude-sonnet-4-6-nothinking deepseek-v4-flash-nothinking
claude-haiku-4-5（兼容 claude-3-5-haiku-latest） deepseek-v4-flash
claude-haiku-4-5-nothinking deepseek-v4-flash-nothinking
claude-opus-4-6 deepseek-v4-pro
claude-opus-4-6-nothinking deepseek-v4-pro-nothinking

可通过配置中的 model_aliases 覆盖映射关系；若请求模型名带 -nothinking，会在最终映射结果上强制追加无思考语义。 /anthropic/v1/models 除上述主别名外，还会返回 Claude 4.x snapshots、3.x 历史模型 ID 与常见 alias，便于旧客户端直接兼容。

Claude Code 接入避坑（实测）

Gemini 接口

Gemini 适配器将模型名通过 model_aliases 或内置精确 alias 映射到 DeepSeek 原生模型（覆盖 gemini-2.5-*、gemini-3*、gemini-pro-vision 等常见名称），支持 generateContent 和 streamGenerateContent 两种调用方式，并完整支持 Tool Calling（functionDeclarations → functionCall 输出）。若 Gemini 模型名带 -nothinking 后缀，例如 gemini-2.5-pro-nothinking，会映射到对应的强制关闭思考模型。

快速开始

部署方式优先级建议

推荐按以下顺序选择部署方式：

  1. 下载 Release 构建包运行：最省事，产物已编译完成，最适合大多数用户。
  2. Docker / GHCR 镜像部署：适合需要容器化、编排或云环境部署。
  3. Vercel 部署：适合已有 Vercel 环境且接受其平台约束的场景。
  4. 本地源码运行 / 自行编译：适合开发、调试或需要自行修改代码的场景。

通用第一步（所有部署方式）

把 config.json 作为唯一配置源（推荐做法）：

cp config.example.json config.json
# 编辑 config.json

后续部署建议：

WebUI 管理台里的“全量配置模板”也直接复用同一份 config.example.json，所以更新示例文件后，前端模板会自动保持一致。

方式一：下载 Release 构建包

每次发布 Release 时，GitHub Actions 会自动构建多平台二进制包：

# 下载对应平台的压缩包后
tar -xzf ds2api_<tag>_linux_amd64.tar.gz
cd ds2api_<tag>_linux_amd64
cp config.example.json config.json
# 编辑 config.json
./ds2api

方式二：Docker 运行

# 1. 准备环境变量和配置文件
cp .env.example .env
cp config.example.json config.json

# 2. 编辑 .env（至少设置 DS2API_ADMIN_KEY；如需修改宿主机端口，可额外设置 DS2API_HOST_PORT）
#    DS2API_ADMIN_KEY=请替换为强密码

# 3. 启动
docker-compose up -d

# 4. 查看日志
docker-compose logs -f

默认 docker-compose.yml 会把宿主机 6011 映射到容器内的 5001。如果你希望直接对外暴露 5001，请设置 DS2API_HOST_PORT=5001（或者手动调整 ports 配置）。 同时默认把 ./config.json 挂载到容器 /data/config.json，并设置 DS2API_CONFIG_PATH=/data/config.json，用于避免 /app 只读导致运行时 token 持久化失败。 镜像会预创建 /data 并授权给非 root 的 ds2api 用户；如果使用单文件 bind mount，请确保宿主机 config.json 对容器用户可读写，例如 chmod 644 config.json。

更新镜像：docker-compose up -d --build

Zeabur 一键部署（Dockerfile）

  1. 点击上方 “Deploy on Zeabur” 按钮，一键部署。
  2. 部署完成后访问 /admin，使用 Zeabur 环境变量/模板指引中的 DS2API_ADMIN_KEY 登录。
  3. 在管理台导入/编辑配置（会写入并持久化到 /data/config.json）。

Zeabur 首次空卷启动时可以没有 /data/config.json；DS2API 会先使用空的文件模式配置启动，并在管理台首次保存时创建该文件。

不依赖模板手动部署时，在 Zeabur 中选择 GitHub 仓库服务，Root Directory 保持 /，使用仓库根目录 Dockerfile 构建；添加持久卷 /data，设置 PORT=5001、DS2API_ADMIN_KEY=你的强密钥、DS2API_CONFIG_PATH=/data/config.json，然后暴露 HTTP 端口 5001。更完整步骤见 docs/DEPLOY.md。

说明：Zeabur 使用仓库内 Dockerfile 直接构建时，不需要额外传入 BUILD_VERSION；镜像会优先读取该构建参数，未提供时自动回退到仓库根目录的 VERSION 文件。

方式三：Vercel 部署

  1. Fork 仓库到自己的 GitHub
  2. 在 Vercel 上导入项目
  3. 配置环境变量（最少设置 DS2API_ADMIN_KEY；推荐同时设置 DS2API_CONFIG_JSON）
  4. 部署

建议先在仓库目录复制模板并填写：

cp config.example.json config.json
# 编辑 config.json

推荐：先本地把 config.json 转成 Base64，再粘贴到 DS2API_CONFIG_JSON，避免 JSON 格式错误：

base64 < config.json | tr -d '\n'

流式说明：OpenAI Chat 流式在 Vercel 上会由 api/chat-stream.js（Node Runtime）承接，但 vercel.json 只把规范路径 /v1/chat/completions 重写到 Node；根路径快捷别名 /chat/completions 仍走 Go 主链路。鉴权、账号选择、会话/PoW 准备仍由 Go 内部 prepare 接口完成；流式响应（含 tools）在 Node 侧执行与 Go 对齐的输出组装与防泄漏处理。Vercel 上需要实时流式时请使用 /v1/chat/completions。

详细部署说明请参阅 部署指南。

方式四：本地源码运行

前置要求：Go 1.26+，Node.js 20.19+ 或 22.12+（仅在需要构建 WebUI 时；CI / Docker 构建使用 Node 24）；同时确保 npm 可用，建议 npm 10+

# 1. 克隆仓库
git clone https://github.com/CJackHwang/ds2api.git
cd ds2api

# 2. 配置
cp config.example.json config.json
# 编辑 config.json，填入你的 DeepSeek 账号信息和 API key

# 3. 启动
go run ./cmd/ds2api

默认本地访问地址：http://127.0.0.1:5001

服务实际绑定：0.0.0.0:5001，因此同一局域网设备通常也可以通过你的内网 IP 访问。

WebUI 自动构建：本地首次启动时，若 WebUI 静态目录不存在，会自动尝试执行 npm ci --prefix webui（仅在缺少依赖时）和 npm run build --prefix webui -- --outDir static/admin --emptyOutDir（需要本机有 Node.js 和 npm；静态目录可用 DS2API_STATIC_ADMIN_DIR 覆盖）。你也可以手动构建：./scripts/build-webui.sh

配置说明

README 只保留快速入口，完整字段请以 config.example.json 为模板，并参考 部署指南 与 API 配置最佳实践。

常用字段：

环境变量完整列表见 部署指南，接口鉴权规则见 API.md。

鉴权模式

调用业务接口（/v1/*、/anthropic/*、Gemini 路由）时支持两种模式：

模式 说明
托管账号模式 Bearer 或 x-api-key 传入 config.keys 中的 key，由服务自动轮询选择账号
直通 token 模式 传入 token 不在 config.keys 中时，直接作为 DeepSeek token 使用

可选请求头 X-Ds2-Target-Account：指定使用某个托管账号（值为 email 或 mobile）。 如果指定账号不存在，或者当前管理账号队列已满，请求会返回 429；当前 429 不附带 Retry-After 头。若账号存在但登录/刷新失败，则返回对应的鉴权错误。 未指定目标账号时，如果 completion 因上游 thinking-only 空输出在同账号补偿重试后仍将返回 429 upstream_empty_output，托管账号模式会自动切到下一个可用账号，新建 session，并用原始 payload 再 fresh retry 一次。 Gemini 路由还可以使用 x-goog-api-key，或在没有认证头时使用 ?key= / ?api_key= 作为调用方凭据。

并发模�

ds2api (CJackHwang/ds2api)

Searching Database…

4.7K ·GitHub
Ds2api
archived
Что это такое?DS2API — прослойка на Go, превращающая веб-чат DeepSeek в API, совместимые с OpenAI, Claude и Gemini, так что существующие SDK и клиенты общаются с DeepSeek, как будто это один из этих провайдеров.
Это библиотека для импорта или отдельный сервер, который я запускаю?Это отдельный self-hosted сервер: бэкенд — чистый Go без зависимости от Python, а одностраничная админ-консоль на React (исходники в webui/) собирается и раздаётся по адресу /admin.
Как его запустить?Скопируйте config.example.json в config.json как единственный источник конфигурации, затем выберите путь развёртывания: скачать готовый бинарник из Release, запустить вариант с Docker Compose, развернуть репозиторий на Vercel или собрать из исходников с Go.
Нужны ли установленные Go или Node.js?Только если собираете из исходников: бэкенд работает на Go 1.26+, а Node.js 20.19+/22.12+ с npm нужен лишь для самостоятельной пересборки React-админки. Готовым бинарникам из Release и Docker-образу не нужно ни то, ни другое.
Безопасно ли подключать его к своему настоящему аккаунту DeepSeek?Используйте на свой страх и риск: репозиторий заархивирован (больше не поддерживается), и автор прямо снимает с себя ответственность за блокировку аккаунтов, потерю данных или юридические риски, возникающие из использования, развёртывания или зависимости от проекта.
Где его можно развернуть?Локально как бинарник Go (или сервис Linux systemd), в Docker/Docker Compose, на Vercel Serverless (с небольшим рантаймом Node для стриминга) или в один клик на Zeabur через входящий в комплект Dockerfile.
В чём подвох лицензии AGPL?Проект лицензирован под AGPL-3.0, и README сверху добавляет жёсткий дисклеймер: только для обучения, исследований и личных экспериментов — никакой коммерческой авторизации, а перед любым коммерческим использованием нужно письменное разрешение автора плюс собственная проверка на соответствие требованиям.
Поддерживает ли он несколько аккаунтов DeepSeek одновременно?Да, он опрашивает несколько аккаунтов с автоматическим обновлением токенов и лимитом одновременных запросов/очереди на аккаунт, так что одна конфигурация может распределять запросы по нескольким логинам DeepSeek.
Как он проходит проверку proof-of-work у DeepSeek?Он содержит чистую реализацию на Go алгоритма PoW DeepSeek (DeepSeekHashV1), которая решает задачу за миллисекунды, без внешних зависимостей-решателей.
Можно ли просто направить Claude Code или OpenAI SDK на него?Да, он проверен на высшем уровне совместимости с Codex CLI/SDK, OpenAI SDK, Vercel AI SDK, Anthropic SDK и Gemini SDK от Google, плюс есть более низкий уровень поддержки LangChain, LlamaIndex и OpenWebUI.
Почему вызовы инструментов могут молча не выполниться?Вывод вызовов инструментов должен использовать рекомендуемый формат блока DSML с разделителем-пайпом; вывод в виде простого JSON tool_calls или старых тегов XML/tool_use считается обычным текстом, а не выполняется.
What are similar projects?gpt4free, casbin-gateway, workbuddy2api-panel, one-api, mike, evenfire, NextChat, opencodex
Which topics is it in?vercel-deployment, claude-api, proxy-server, tool-calling, openai-api, vercel, agplv3, openai-compatible, ollama, authentication, deepseek, gemini
Creator
CJackHwang
Size
5.9 MB
Stars
4.7K
Updated
CommitMay 10Releasev4.6.1May 10
Age
8mo
Commits · 90 Days