# DeepSeek Harness 接入免费第三方模型全流程（附「代金券到手却报 402」踩坑记录）

> 环境：DeepSeek Harness 桌面版 `0.2.0-rc.2` / Windows 11  
> 目标：在官方账号余额为 0 的情况下，让 DSH 继续可用

## 一、背景：默认路由为什么直接不可用

装好 DeepSeek Harness 后，我打开就发不出消息，报 `PI_AI_ERROR: 402`。

DSH 默认的模型路由指向官方：

```yaml
- id: agent-default-model
  name: "@deepseek-ai/dsh-agent-default-model"
  config:
    provider: deepseek-official   # ← 按 token 计费
    model: deepseek-flash
```

所以第一反应是「账号没钱」。我用余额接口验证了一下，结论很干脆：

```bash
curl -s https://api.deepseek.com/user/balance \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY"
```

返回：

```json
{"is_available": false,
 "balance_infos": [{"currency": "CNY",
   "total_balance": "0.00",
   "granted_balance": "0.00",
   "topped_up_balance": "0.00"}]}
```

`granted_balance`（赠送额度）和 `topped_up_balance`（充值额度）**双零**，`is_available` 为 false。

**关键结论：这不是配置错误，也不是 Key 复制错了，是账号层面没钱。** 官方免费体验额度属于新账号一次性福利，我这边已经不具备。硬要免费用，只能换提供方。

## 二、思路：DSH 的模型提供方本身就是插件

DSH 的设计是「一切皆插件」，模型提供方也不例外。官方内置了两个适配器：

| 适配器                             | 作用                                       |
| ------------------------------- | ---------------------------------------- |
| `@deepseek-ai/dsh-llm-deepseek` | 直连官方，提供 `deepseek-official` 路由（计费）       |
| `@deepseek-ai/dsh-llm-pi-ai`    | 多提供方适配器，可接**任何 OpenAI / Anthropic 兼容端点** |

也就是说，**不需要装任何第三方"破解插件"**，用内置的 `dsh-llm-pi-ai` 加一条免费路由、再把默认模型切过去就行。

有两个机制会直接影响你的操作方式，先说清楚：

1. **密钥不写进配置文件。** 配置里只写引用名（如 `SILICONFLOW_API_KEY`），真实密钥由凭据层存到 `~/.dsh/.credentials.yaml`。
2. **不要手工编辑 `cordis.patch.yml`。** 界面保存时会做版本校验，外部改动会以 `settings/conflict` 被拒——必须走界面。

## 三、选免费的模型平台

| 平台               | 端点（baseURL）                                         | 免费额度                | 备注               |
| ---------------- | --------------------------------------------------- | ------------------- | ---------------- |
| 硅基流动 SiliconFlow | `https://api.siliconflow.cn/v1`                     | 新用户礼包 + 一批长期可用模型    | 纯 OpenAI 兼容，开箱即用 |
| 阿里云百炼            | `https://dashscope.aliyuncs.com/compatible-mode/v1` | 新人每模型约 100 万 tokens | Qwen 系列工具调用强     |
| 智谱               | `https://open.bigmodel.cn/api/paas/v4`              | GLM-4-Flash 系列长期免费  | 迁移成本低            |
| 火山方舟（豆包）         | `https://ark.cn-beijing.volces.com/api/v3`          | 每日额度重置              | 要先建「推理接入点」       |

免费档通病：**有速率限制**（常见每分钟约 20 次，批量任务容易撞 429）、多数要实名、额度有有效期。

## 四、实操步骤

### 第 1 步：拿 API Key

到平台控制台的「API 密钥」新建，复制 `sk-...`。

**注意：Key 只在创建那一刻完整显示一次**，弹窗一关就永久脱敏，且平台只存哈希、客服也还原不了。复制不到就删掉重建，别拖选文本（容易漏字符），用弹窗自带的「复制」按钮。

### 第 2 步：在 DSH 里加提供方

1. 左下角 **设置 → Models**
2. 点 **添加模型提供商**
3. 方式选 **自定义模型 API**（另一条「第三方模型提供商」是从内置目录选已知厂商，手工路由要用前者）

### 第 3 步：填表

| 字段          | 内容                                  |
| ----------- | ----------------------------------- |
| Provider ID | `siliconflow`（唯一，小写+连字符，**保存后不可改**） |
| 端点          | `https://api.siliconflow.cn/v1`     |
| 协议          | **OpenAI Chat Completions**         |
| API 密钥      | 粘贴 `sk-...`                         |
| 模型          | 点「获取可用模型」→ 勾选 → 「添加所选」              |

两个要点：

