跳到主要内容

ZCode 套餐与模型配置

ZCode 零基础路线 · 第 3 步

先完成 内置套餐 → 日常模型 两项基础配置;确实需要其他模型时,再接入第三方 API。第三方模型是可选扩展,不是必做项。

小白直接照这个答案选

默认方案:BigModel 内置套餐 + GLM-5.3-Flash
需要特定模型时:再接入第三方 API
  • 只想先用起来:直接使用 BigModel 内置套餐;
  • 准备付费测试:可先选择页面中的 GLM Coding Lite(截图显示 ¥118 起)
  • 大部分日常任务:优先使用 GLM-5.3-Flash
  • 只有明确需要某个外部模型时,才继续阅读第三方接入部分。

基础配置(必做)

完成下面两项,第 3 步就算完成。

1. 选择内置套餐

点击左下角账号菜单中的 “升级” 查看套餐。

如果只是先测试,优先使用 ZCode 内置的 BigModel 套餐,不需要一开始就购买和配置多个第三方 API。准备付费试用时,可以先选择 GLM Coding Lite

下图截于 2026 年 9 月 4 日,页面显示 ¥118 起。价格和权益可能调整,请以你在 ZCode 当前页面看到的内容为准。

ZCode 升级套餐页面的个人套餐区域,左侧为免费 Start Plan,右侧为 118 元起的 GLM Coding Lite 试用选择

2. 选择日常模型

本站给小白的日常默认建议是 GLM-5.3-Flash:资料整理、页面阅读、截图分析和轻量修改通常已经够用,速度也较快。遇到长文档综合分析、多文件复杂改造,或连续两次结果仍不理想时,再切换更强模型。

在新建任务的输入框下方打开模型菜单,选择:

BigModel → GLM-5.3-Flash

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

基础配置完成

做到这里,第 3 步已经完成,可以直接开始实际任务。下面的第三方 API 只在你明确需要其他模型时再看。

第三方模型(选做)

1. 判断是否需要

只有下面这些情况,才需要继续配置:

  • 你已经有其他供应商的 API Key;
  • 某项任务明确要求使用指定模型;
  • 你需要内置套餐暂未提供的能力或模型。

如果都不符合,停在 GLM-5.3-Flash 即可

DeepSeek 只是演示

下面用 DeepSeek 展示完整填写方法。ZCode 也可以接入其他兼容供应商,操作思路相同,但地址、API 格式和模型 ID 必须以对应供应商的当前文档为准。

2. 打开模型设置

进入:

左下角齿轮 → 设置 → 模型设置

选择已有的 DeepSeek,或点击 “添加供应商” 新建配置。

3. 填写 DeepSeek 接口

按供应商当前文档填写。本文示例配置如下:

设置项示例
供应商DeepSeek
Base URLhttps://api.deepseek.com
API 格式Responses (/responses)
API Key你的 DeepSeek API Key
模型 IDdeepseek-v4-flash-vision-exp

DeepSeek 的 Responses API 格式可查看官方文档。模型 ID 与 Base URL 必须来自同一服务商;如果你的服务商列表中没有 deepseek-v4-flash-vision-exp,不要直接手填,改用该服务商实际提供的模型 ID。

ZCode 模型设置中的 DeepSeek 供应商配置页面,展示 Base URL、Responses API、已隐藏的 API Key 和多个模型 ID

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

4. 勾选“图片”

先做一个判断:到厂商官方模型列表确认该型号支持图像输入。确认支持,再按下面勾选“图片”;确认不了就按纯文本模型处理,只勾“文本”——不要凭模型系列名猜。

编辑模型 deepseek-v4-flash-vision-exp 时:

  1. 输入类型勾选 “文本”“图片”
  2. 输出类型勾选 “文本”
  3. 点击 “保存”

如果没有勾选“图片”,即使上传了截图,模型也可能无法按视觉模型方式读取。

ZCode 编辑模型配置弹窗,模型 ID 为 deepseek-v4-flash-vision-exp,输入类型同时勾选文本和图片,输出类型勾选文本

5. 启用并测试

  1. 回到 DeepSeek 供应商页面,确认状态为 “已启用”
  2. 新建任务;
  3. 在模型菜单选择 DeepSeek/deepseek-v4-flash-vision-exp
  4. 上传一张普通测试图片并提问;
  5. 能正确描述图片内容,才算配置完成。

