ds-free-api

DS-Free-API

English

将免费的 DeepSeek 网页端对话反代并适配转换为标准的 OpenAI 与 Anthropic 兼容 API 协议（目前支持 chat completions 和 messages，包括流式返回与工具调用）。

项目亮点

• 零成本 API 代理：使用 DeepSeek 免费网页端，无需官方 API Key，即可获得 OpenAI / Anthropic 兼容接口
• 幂等重试安全：支持 Idempotency-Key 请求头（Stripe / OpenAI 约定）—— 客户端超时重试 不会重复打到上游，命中时字节级回放同一响应并标记 idempotent-replayed: true
• 三协议支持：同时兼容 OpenAI Chat Completions、OpenAI Responses（/v1/responses + GET /v1/responses/{id} 检索）与 Anthropic Messages API，主流客户端即插即用
• 工具调用就绪：OpenAI function calling 完整实现，工具解析 + 三层自修复管道（文本修复 → JSON 修复 → 模型兜底），覆盖 10+ 异常格式
• 文件上传就绪：支持 OpenAI file / image_url content part 和 Anthropic image / document content block 的内联 data URL 文件自动上传到 DeepSeek 会话； HTTP URL 自动触发搜索模式，模型可直接访问链接内容
• 超长提示词回退：当提示词超过模型限制时，自动使用分块补全 + 文件上传绕过
• Web 管理面板：内置可视化面板，账号池状态、API Key 管理、请求日志、i18n 国际化（简体中文 / English / Bahasa Indonesia）、主题切换、响应式布局（桌面 / 平板 / 移动）与 PWA，配置热重载开箱即用
• Rust 实现：单可执行文件 + 单 TOML 配置，跨平台原生高性能（Web 面板编译时嵌入，开箱即用）
• 多账号池：空闲最久优先轮转（DashMap 无锁读），支持水平扩展并发
• 风控对齐（2026-10）：按官方客户端抓包结果补齐 x-hif-leim 风控令牌（按设备缓存）、 设备身份按账号派生、传输层拟态档位可配（emulation，默认与 UA 自洽的原生 App 指纹）、 单账号滑动窗口配额与禁言早检；诊断入口 hif_probe / account_check / identity_probe

快速开始

二进制使用

1. 从 releases 下载对应平台压缩包并解压
2. 复制 config.example.toml 为 config.toml 并填入账号 (可选, 也可启动后在管理面板中配置)
3. 运行 ./ds-free-api
4. 访问 http://127.0.0.1:22217/admin 设置管理密码，之后可在面板中创建 API Key 和管理账号

./ds-free-api
./ds-free-api -c /path/to/config.toml
RUST_LOG=debug ./ds-free-api

并发：免费 API 有 session 级速率限制。本项目内置限流检测 + 指数退避重试，确保稳定。 推荐并行数 = 账号数 / 2。支持无 config.toml 启动后通过管理面板添加账号。

Docker 使用

# 首次部署：先准备容器配置（见下方说明）
cp docker/config.example.toml docker/config/config.toml

docker compose -f docker/docker-compose.yaml up -d

Compose 配置见 docker/docker-compose.yaml。

管理面板在 http://localhost:22217/admin，首次访问设置管理密码。 config/ 和 data/ 目录通过 bind mount 挂载到容器内，配置修改自动持久化到宿主机。

首次部署必须准备 docker/config/config.toml（cp 上面那一行）。 已发布镜像（≤ v0.5.1）在配置缺失时会按代码默认值生成 host = "127.0.0.1" 的配置， 服务只监听容器内回环，宿主机的 22217 端口会连不上（容器显示 Up 但访问无响应）。 从源码构建的镜像（docker/Dockerfile + docker/entrypoint.sh）已修复：配置缺失或为空时 自动用内置示例（host = "0.0.0.0"）初始化，无需手动 cp。

免费测试账号

请自行注册，可以参考 issue #62 的方法。

