本篇导读
预计阅读时间：8 分钟。读完你会明白接入一个模型服务要准备的五样东西——名称、Base URL、API Key、API 格式（协议）、模型，并且亲手配好你的第一个模型。
客户端只是身体，现在给它接上大脑。接入一个模型服务，说到底就是填一张表，表里有五个空：名称、Base URL、API Key、API 格式（协议）、模型。一个一个来讲。
1. 名称
就是给这个模型服务提供商起个名字，用于区分不同的模型渠道，比如 VIDDsys API（本站提供的聚合模型服务）。它的作用只是在客户端里帮你区分不同的服务商，不影响连接。
2. Base URL
打个比方：模型服务是一家电厂，Base URL 就是电厂的地址——你的软件不用自己发电，找到这个地址、插上插座就能用电。它是一个网址，通常长这样：https://api.viddsys.xyz/v1 （本站提供的聚合模型服务地址）。
3. API Key
而 API Key 就是你家的电表账号：电厂靠它识别「这次用电是谁用的」。它是一串字符，通常长这样：sk-xxxxxxxxxxxxxxxx。也叫做 API 密钥，须严格保密，并存储在只有你知道的地方。
这带来两个重要推论：
- Key 就是钱。 谁拿到你的 Key，谁就能用你的额度。所以它和密码同等重要，不要发给任何人，不要贴到公开场合。
- 按量付费。 大部分模型服务按用量计费（通常以 token 为单位，一个 token 大约相当于一到两个汉字），用多少付多少，和电费一个逻辑。
4. API 格式（协议）
电厂插座的接口标准。同样是供电，插座得有统一规格，你的插头才能插得上。模型服务也一样——好在业界基本都遵循同一个标准，叫 OpenAI 协议。所以这一项通常不用纠结，选 Chat Completions（/chat/completions）兼容即可；你在主流模型厂商注册的 Key，大部分也是这个协议。
5. 模型
接通了电，最后还得选用什么电器。一个服务里往往有好多模型，各有各的擅长。你要做的就是从服务商提供的模型列表里挑一个，填上它的模型 ID。不同模型能力不同，价格也不同，选择适合当前所需完成任务的模型。比如设计开发类的任务可以选择较好一些的模型，而一些批量任务，整理、搜索类则可以选择性价比较高的模型。模型列表及其对应价格可以到 https://api.viddsys.xyz/pricing 查看。
为什么要接「第三方」模型
正因为大家都遵循 OpenAI 协议这一统一标准，Zcode 这样的客户端才支持接入任何兼容该协议的模型服务——这意味着：
- 你可以一个客户端换着用多个模型：写代码用 A，写文案用 B，都不用换软件。
- 你可以用中转站这类聚合服务：一个 Key 里面有好多模型，不用挨家挨户注册。
本教程配套的 viddsys.xyz 就提供这样一个模型中转服务（api.viddsys.xyz），注册后在控制台就能创建 Key、查看可用模型和用量，正好用来练手。
动手：通过中转站接入
下面以本教程配套的中转站为例，完整走一遍。要填的就是前面讲的那五样，控制台里全都有，照着抄就行。
第一步：注册并拿到你的 Key
- 打开 https://api.viddsys.xyz，注册并登录。
- 进入控制台，找到「API 密钥」页面，新建一个令牌。
- 复制生成的
sk-开头的字符串——这就是你的 API Key，保存好。
第二步：在 Zcode 里填表
打开 Zcode → 左下角进入设置页面 → 模型设置 → 按下表填写：
| 填写项 | 填什么 |
|---|---|
| 名称 | VIDDsys API |
| Base URL | https://api.viddsys.xyz/v1 |
| API Key | 刚才复制的 sk- 令牌 |
| API 格式 | 选 Chat Completions（/chat/completions） |
| 模型 | deepseek-v4-flash（可先用该模型测试） |
第三步：添加模型
点 添加模型，输入你想用的模型 ID。可用哪些模型、ID 分别是什么，控制台的「模型」页面有完整的模型和价格列表，点击复制粘贴即可。
打开启用开关，回到聊天框选中这个模型——配置完成。
验证
发一条「你好，介绍一下你自己」，正常回话就是通了。不通的话，回到附录 A.1 的「症状一」按顺序排查，九成是 Key 或地址抄错了。
用其他服务商（DeepSeek、智谱官方等）也一样：官网注册 → 拿 Key → 填同样的表，只是 Base URL 和 Key 换成对应服务商的。会一个，就全会了。
使用 Gemini 模型的注意点
如果你添加 Gemini 系列的模型，最大输出（Max Output Tokens）必须设置为 60000 及以下，超出这个值请求会报错。其他模型不受影响。
下一节讲几个关于模型的关键概念——不多，但每个都直接影响你的使用体验和钱包。