ZCode 接入 GLM API 按量计费
⬅️ 承上 · 第 3 步 · 套餐与模型配置 已经装好内置套餐和日常模型 → 本篇在这个基础上，再用 API 余额接一份 GLM。
💡 本篇你将完成：新建 API Key → 确认余额（不够就充值）→ 在 ZCode 里接好并测通。预计 15 分钟。
🗺️ 整体流程
🎯 什么时候用它
ZCode 装好之后，本来就能用内置的 GLM 套餐（就是第 3 步那个）。那为什么还要自己接一遍？
因为付费方式不一样：
- 内置套餐：先订阅、花套餐里的额度，适合天天用、用量稳定的人；
- API 按量：不用订阅，直接从智谱账户余额里扣，适合偶尔用、或者想按用量控制开销的人。
如果你已经买了套餐、用着也顺，不需要看这篇。
🤔 套餐还是按量
两种方式不冲突，可以同时存在（ZCode 里会显示成两个供应商）。区别在怎么付费、额度怎么算：
| 内置 GLM 套餐 | GLM API 按量（本篇） | |
|---|---|---|
| 怎么付费 | 订阅套餐，花套餐内的积分额度 | 从智谱账户余额按用量扣费 |
| 额度机制 | 官方说明每 5 小时 + 每周双上限，用完等下一个周期 | 按账户余额计费，没有套餐那种额度池 |
| 适合谁 | 天天用、用量稳定 | 偶尔用、想按用量控制开销 |
| 怎么配 | 装好 ZCode 就有，不用配 | 自己申请 API Key 建供应商 |
💡 这只是付费方式不同，不代表哪个模型更好。两边用的都是 GLM 模型。具体价格、频率限制和账户规则以控制台与官方说明为准。
💰 要花多少钱
按实际用量从账户余额扣费。账户已有可用余额就可以跳过充值，直接往下走；余额不足再充。
充值页里可以选不同档位（页面上会显示几个常用金额），也可以自定义金额。
能用多久取决于跑多少任务、传什么内容、当时的价格。本教程不承诺具体时长和费用，以你控制台的用量记录为准。充值只解决余额问题，不能解决模型 ID 写错、格式不匹配或权限问题。
🔑 拿到 API Key
1. 进 API Key 页
打开 👉 智谱 API Key 管理页，登录你的智谱账号。
2. 新建并立刻复制
- 点右上角 新建 API Key；
- 给它起个自己认得的名字（比如
zcode），点 确定； - 弹窗里立刻点复制——这个 Key 只在创建时完整显示一次，关掉就看不到了。
- 只填进 ZCode，不要粘贴到聊天、截图、教程、Issue 或公开仓库；
- 截图前先把 Key 完全打码；
- 不要把 ZCode 的配置文件（如
config.json）上传或发给别人； - 发现用量异常，立刻到控制台停用旧 Key 并重建。
⚙️ 在 ZCode 里接入
1. 打开模型设置
路径：
左下角齿轮 → 设置 → 模型设置
点 添加供应商 新建一个，不要复用列表里已有的内置项。
ZCode 装好后，GLM 相关可能出现好几个条目，只有你自己新建的那个才是本篇讲的按量路线：
BigModel - Coding Plan：内置套餐，走 Anthropic 格式 —— 不是本篇；Bigmodel - API Key：内置的 API Key 供应商，也走 Anthropic 格式 —— 也不是本篇；- 你自己新建的（建议命名
GLM 按量）：这才是本篇要配的，走 Chat Completions。
点错到前两个，格式和地址都对不上，你会以为配好了其实走的不是同一条路。
2. 填好连接字段
| 设置项 | 怎么填 |
|---|---|
| 供应商名称 | GLM（建议叫「GLM 按量」之类，避免和内置的 BigModel 混） |
| API 格式 | Chat Completions |
| Base URL | https://open.bigmodel.cn/api/paas/v4（末尾不要自己加 /） |
| API Key | 上一步复制的 Key |
| 模型 ID | GLM-5.3-Flash（以 ZCode 列表为准） |
输入类型不在这一步，下一节单独讲。
3. 模型 ID 从哪来
先在 ZCode 的模型列表里选；列表里没有，再去 👉 智谱开放平台 或 👉 官方模型文档 复制真实可用的 ID。大小写和符号必须完全一致，不要凭印象手填。
GLM-5.3-Flash、GLM-5.3 是本文截图里的写法。你的 ZCode 列表里显示哪个就用哪个；只找到别的小写写法（如 glm-4.5）时，以控制台和官方文档为准，不要为了对齐本教程去手改。
4. 一个易混点
ZCode 里可能有三个 GLM 相关条目（见上一节的 warning）：
| 条目 | 是什么 | 走哪条路 |
|---|---|---|
BigModel - Coding Plan | 内置套餐 | Anthropic 格式 |
Bigmodel - API Key | 内置 API Key 供应商 | Anthropic 格式 |
你新建的 GLM 按量 | 本篇的按量路线 | Chat Completions |
建议把新建的这个明确命名（如 GLM 按量），以后才知道自己花的是套餐额度还是账户余额。
🧩 输入类型怎么勾
编辑这个模型，界面有 文本 / 图片 / 视频 / PDF 等输入开关。按你的需要勾上，输出类型选「文本」，然后保存。
界面能勾，只说明 ZCode 提供了这个选项，不等于该模型官方确认支持。第一次用某一类文件（尤其图片 / 视频 / PDF）前，先用一个普通、非敏感的文件试一次；试不通就先别依赖它。
以厂商官方模型列表和 ZCode 里显示的能力标签为准。不要为了测试盲目上传业务资料。
✅ 测通并开始用
1. 点测试看成功
在模型列表里点 测试 按钮（图标位置随版本可能不同），出现绿色 连接成功 才说明通了。
本文的模型 ID 和地址来自一份实测环境，你的账号能不能用同一个 ID，必须点测试才知道。若提示模型不存在或连接失败，回控制台复制当前可用的模型 ID 再试。
2. 怎么选到它
新建任务的输入框下方有模型菜单，选 GLM → 你配的那个模型 即可。
3. 接入 AI 员工团
如果装了 ZCode AI 员工团，安装或更新时会读取模型能力清单自动分配岗位。GLM 可能被分到中文处理类的岗位——具体以安装/更新后的岗位清单为准。
📋 避坑汇总
| 坑 | 后果 | 怎么避 |
|---|---|---|
| 🔴 API Key 泄露 | 别人能刷你的余额 | 只填进 ZCode；不贴聊天/截图/仓库；异常立刻停用重建 |
| 🔴 忘了点测试 | 以为配好了，实际连不通 | 必须点测试看到「连接成功」再往下走 |
| 🟡 模型 ID 填错 | 报「模型不存在」 | 从 ZCode 列表或控制台复制当前可用 ID |
| 🟡 格式和地址不匹配 | 连接失败 | API 格式与 Base URL 用同一套组合，地址原样复制 |
| 🟡 把界面开关当模型能力 | 传图片/视频失败 | 只能勾不代表能用；先按官方能力确认，再用普通文件实测 |
| 🟢 分不清在用套餐还是按量 | 花错钱、额度混 | 给自定义供应商改名（如「GLM 按量」）区分 |
| 🟢 余额不足 | 请求被拒 | 到 👉 充值页 补一点 |
✅ 完成检查
- 智谱账号已登录；
- 已新建 API Key，并确认没粘贴到任何公开位置；
- 已确认账户余额（不够已充值）；
- ZCode 里 GLM 供应商显示已启用；
- API 格式是
Chat Completions，Base URL 是https://open.bigmodel.cn/api/paas/v4； - 模型 ID 从列表或控制台复制；
- 输入类型按需勾选；
- 点测试显示「连接成功」，纯文本测试通过。
📄 第 4 步 · 安装 ZCode AI 员工团 —— 让 GLM 和其他模型按岗位分工协作。
📚 延伸阅读
- 📚 第 3 步 · 套餐与模型配置：内置套餐怎么选，其他供应商 Base URL 速查
- 📚 ZCode 接入 DeepSeek 完整指南：另一个第三方接入的完整示例
- 📚 智谱模型价格：最新计费规则