跳到主要内容

ZCode 模型接入

⬅️ 承上

第 2 步 · 开启核心能力 已经开好权限和相关能力 → 本篇给 ZCode 接上模型：优先接入按量计费的 DeepSeek 或 GLM API；内置套餐作为轻量备选。

🌟 核心目标：接入 DeepSeek 或 GLM 的按量 API 并通过连接测试，第 3 步就结束了。预计 15 分钟。

🎯 为什么按量 API 优先​

套餐类（BigModel 内置套餐 / GLM Coding Lite 等）有两个硬限制：

  • 5 小时额度窗口：额度用完要等下一个 5 小时窗口刷新，正干活时被掐断最难受；
  • 每周用量上限：用量大的周会提前触顶，剩下几天只能干等。

DeepSeek / GLM 的按量 API 没有这两条：充多少用多少，按 token 计费，重度干活不断供。日常开发信、资料整理的用量，花费通常很低、可控。

⚡ 直接照这个选​

推荐方案：DeepSeek API 或 GLM API（按量计费，无 5 小时 / 周用量限制）
零成本备选：BigModel 内置套餐 + GLM-5.3-Flash（有额度窗口限制，轻量尝鲜）
  • 推荐：接入 DeepSeek API（便宜、稳定）或 GLM API（第 1 步登录的就是智谱开放平台，拿 Key 最顺路）；
  • 零成本尝鲜：先用内置套餐体验，重度使用前再切 API；
  • 两个都接也完全可以——后面装 AI 员工团时，不同岗位正好分配不同模型。

两家的接入步骤、完整截图和避坑，各有一篇专题教程：

需要填的字段各家都一样，核心是这几项：

需要填说明
供应商名称自己认得就行，如 DeepSeek
API 格式选你 ZCode 下拉里能选到的那个
Base URL与 API 格式属于同一套，原样复制
API Key从厂商控制台创建，当密码对待
模型 ID以 ZCode 列表或厂商控制台为准
两条最容易踩的
  1. API 格式和 Base URL 必须是同一套组合，不要把 A 家的地址配到 B 家的格式上。
  2. 地址原样复制，不要自己加 /v1 或末尾斜杠 —— 每家写法不同（详见下方速查）。

填完先点「测试」，出现绿色「连接成功」才算通。

如果测试失败，先按这两条查：① 格式和地址是不是同一套组合；② 模型 ID 有没有从列表或控制台复制对。仍不通就按对应专题的避坑表和步骤逐项核对，不要盲目反复改组合。

🔑 API Key 当密码对待：只填进 ZCode，不要粘贴到聊天、日志、截图、教程或公开仓库；截图前确认已完全打码。发现异常消耗，立即到厂商控制台停用并重建。

接入后，在新建任务的输入框下方打开模型菜单，日常默认选 API 里的主力模型（如 DeepSeek 的 deepseek-chat，或 GLM 的 GLM-5.3-Flash）。

🟡 备选：内置套餐​

不想马上充 API，也可以先用内置套餐起步：点左下角账号菜单的 “升级” 查看并启用套餐（免费或付费以页面当前可选为准），日常模型选 GLM-5.3-Flash。

ZCode 升级套餐页面 - 个人套餐区域：左侧免费 Start Plan，右侧 GLM Coding Lite 可选，具体价格以当前页面为准

ZCode 新建任务输入框区域，模型菜单圈出 GLM-5.3-Flash，左下权限菜单圈出完全访问，适合作为日常默认配置

代价就是开头说的两条限制：5 小时额度窗口 + 每周用量上限。轻量尝鲜够用；把它当主力跑获客流程，容易干活干到一半断额度。

常用供应商速查​

下表是 Chat Completions 格式的入口（2026 年 9 月 8 日未鉴权探测显示路径存在，不代表你的账号或地域一定可用）。不确定选什么格式时优先 Chat Completions；厂商文档明确要求其他格式时按文档配置。

供应商Base URL详细教程 / 官方入口
DeepSeekhttps://api.deepseek.com📚 DeepSeek 完整指南 · Key 页
智谱 GLM（BigModel）https://open.bigmodel.cn/api/paas/v4📚 GLM API 按量计费 · Key 页
Kimi（月之暗面）https://api.moonshot.cn/v1Key 页 · 模型列表
阿里云百炼（通义千问）https://dashscope.aliyuncs.com/compatible-mode/v1百炼控制台
硅基流动 SiliconFlowhttps://api.siliconflow.cn/v1Key 页 · 模型广场
智谱相关条目可能有好几个，别点错

ZCode 里可能同时出现内置套餐、内置 API Key 供应商（这两类走的是 Anthropic 格式）和自建的按量供应商。只有你自己新建的那个才是按量路线，区别见 GLM 专题。

想看带截图的分步操作

本节只列字段速查。带截图的全流程看专题：

海外模型（如 Google Gemini）不在本表范围，需要时按 Google AI Studio 当前官方文档填写。

📋 避坑汇总​

坑后果怎么避
🔴 把 Key 贴到公开位置别人能刷你的钱只填进 ZCode；截图前打码；异常立刻停用重建
🔴 忘了点测试以为配好了，其实连不通必须看到「连接成功」再往下走
🟡 格式与地址不配套连接失败用同一行的组合，地址原样复制
🟡 模型 ID 手填或写旧名报「模型不存在」从 ZCode 列表或控制台复制
🟡 把内置套餐当主力重度使用5 小时 / 周用量限制频繁断供重度使用切 DeepSeek / GLM 按量 API

✅ 完成检查​

已接入按量 API​

  • 供应商显示「已启用」；
  • API 格式与 Base URL 来自同一套组合；
  • 模型 ID 从 ZCode 列表或厂商控制台复制；
  • 点测试显示「连接成功」，纯文本测试通过；
  • 新建任务的模型菜单里已选 API 模型作为日常默认；
  • 需要图片等能力时，已按官方能力确认并用普通文件试过。

暂用内置套餐​

  • 已选择可用的 BigModel 套餐；
  • 新建任务时已选择 GLM-5.3-Flash；
  • 知道额度有 5 小时窗口与每周上限，重度使用前会切 API。

📚 延伸阅读​

🚀 接下来

📄 第 4 步 · 安装 ZCode AI 员工团 —— 接好按量 API 后去装员工团，DeepSeek + GLM 双模型正好给不同岗位分工。