ZCode 套餐与模型配置
先完成 内置套餐 → 日常模型 两项基础配置;确实需要其他模型时,再接入第三方 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 当前页面看到的内容为准。

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

做到这里,第 3 步已经完成,可以直接开始实际任务。下面的第三方 API 只在你明确需要其他模型时再看。
第三方模型(选做)
1. 判断是否需要
只有下面这些情况,才需要继续配置:
- 你已经有其他供应商的 API Key;
- 某项任务明确要求使用指定模型;
- 你需要内置套餐暂未提供的能力或模型。
如果都不符合,停在 GLM-5.3-Flash 即可。
下面用 DeepSeek 展示完整填写方法。ZCode 也可以接入其他兼容供应商,操作思路相同,但地址、API 格式和模型 ID 必须以对应供应商的当前文档为准。
2. 打开模型设置
进入:
左下角齿轮 → 设置 → 模型设置
选择已有的 DeepSeek,或点击 “添加供应商” 新建配置。
3. 填写 DeepSeek 接口
按供应商当前文档填写。本文示例配置如下:
| 设置项 | 示例 |
|---|---|
| 供应商 | DeepSeek |
| Base URL | https://api.deepseek.com |
| API 格式 | Responses (/responses) |
| API Key | 你的 DeepSeek API Key |
| 模型 ID | deepseek-v4-flash-vision-exp |
DeepSeek 的 Responses API 格式可查看官方文档。模型 ID 与 Base URL 必须来自同一服务商;如果你的服务商列表中没有 deepseek-v4-flash-vision-exp,不要直接手填,改用该服务商实际提供的模型 ID。

API Key 当密码对待:只需要填进 ZCode,不要粘贴到聊天、日志、截图、教程或公开仓库;截图前确认已完全打码。发现异常消耗时,立即到厂商控制台停用并重建 Key。
4. 勾选“图片”
先做一个判断:到厂商官方模型列表确认该型号支持图像输入。确认支持,再按下面勾选“图片”;确认不了就按纯文本模型处理,只勾“文本”——不要凭模型系列名猜。
编辑模型 deepseek-v4-flash-vision-exp 时:
- 输入类型勾选 “文本” 和 “图片”;
- 输出类型勾选 “文本”;
- 点击 “保存”。
如果没有勾选“图片”,即使上传了截图,模型也可能无法按视觉模型方式读取。

