ZCode 接入 DeepSeek 完整指南
⬅️ 承上 · 第 3 步 · 套餐与模型配置 已经装好内置套餐和日常模型 → 本篇在这个基础上，再加一个 DeepSeek。
💡 本篇你将完成：确认余额（不够就小额充值）→ 拿到 API Key → 在 ZCode 里接好并测通。预计 15 分钟。
🗺️ 整体流程
🎯 什么时候用它
ZCode 内置的 GLM Coding 套餐有额度上限：智谱官方说明是「每 5 小时和每周」双上限，用完之后要等下一个周期才恢复。
如果你经常一口气连着干活（长任务、批量整理一堆文件、反复改同一份东西），可能会撞上额度用完、得停下来等。
DeepSeek 的计费方式不一样：按实际用量从余额里扣，没有套餐那种每 5 小时/每周的额度池，所以更适合连续跑长任务。
⚠️ 这不是说 DeepSeek 没有限制。它同样受余额、并发上限、风控和服务规则约束，具体以官方价格页和你的控制台为准。
🤔 和 GLM 怎么选
两个不冲突——内置套餐照常用，DeepSeek 按需补充。区别在计费方式和额度机制（不代表谁更好）：
| 内置 GLM Coding 套餐 | DeepSeek | |
|---|---|---|
| 计费方式 | 买套餐，花套餐内的积分额度 | 按实际用量扣余额 |
| 额度机制 | 官方说明每 5 小时 + 每周双上限，用完等下一个 5 小时 | 无套餐式时段额度池；受余额与并发上限约束 |
| 更适合 | 日常零散任务，够用还省心 | 连续长任务、批量处理 |
| 要不要额外配置 | 不用，装好 ZCode 就有 | 要自己申请 Key 并充值 |
💡 简单说：平时用内置 GLM，需要长时间连着跑的时候切 DeepSeek。 两者各管一段场景。
📚 补充：GLM 也能不买套餐、改成直接扣 API 余额——做法见 ZCode 接入 GLM API 按量计费。
💰 要花多少钱
DeepSeek 按用量付费。如果账户已有可用余额，可以跳过这一步；新账户建议先充小额试水，用完随时补。
- 充值入口：👉 DeepSeek 充值
- 具体价格：👉 DeepSeek 价格页
能用多久取决于跑多少任务、传什么内容、当时的价格。本教程不承诺具体时长和费用，以你控制台的用量记录为准。充值只解决余额问题，不能解决模型 ID 写错、格式不匹配或权限问题。
🔑 拿到 API Key
1. 进 API Keys 页
打开 👉 DeepSeek 开放平台 注册登录，然后进入 👉 API Keys 页。
2. 创建并立刻复制
- 点右上角 创建 API key；
- 随便起个自己认得的名字（比如
zcode），点 创建； - 弹出窗口里立刻点复制——这个 Key 只在创建时完整显示一次，关掉就看不到了。
- 只填进 ZCode，不要粘贴到聊天、截图、教程、Issue 或公开仓库；
- 截图前先把 Key 完全打码；
- 不要把 ZCode 的配置文件（如
config.json）上传或发给别人； - 发现用量异常，立刻到控制台停用旧 Key 并重建。
⚙️ 在 ZCode 里接入
1. 打开模型设置
路径：
左下角齿轮 → 设置 → 模型设置
如果列表里已经有 DeepSeek，直接点它；没有就点 添加供应商 新建。
2. 填好连接字段
| 设置项 | 怎么填 |
|---|---|
| 供应商名称 | DeepSeek（自己认得就行） |
| API 格式 | Responses (/responses) |
| Base URL | https://api.deepseek.com |
| API Key | 上一步复制的 Key |
| 模型 ID | deepseek-flash（以 ZCode 列表为准） |
输入类型不在这一步，下一节单独讲。
3. API 格式选哪个
DeepSeek 提供两种格式，Base URL 完全一样：
- 本篇按实测走
Responses (/responses)； - 如果你的 ZCode 下拉里只有 Chat Completions，用它即可，并按同一模型和官方文档核对能力（两种格式不保证能力完全等价）。
唯一要守的规则：格式和 Base URL 必须是同一套组合，地址原样复制（不要自己加 /v1 或删字符）。
4. 模型 ID 从哪来
先在 ZCode 的模型列表里选；列表里没有，再去 👉 DeepSeek 控制台 或 👉 官方模型文档 复制真实可用的 ID。大小写和符号必须完全一致，不要凭印象手填。
DeepSeek 已发布 V4.1-Flash，官方价格页写明推荐用 deepseek-flash，早期的 deepseek-v4-flash、deepseek-v4-flash-vision-exp 仍可调用但已属旧名称（请求会转到 V4.1-Flash）。
做法：你 ZCode 列表里显示哪个就用哪个。不要为了对齐某篇教程去手改。
🧩 输入类型怎么勾
编辑这个模型，界面有 文本 / 图片 / 视频 / PDF 四个输入开关。四个都勾上，输出类型选「文本」，然后保存。
界面能勾，只说明 ZCode 提供了这个选项。第一次用某一类文件前，先用一个普通、非敏感的文件试一次——比如随便传一张图问「这张图里有什么」——确认真的读得到，再拿它处理正式资料。某类试了不行，就先别依赖它。
以厂商官方模型列表和 ZCode 里显示的能力标签为准。不要为了测试盲目上传业务资料。
如果你的界面显示推理档位 off / high / max，这是 ZCode 界面的选项，不等于 DeepSeek API 的参数名，默认值与效果以你当前 ZCode 版本为准；直连 API 时以官方文档为准。
✅ 测通并开始用
1. 点测试看成功
模型列表里点 测试，出现绿色 连接成功 就说明通了。
测试没通过？ 先对一下报错原文：
这条报错是 DeepSeek 的余额耗尽提示（官方错误码 402）。先充值：到 👉 充值页 补一笔，回来重新点测试。
别只因为这条报错去反复改 Base URL、API 格式或 API Key——余额问题是改配置改不好的。充值后仍然连不通，再按下面的对照表查模型、权限或服务状态。
其他测试失败这样对号入座：
| 界面提示 | 什么原因 | 怎么处理 |
|---|---|---|
| 报「模型不存在」 | 模型 ID 写错、已下线，或这个账号 / 接口不提供该模型 | 从 ZCode 列表或控制台复制当前可用 ID；仍失败就核对该模型是否支持所选接口和账号权限 |
| 其他连接失败 | 可能是 Key 失效、格式与地址不搭、权限、限速、网络或服务端抖动 | 先看完整报错：401 查 Key，429 错开或稍后重试，5xx 稍后重试；提示不明确时再核对格式与地址 |
再用一句纯文本试一次（比如「用一句话解释什么是询盘」），能正常回答，基础接入就完成了。需要图片能力时，再传一张普通测试图问「这张图里有什么」。
2. 怎么选到它
新建任务的输入框下方有模型菜单，选 DeepSeek → 你配的那个模型 即可。
3. 接入 AI 员工团
如果装了 ZCode AI 员工团，安装或更新时会读取模型能力清单自动分配岗位。DeepSeek 可能被分到需要推理的岗位——具体以安装/更新后的岗位清单为准。需要重新分配时：确认供应商已启用 → 复制员工团仓库当前的「更新」提示词 → 明确要求重新分配 → 新建会话检查岗位。
📋 避坑汇总
| 坑 | 后果 | 怎么避 |
|---|---|---|
| 🔴 API Key 泄露 | 别人能刷你的余额 | 只填进 ZCode；不贴聊天/截图/仓库；异常立刻停用重建 |
| 🟡 模型 ID 填错或用旧名 | 报「模型不存在」 | 从 ZCode 列表或控制台复制当前可用 ID |
| 🟡 格式和地址不匹配 | 连接失败 | API 格式与 Base URL 用同一套组合，地址原样复制 |
| 🟡 把界面开关当模型能力 | 传视频/PDF 失败或读不到 | 只能勾不代表能用；先按官方能力确认，再逐项实测 |
| 🟢 没勾输入类型 | 传图片模型读不到 | 四项都勾上；首次用某类前先用普通文件试一次 |
🟡 余额用完（测试时报 Insufficient Balance） | 请求被拒，长任务半路中断 | 到 👉 充值页 补一笔再测；并发受限时错开或等一等 |
✅ 完成检查
- DeepSeek 账户已注册登录；
- 已创建 API Key，并确认没粘贴到任何公开位置；
- 已小额充值（或确认余额够用）；
- ZCode 里 DeepSeek 供应商显示已启用；
- API 格式与 Base URL 是同一套组合；
- 模型 ID 从列表或控制台复制；
- 输入类型四项都勾上，且首次使用某类文件前已试过一次；
- 点测试显示连接成功，纯文本测试通过。
📄 第 4 步 · 安装 ZCode AI 员工团 —— 让 DeepSeek 和其他模型按岗位分工协作。
📚 延伸阅读
- 📚 第 3 步 · 套餐与模型配置：其他供应商的 Base URL 速查
- 📚 用 ZCode + 来发信搭建 B2B 询盘获取流程：把这套模型用到真实业务
- 📚 DeepSeek 官方价格页：最新计费规则