⚠️ 账号风控现状（2026-09）：官方风控已大幅收紧，本仓库 README 与 issue 中历史公开的测试账号 已全部失效（USER_IS_BANNED / user is muted / RISK_DEVICE_DETECTED）。这不是项目 bug， 而是上游针对共享账号的策略变化：

上游返回	含义	处理方式
biz_code=10 USER_IS_BANNED	账号已被永久封禁	无法恢复，只能注册新账号
biz_code=5 user is muted	临时禁言（响应含 mute_until，通常数周）	无法通过重登恢复，账号会被标记为 invalid
biz_code=11 RISK_DEVICE_DETECTED	缺少浏览器设备指纹	在账号配置里补上 device_id（见下）

因此现在不建议依赖公共测试账号。请使用自己的账号，并在 config.toml / 管理面板中为每个账号 填写 device_id，否则登录会直接被风控拦截。

✅ 2026-10 更新：缺失的风控令牌已补齐。 用真实浏览器抓包发现，官方客户端会在 /chat/completion 请求上带一个由 hif-leim.deepseek.com 下发的短期令牌 （x-hif-leim，有效期见响应头 x-hif-ttl，默认 600s）。本代理此前完全没有该头， 上游无需任何行为统计即可判定请求来自非官方客户端 —— 与「每账号仅 2 次请求也被禁言」 的实测现象吻合。v0.5.0 起 ds_core 会自动取令牌、按 TTL 刷新并附在 SSE 请求上 （hif_enabled = true，默认开启）。细节见 docs/development.md。

如何获取 device_id

device_id 是数美（Shumei）SDK 生成的设备级指纹。上游用它做账号关联与画像， 因此每个账号应使用各自独立的 device_id（各自开一个无痕窗口 / 浏览器配置文件登录一次）， 不要把同一个值复用到多个账号。⚠️ 该值不能伪造（伪造的 base64 或普通字符串会返回 RISK_DEVICE_DETECTED），必须来自真实浏览器；取一次长期有效：

1. 用 Chrome 打开 https://chat.deepseek.com/sign_in 并登录一次（确保页面完全加载，风控脚本已初始化）

2. 打开开发者工具 → Network，过滤 users/login

3. 发起一次登录，查看该请求的 Payload，复制 device_id 字段的值

4. 写入账号配置：

   [[ds_core.accounts]]
   email = "you@example.com"
   mobile = ""
   area_code = ""
   password = "your-password"
   device_id = "从浏览器抓到的值"
   

   管理面板 → 配置页同样提供该字段的编辑（留空则保留服务端已有值）。

简化方案：在浏览器控制台执行 SMSdk.getDeviceId()（需等 SMSdk 就绪）也能直接拿到该值。

API 端点

管理面板位于 /admin，首次访问引导设置管理密码。

所有响应都带 x-request-id（形如 req-1a2b），与运行日志里的 req= 同源，便于对账排障。

幂等重试（Idempotency-Key）

在 POST /v1/chat/completions、POST /v1/responses、POST /anthropic/v1/messages 上带上 Idempotency-Key: <任意唯一串>（SDK 一般会自动生成），语义如下：

缓存是进程内有界 + TTL 24h（1024 条 / 单条 1MB / 总量 64MB），重启即失效、不落盘。 不带该请求头时行为与普通请求完全一致。

模型映射

⚠️ 上游已下线 expert / vision（2026-09）

/api/v0/client/settings 的 model_configs 明确显示：

model_type	名称	enabled	switchable
default	快速模式	✅ true	✅ true
expert	专家模式	❌ false	❌ false
vision	识图模式	❌ false	❌ false

即网页端已不再提供这两个模式的切换入口，目前实际只有一个模型。 因此本项目默认只暴露 deepseek-default。expert / vision 的 API 仍能调用， 但上游已标记为 disabled，启用后请求容易失败或行为不稳定。 如确需启用，在 config.toml 中显式配置 model_types。

config.toml 中 model_types（默认 ["default"]）自动映射为 deepseek-：

模型名可以直接用裸名：default（大小写不敏感）等价于 deepseek-default， 方便 Claude Code / Codex 等把 model 设成简短名字的客户端（见 issue #99）。