- **模型必须支持工具调用（tool calls）**。DSH 是 Agent 框架，不支持 function call 的模型能连上但干不了活。优先 Qwen3 / DeepSeek 系。
- 密钥框**只接受可打印 ASCII 字符**，`NAME=value` 形式或被引号包起来都会被拒。

### 第 4 步：切默认模型

保存后在输入框的模型选择器里切到新提供方下的模型即可。

## 五、踩坑：领了代金券，接口照样报 402

这是整件事里最值得记的一条。

在新平台注册、实名、**手动领取了新人代金券**之后，我的请求依然是 402：

```json
{"code":30001,"message":"Sorry, your account balance is insufficient"}
```

但同一时刻，这两个接口的表现是矛盾的：

| 请求                          | 结果                       |
| --------------------------- | ------------------------ |
| `GET /v1/models`            | **HTTP 200**，正常返回 98 个模型 |
| `POST /v1/chat/completions` | **HTTP 402**，0.1 秒即被拒    |

Key 无效的话第一个接口就会 401。所以 **Key 是对的，问题在账户。**

根因是平台的两条规则叠加：

> **欠费拦截**：账户余额低于授信额度（初始为 0）的用户、组织，平台将停止相关 API 服务，完成认证、充值后，服务将自动恢复。

> 平台**首次使用时不会自动使用代金券**，需要先在余额界面完成一次充值才能正常调用。

翻译成人话：**代金券 ≠ 可用余额。** 现金余额为 0 → 判定欠费 → API 直接停服 → 券躺在账上但激活不了。

**解法**：完成实名认证，然后充**最小金额**（我充了 0.01 元）解锁。充值后服务自动恢复，扣费顺序变成「现金余额 → 代金券」，券这时才开始抵扣。实测充值后第二次请求立刻 200。

## 六、怎么判断问题出在 Key 还是余额

这套排查顺序很好用，能省掉大量瞎试：

```bash
# 1. 鉴权是否正常（401 = Key 错；200 = Key 有效）
curl -s -o /dev/null -w "%{http_code}\n" \
  https://api.siliconflow.cn/v1/models \
  -H "Authorization: Bearer $KEY"

# 2. 真实调用（402 = 账户余额问题，不是 Key 问题）
curl -s https://api.siliconflow.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $KEY" \
  -d '{"model":"deepseek-ai/DeepSeek-V4-Flash","max_tokens":16,
       "messages":[{"role":"user","content":"hi"}]}'
```

常见错误码对照：

- `MISSING_CREDENTIAL` → 密钥没存进去，回 Models 页面看那一行左侧圆点是否绿色
- `UNKNOWN_MODEL` → 模型 ID 写错
- `401` → Key 本身无效或已删除
- `402 / 30001` → **账户余额**问题，不是 Key 问题
- `429` → 撞到免费档限速

## 七、小结

1. DSH 的模型提供方是可替换插件，官方零余额时**换提供方**才是正解，找「破解官方额度」的插件两边都危险。
2. 密钥走凭据层、配置只写引用名；`cordis.patch.yml` 不要手改。
3. 免费平台的坑集中在两点：**Key 只显示一次**、**代金券要先充值才能激活**。
4. 排查问题先分清「鉴权失败」和「余额不足」——`/v1/models` 探鉴权、`/v1/chat/completions` 探余额，两步就能定性。

> **配图建议**：建议在「第 2 步」「第 3 步」和「第五节 402 报错」三处各插一张截图，教程类文章有截图更容易被精选。

---

`#WorkBuddy` `#CodeBuddy` `#DeepSeek` `#AI编程` `#大模型接入`


环境：DeepSeek Harness 桌面版 0.2.0-rc.2 / Windows 11   目标：在官方账号余额为 0 的情况下，让 DSH 继续可用

DeepSeek Harness 接入免费第三方模型全流程（附「代金券到手却报 402」踩坑记录）

编程语言

本文详解DeepSeekHarness接入免费第三方模型全流程，涵盖硅基流动等平台选择、实操配置步骤及API密钥管理。重点解决官方余额为零时的402报错问题，提供代金券无法激活的充值解法与鉴权排查技巧，助您零成本继续使用AI编程工具。

代码解释

CodeBuddy

WorkBuddy 

DeepSeek

AI编程

Cordis

路由

Agent

JSON

PaaS

2026上云采购 | AI焕新·智启新局

workbuddy

腾讯云CodeBuddy个人版限时免费！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

DeepSeek Harness 接入免费第三方模型全流程（附「代金券到手却报 402」踩坑记录）-腾讯云开发者社区-腾讯云

DeepSeek Harness 接入免费第三方模型全流程（附「代金券到手却报 402」踩坑记录）

DeepSeek Harness 接入免费第三方模型全流程（附「代金券到手却报 402」踩坑记录）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