5. 启用并测试
- 回到 DeepSeek 供应商页面,确认状态为 “已启用”;
- 新建任务;
- 在模型菜单选择
DeepSeek/deepseek-v4-flash-vision-exp; - 上传一张普通测试图片并提问;
- 能正确描述图片内容,才算配置完成。
如果测试失败,或提示“模型不存在”“供应商拒绝”,按这个顺序排查:
- 回到厂商控制台重新复制真实的模型 ID,大小写和符号必须完全一致;
- 核对 API 格式与 Base URL 是否属于同一套协议(见下方防错规则);
- 检查 API Key 是否有效、账户余额或额度、服务地域与套餐;
- 在普通对话里直接选择该模型发一句纯文本测试消息(不传图片),区分是模型配置问题还是任务里的操作问题。
以上都正常但仍失败时,先停一停:到厂商文档确认该型号支持的 API 格式,按文档重新选择格式并核对模型 ID 后再试,不要反复盲试不同组合。
6. 接入其他供应商
更换其他供应商时,仍然填写同一组信息:
Base URL
+ API 格式
+ API Key
+ 模型 ID
+ 输入能力(文本 / 图片 / 视频)
不要直接复制 DeepSeek 的地址和模型 ID。每个供应商都要使用自己的接口信息。
常用国产供应商速查
先说怎么选,再看表:
- 已有哪家的 API Key,就只看那一家的行,不要一次配好几家;
- 不确定选什么格式时,优先选 Chat Completions——它是各家官方文档都明确支持的通用接口格式;如果厂商文档对某型号明确要求其他格式,按文档配置;
Chat Completions、Responses、Anthropic Messages是三种“接口通信格式”,不是模型名称。同一家厂商在不同格式下的地址可能不同,换格式就要换对应的地址。
下表是 Chat Completions 格式速查(2026 年 9 月 8 日实测地址可达)。接口可能调整,填写前以厂商当前官方文档为准。
| 供应商 | Base URL | 适合场景 |
|---|---|---|
| 智谱 GLM(BigModel) | https://open.bigmodel.cn/api/paas/v4/ | 中文通用、日常主力 |
| DeepSeek | https://api.deepseek.com | 强推理、批量文本 |
| Kimi(月之暗面) | https://api.moonshot.cn/v1 | 长文档、大上下文 |
| 阿里云百炼(通义千问 Qwen) | https://dashscope.aliyuncs.com/compatible-mode/v1 | Qwen 系列、多模态视觉 |
| 硅基流动 SiliconFlow | https://api.siliconflow.cn/v1 | 一个 Key 用多家模型 |
- API 格式和 Base URL 必须是同一行组合。不要把 Anthropic 的地址填进 Chat Completions 格式,也不要凭感觉改地址。
- 地址原样复制,包括
/v1和末尾斜杠。不要给 DeepSeek 补/v1,也不要删掉 Kimi 的/v1——每家地址设计不同,不能互相套用。 - 模型 ID 必须从厂商控制台复制。大小写和符号完全一致;控制台列表里没有的型号,不要凭印象手填。
智谱、DeepSeek、Kimi 还提供 Anthropic Messages 格式,地址分别是 https://open.bigmodel.cn/api/anthropic、https://api.deepseek.com/anthropic、https://api.moonshot.cn/anthropic。同样只有官方文档明确支持、且你确实需要时才用,否则停在 Chat Completions 即可。
各厂商注意点
智谱 GLM(BigModel) · 内置套餐的来源厂商,中文通用、代码和日常任务的主力。
- API Key:open.bigmodel.cn/usercenter/apikeys
- 模型列表:docs.bigmodel.cn 模型总览
- 注意:本表只列 Chat Completions;其他格式以智谱当前官方文档为准。
DeepSeek · 强推理、批量文本和成本敏感任务;本文就用它演示了完整接入(上方示例用的 Responses 也是 DeepSeek 支持的格式之一)。
- API Key:platform.deepseek.com/api_keys
- 文档:api-docs.deepseek.com
- 注意:Responses 属于较新的格式,能用哪些参数以官方文档为准;视觉任务只选官方标注图像输入的型号。
Kimi / 月之暗面 · 长文档、知识工作和大仓库理解。
- API Key:platform.kimi.com/console/api-keys
- 模型列表:platform.kimi.com/docs/models
- 注意:同一模型在不同格式下图片和工具调用能力可能不同,按所选格式的官方文档核对。
阿里云百炼(通义千问 Qwen) · 需要 Qwen-VL 等多模态能力时。
- API Key:登录百炼控制台,在 API-KEY 管理页创建
- 注意:百炼的接口地址与开通地域有关,以控制台和官方文档当前显示为准;上表是通用的 OpenAI 兼容入口。
硅基流动 SiliconFlow · 想用一个 Key 比较多家国产模型时。
- API Key:cloud.siliconflow.cn/account/ak
- 模型广场:cloud.siliconflow.cn/models
- 注意:平台模型会上下线,视觉和工具调用能力要逐个型号核对。
海外模型(如 Google Gemini)不在本表范围,需要时按 Google AI Studio 当前的官方文档填写。
完成检查
只使用内置套餐
- 已选择可用的 BigModel 套餐;
- 新建任务时已选择
GLM-5.3-Flash。
完成这两项就可以开始实际任务。
还接入了第三方模型
- 供应商显示“已启用”;
- API 格式与 Base URL 来自速查表同一行(或厂商文档同一处);
- 模型 ID 从厂商控制台复制;
- 模型能在新建任务菜单中选中;
- 文本测试成功;
- 视觉模型已勾选“图片”且图片测试成功(纯文本模型无需勾选“图片”)。
下一步
完成模型配置后,进入 第 4 步 · 安装 ZCode AI 员工团,让不同模型按专业岗位协作。