可选别名通过 model_aliases 按 index 对齐 model_types，默认无别名。空字符串被跳过：

# model_types    = ["default", "expert"]
# model_aliases  = ["", "deepseek-v4-pro"]  → deepseek-v4-pro 映射到 expert（index 1）
model_aliases = []

Anthropic 兼容层使用相同的模型 ID，通过 /anthropic/v1/messages 调用。

能力开关

• 深度思考：默认已开启。如需显式关闭，请求体中加 "reasoning_effort": "none"。

• 智能搜索：默认已开启（DeepSeek 后端在搜索模式下会注入更强的系统提示词，提升工具调用遵循度）。如需显式关闭，请求体 中加 "web_search_options": {"search_context_size": "none"}。

• 文件上传：支持内联文件（data URL）自动上传到 DeepSeek 会话，以及 HTTP URL 自动触发搜索模式：

  OpenAI 端：

  {"type": "file", "file": {"file_data": "data:text/plain;base64,...", "filename": "doc.txt"}}
  {"type": "image_url", "image_url": {"url": "data:image/png;base64,..."}}
  {"type": "image_url", "image_url": {"url": "https://example.com/img.jpg"}}
  

  Anthropic 端：

  {"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": "..."}}
  {"type": "document", "source": {"type": "base64", "media_type": "text/plain", "data": "..."}}
  {"type": "image", "source": {"type": "url", "url": "https://example.com/img.jpg"}}
  

工具调用标签幻觉

内置模糊匹配（全角 ｜<=>|、▁<=>_），自动覆盖大多数变体。若模型输出格式不同的回退标签，可在控制面板中添加, 或者在 config.toml 的 [ds_core] 下追加：

tool_call.extra_starts = ["<|tool_call_begin|>", "", ""]
tool_call.extra_ends = ["<|tool_call_end|>", "", ""]

Web 管理面板

启动服务后访问 http://127.0.0.1:22217/admin 即可进入管理面板：

• 概览：请求统计、账号池状态一览（移动端自动切换为卡片式布局）
• 账号池：查看/添加/移除账号（含 device_id 字段），手动重新登录 Error 状态账号
• API Keys：创建/删除 API Key，脱敏展示
• 模型：可用模型列表与详情，内置 cURL / Python / Node.js 调用示例
• 配置：账号、API Key、模型类型、工具调用标签等核心配置
• 设置：Server / Proxy / ds_core 客户端参数，以及管理员密码修改
• 日志：最近请求日志与运行时日志

界面支持三语切换（简体中文 / English / Bahasa Indonesia）、明暗主题（跟随系统 / 亮 / 暗）、 侧边栏折叠（状态持久化到 localStorage），并可作为 PWA 添加到桌面/主屏。

管理面板概览（Dashboard）

配置界面（Config）

首次访问时引导设置管理密码（bcrypt 哈希存储），登录后签发 JWT（24h 有效），支持密码重置时吊销旧 Token。

环境变量

安全

• 管理面板：JWT 认证 + bcrypt 密码哈希 + 登录失败率限制（5 次失败锁定 5 分钟）
• API 访问：通过管理面板创建的 API Key 鉴权（HashSet O(1) 查找）
• CORS：可配置允许的 Origin 列表，默认仅 http://localhost:22217
• 敏感信息：账号 ID 在响应头中脱敏，请求体不记录日志，持久化文件权限 0600

开发

设计哲学

一个 config.toml 反映所有运行状态。管理面板对配置的修改即时持久化到 config.toml，同时热重载到运行中的服务。

非必要不引入额外运行时系统依赖。项目始终优先选择纯 Rust 或静态链接的依赖（如 rustls → wreq + BoringSSL），确保编译产物单一二进制无外部 .so/.dll 依赖，下载即用。

简要架构图：

