以 DeepSeek 为例走通第一次模型接入

原理懂了，用一个具体服务商把流程钉死。DeepSeek 是国内用户最常选的入门选项，接口完全兼容 OpenAI 格式，价格友好。任何其他兼容 OpenAI 格式的服务商，步骤完全同构。

第一步：拿到 Key

1. 注册并登录 DeepSeek 开放平台控制台
2. 左侧导航找到 API Keys，创建一个新 Key
3. 复制保存——Key 只在创建时完整展示一次

第二步：记下 Base URL

控制台左侧下方点「接口文档」进入 API 文档页，找 OpenAI 兼容接口的说明，记下 API Base URL：

https://api.deepseek.com/v1

官方文档特别提醒：如果地址里没有 /v1，手动补上。这是新手接入失败率最高的一个字符。

第三步：在面板里新增提供商

1. 打开管理面板「模型提供商」→「对话」
2. 点「新增」，类型选 DeepSeek（其他兼容服务选 OpenAI Compatible）
3. 填三项：提供商名称（随意起）、API Key（粘贴第一步的）、API Base URL（第二步的地址）
4. 点「保存并获取模型」，等待模型列表返回

第四步：启用模型

模型列表返回后，找到想用的模型（如 deepseek-chat），点右侧 + 启用。

列表拉不下来的兜底方案：先点「保存配置」，再用「自定义模型」手动填模型 ID。模型旁的「测试模型」按钮发一条真实请求验证连通性，通过再往下走。

第五步：设为对话模型

关键一步，跳过它机器人永远不说话：

1. 打开「配置文件」，选择机器人实际使用的配置文件
2. 进入「AI → 模型」，把「对话模型」设为刚启用的模型
3. 右下角「保存配置」

到这里模型接入完成。此时在内置 ChatUI 里就能对话验证，不用急着接消息平台——先把脑子装好，再接嘴巴。

换服务商的成本

体验过这套流程后会发现：换一家服务商就是重复第三、四步，五分钟的事。这也是前面强调「弹药库」结构的原因——囤多个提供商，用配置文件切换，不同场景用不同模型（便宜的跑闲聊、强的跑干活）完全可行。