如果测试失败,或提示“模型不存在”“供应商拒绝”,按这个顺序排查:

  1. 回到厂商控制台重新复制真实的模型 ID,大小写和符号必须完全一致;
  2. 核对 API 格式与 Base URL 是否属于同一套协议(见下方防错规则);
  3. 检查 API Key 是否有效、账户余额或额度、服务地域与套餐;
  4. 在普通对话里直接选择该模型发一句纯文本测试消息(不传图片),区分是模型配置问题还是任务里的操作问题。

以上都正常但仍失败时,先停一停:到厂商文档确认该型号支持的 API 格式,按文档重新选择格式并核对模型 ID 后再试,不要反复盲试不同组合。

6. 接入其他供应商

更换其他供应商时,仍然填写同一组信息:

Base URL
+ API 格式
+ API Key
+ 模型 ID
+ 输入能力(文本 / 图片 / 视频)

不要直接复制 DeepSeek 的地址和模型 ID。每个供应商都要使用自己的接口信息。

常用国产供应商速查

先说怎么选,再看表:

  • 已有哪家的 API Key,就只看那一家的行,不要一次配好几家;
  • 不确定选什么格式时,优先选 Chat Completions——它是各家官方文档都明确支持的通用接口格式;如果厂商文档对某型号明确要求其他格式,按文档配置;
  • Chat CompletionsResponsesAnthropic Messages 是三种“接口通信格式”,不是模型名称。同一家厂商在不同格式下的地址可能不同,换格式就要换对应的地址。

下表是 Chat Completions 格式速查(2026 年 9 月 8 日实测地址可达)。接口可能调整,填写前以厂商当前官方文档为准。

供应商Base URL适合场景
智谱 GLM(BigModel)https://open.bigmodel.cn/api/paas/v4/中文通用、日常主力
DeepSeekhttps://api.deepseek.com强推理、批量文本
Kimi(月之暗面)https://api.moonshot.cn/v1长文档、大上下文
阿里云百炼(通义千问 Qwen)https://dashscope.aliyuncs.com/compatible-mode/v1Qwen 系列、多模态视觉
硅基流动 SiliconFlowhttps://api.siliconflow.cn/v1一个 Key 用多家模型
三条防错规则
  1. API 格式和 Base URL 必须是同一行组合。不要把 Anthropic 的地址填进 Chat Completions 格式,也不要凭感觉改地址。
  2. 地址原样复制,包括 /v1 和末尾斜杠。不要给 DeepSeek 补 /v1,也不要删掉 Kimi 的 /v1——每家地址设计不同,不能互相套用。
  3. 模型 ID 必须从厂商控制台复制。大小写和符号完全一致;控制台列表里没有的型号,不要凭印象手填。

智谱、DeepSeek、Kimi 还提供 Anthropic Messages 格式,地址分别是 https://open.bigmodel.cn/api/anthropichttps://api.deepseek.com/anthropichttps://api.moonshot.cn/anthropic。同样只有官方文档明确支持、且你确实需要时才用,否则停在 Chat Completions 即可。

各厂商注意点

智谱 GLM(BigModel) · 内置套餐的来源厂商,中文通用、代码和日常任务的主力。

DeepSeek · 强推理、批量文本和成本敏感任务;本文就用它演示了完整接入(上方示例用的 Responses 也是 DeepSeek 支持的格式之一)。

Kimi / 月之暗面 · 长文档、知识工作和大仓库理解。

阿里云百炼(通义千问 Qwen) · 需要 Qwen-VL 等多模态能力时。

  • API Key:登录百炼控制台,在 API-KEY 管理页创建
  • 注意:百炼的接口地址与开通地域有关,以控制台和官方文档当前显示为准;上表是通用的 OpenAI 兼容入口。

硅基流动 SiliconFlow · 想用一个 Key 比较多家国产模型时。

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

完成检查

只使用内置套餐

  • 已选择可用的 BigModel 套餐;
  • 新建任务时已选择 GLM-5.3-Flash

完成这两项就可以开始实际任务。

还接入了第三方模型

  • 供应商显示“已启用”;
  • API 格式与 Base URL 来自速查表同一行(或厂商文档同一处);
  • 模型 ID 从厂商控制台复制;
  • 模型能在新建任务菜单中选中;
  • 文本测试成功;
  • 视觉模型已勾选“图片”且图片测试成功(纯文本模型无需勾选“图片”)。

下一步

完成模型配置后,进入 第 4 步 · 安装 ZCode AI 员工团,让不同模型按专业岗位协作。