flowchart TB
    %% ===== 主题定义 =====
    classDef client fill:#eff6ff,stroke:#3b82f6,stroke-width:3px,color:#1d4ed8,rx:14,ry:14
    classDef gateway fill:#fffbeb,stroke:#f59e0b,stroke-width:3px,color:#92400e,rx:12,ry:12
    classDef openai_adapter fill:#f8fafc,stroke:#0a9e7b,stroke-width:2px,color:#334155,rx:10,ry:10
    classDef anthropic_compat fill:#f8fafc,stroke:#d07354,stroke-width:2px,color:#334155,rx:10,ry:10
    classDef ds_core fill:#f8fafc,stroke:#3964fe,stroke-width:2px,color:#1e40af,rx:10,ry:10
    classDef external fill:#fef2f2,stroke:#ef4444,stroke-width:3px,color:#991b1b,rx:6,ry:6

    %% ===== 节点 =====
    Client(["🖥️ 客户端"]):::client

    subgraph GW ["🌐 HTTP 接入层"]
        Handler(["路由 / 鉴权 / 序列化"]):::gateway
    end

    subgraph PL ["⚙️ 协议处理层"]
        direction TB

        subgraph AC ["Anthropic 兼容层"]
            A2O["请求转换  
Anthropic → OpenAI"]:::anthropic_compat
            O2A["响应转换  
OpenAI → Anthropic"]:::anthropic_compat
        end

        subgraph OA ["OpenAI 适配层"]
            ReqPipe["请求管道  
校验 / 工具提取 / 提示词构建"]:::openai_adapter
            RespPipe["响应管道  
SSE 解析 / 格式转换 / 工具修复"]:::openai_adapter
        end
    end

    subgraph CL ["🔧 核心层 (ds_core)"]
        Pool["账号池轮转"]:::ds_core
        PoW["PoW 求解"]:::ds_core
        Session["会话编排  
创建销毁 / 历史上传"]:::ds_core
    end

    DeepSeek[("🔴 DeepSeek API")]:::external

    %% ===== 连接 =====
    Client -->|"HTTP 请求"| Handler

    Handler -->|"OpenAI 请求结构体"| ReqPipe
    Handler -->|"Anthropic 请求结构体"| A2O
    A2O -->|"OpenAI 请求结构体"| ReqPipe

    ReqPipe --> Pool
    Pool --> PoW
    PoW --> Session
    Session -->|"completion 端点"| DeepSeek

    Session -.->|"DeepSeek SSE数据流"| RespPipe
    RespPipe -.->|"OpenAI 响应结构体"| Handler
    RespPipe -.->|"OpenAI 响应结构体"| O2A
    O2A -.->|"Anthropic 响应结构体"| Handler

    %% ===== 子图样式 =====
    style GW fill:#fffbeb,stroke:#f59e0b,stroke-width:2px,stroke-dasharray: 5 5
    style PL fill:#fafafa,stroke:#94a3b8,stroke-width:2px
    style AC fill:#fdf0ec,stroke:#d07354,stroke-width:2px
    style OA fill:#e6f7f3,stroke:#0a9e7b,stroke-width:2px
    style CL fill:#eef2ff,stroke:#3964fe,stroke-width:2px,stroke-dasharray: 5 5

数据管道：

OpenAI (chat_completions) 处理管道:

flowchart TB
    %% ===== 主题定义 =====
    classDef ds_core fill:#eef2ff,stroke:#3964fe,stroke-width:2.5px,color:#1e40af,rx:10,ry:10
    classDef openai_adapter fill:#e6f7f3,stroke:#0a9e7b,stroke-width:2.5px,color:#065f46,rx:10,ry:10
    classDef step fill:#fffbeb,stroke:#f59e0b,stroke-width:1.5px,color:#334155,rx:6,ry:6

    subgraph RQ ["请求处理"]
        direction TB
        Q1["ChatCompletionsRequest"]:::openai_adapter
        Q2["参数校验 + 默认值"]:::step
        Q3["工具/文件提取 + 注入提示词"]:::step
        Q4["DeepSeek 原生标签提示词构建"]:::step
        Q5["模型映射 + 能力开关"]:::step
        Q6["限流重试  
指数退避 1s→2s→4s→8s→16s"]:::step
        Q7["ChatRequest"]:::ds_core
    end

    subgraph RS1 ["非流式响应"]
        direction TB
        OR1["ds_core SSE 流"]:::ds_core
        OR2["SSE 帧解析  
ContentDelta / Usage"]:::step
        OR3["状态机重组  
合并连续文本 / 累积 usage"]:::step
        OR4["chunk 聚合  
拼接 content / reasoning / tool_calls"]:::step
        OR5["ChatCompletionsResponse"]:::openai_adapter
    end

    subgraph RS2 ["流式响应"]
        direction TB
        OS1["ds_core SSE 流"]:::ds_core
        OS2["SSE 帧解析 + 状态机"]:::step
        OS3["Chunk 转换  
DsFrame → ChatCompletionsResponseChunk"]:::step
        OS4["工具调用 XML 解析"]:::step
        OS5["异常工具调用自修复"]:::step
        OS6["stop 序列检测 + obfuscation"]:::step
        OS7["ChatCompletionsResponseChunk"]:::openai_adapter
    end

    Q1 --> Q2 --> Q3 --> Q4 --> Q5 --> Q6 --> Q7
    OR1 --> OR2 --> OR3 --> OR4 --> OR5
    OS1 --> OS2 --> OS3 --> OS4 --> OS5 --> OS6 --> OS7

    style RQ fill:#f8fafc,stroke:#0a9e7b,stroke-width:2px
    style RS1 fill:#f8fafc,stroke:#0a9e7b,stroke-width:2px
    style RS2 fill:#f8fafc,stroke:#0a9e7b,stroke-width:2px

Anthropic (messages) 处理管道:

flowchart TB
    %% ===== 主题定义 =====
    classDef oai fill:#e6f7f3,stroke:#0a9e7b,stroke-width:2.5px,color:#065f46,rx:10,ry:10
    classDef anth fill:#fdf0ec,stroke:#d07354,stroke-width:2.5px,color:#7c3a2a,rx:10,ry:10
    classDef step fill:#fffbeb,stroke:#f59e0b,stroke-width:1.5px,color:#334155,rx:6,ry:6

    subgraph RQ ["请求处理"]
        direction TB
        Q1["MessagesRequest"]:::anth
        Q2["消息展开  
System 前置 / 文本合并 / 图片/文档映射"]:::step
        Q3["工具映射  
ToolUnion → OpenAI Tool"]:::step
        Q4["能力开关映射  
thinking → reasoning_effort"]:::step
        Q5["ChatCompletionsRequest"]:::oai
    end

    subgraph RS3 ["非流式响应"]
        direction TB
        AR1["ChatCompletionsResponse"]:::oai
        AR2["Content 拆解  
reasoning → Thinking  
content → Text  
tool_calls → ToolUse"]:::step
        AR3["ID 映射  
chatcmpl → msg  
call → toolu"]:::step
        AR4["MessagesResponse"]:::anth
    end

    subgraph RS4 ["流式响应"]
        direction TB
        AS1["ChatCompletionsResponseChunk 流"]:::oai
        AS2["Chunk 状态机  
块类型切换 / 索引递进"]:::step
        AS3["事件映射  
content → text_delta  
reasoning → thinking_delta  
tool_calls → input_json_delta"]:::step
        AS4["MessagesResponseChunk"]:::anth
    end

    Q1 --> Q2 --> Q3 --> Q4 --> Q5
    AR1 --> AR2 --> AR3 --> AR4
    AS1 --> AS2 --> AS3 --> AS4

    style RQ fill:#f8fafc,stroke:#d07354,stroke-width:2px
    style RS3 fill:#f8fafc,stroke:#d07354,stroke-width:2px
    style RS4 fill:#f8fafc,stroke:#d07354,stroke-width:2px

详细开发指南（构建、测试、Docker 部署、e2e 测试等）见 docs/development.md。

许可证

GNU General Public License v3.0

DeepSeek 官方 API 非常便宜，请大家多多支持官方服务。

本项目的初心是想体验官方网页端灰度测试的最新模型。

严禁商用，避免对官方服务器造成压力，否则风险自担。