AstrBot 接入 Models Hub:配置模型提供商
在 AstrBot 管理面板里新增 OpenAI 模型提供商并指向 Models Hub,配置默认聊天模型后即可在 QQ、飞书等平台使用,附推荐模型与常见报错排查。
AstrBot 是一个开源的一站式 Agent 聊天机器人平台,能把大模型能力接入 QQ、飞书、钉钉、企业微信等主流即时通讯软件。它的「模型提供商」支持标准 OpenAI 接口,把提供商地址指向 Models Hub 后,AstrBot 里配置的所有对话流程都会用 Models Hub 的额度调用你指定的模型。本文只讲接入,AstrBot 的机器人搭建见官方文档。
三样东西
接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com/v1、一个模型名。
准备
推荐模型
| 用途 | 模型名 | 定价 | 实时状态 |
|---|---|---|---|
| 日常对话首选,速度与质量的平衡点 | claude-sonnet-4-6 | 查看价格 | 可用率与延迟 |
| 复杂推理与长上下文 | gpt-5.5 | 查看价格 | 可用率与延迟 |
| 便宜快速,适合高频群聊问答 | gpt-5.4-mini | 查看价格 | 可用率与延迟 |
模型名以 模型定价页 为准。
配置步骤
-
登录 Models Hub,点击顶部「控制台」→「令牌管理」→「添加令牌」,创建一个新的 API Key,选择合适的权限后点「创建」。
-
创建成功后点复制按钮,复制生成的 API Key。
-
打开 AstrBot 管理面板,进入「模型提供商」页面,点「新增模型提供商」,选择 OpenAI(AstrBot 对 OpenAI Chat Completion 和 Responses 接口都支持,Models Hub 走这条路径接入)。
-
在弹出的对话框中填写:
字段 填什么 API Base URL https://modelsok.com/v1(本地部署的 Models Hub 则填本地地址,如http://localhost:3000/v1)API Key 你刚复制的 Models Hub API Key 模型名称 上面推荐表里的模型名 填完点「保存」。
-
进入「配置文件」页面,找到模型一节,把「默认聊天模型」改成刚创建的 Models Hub 提供商,点「保存」。
验证
在 AstrBot 管理面板的调试对话框,或已绑定的 QQ/飞书等平台里发一句「你好」,能正常回复即接通。再打开 Models Hub 控制台的 用量日志,几秒内会出现一条对应模型名的请求,确认走的是 Models Hub。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 保存提供商时提示连接失败 | API Base URL 写错,或本地部署时用了公网地址(反之亦然) | 第三方站点用 https://modelsok.com/v1,本地部署用实际可达的地址 |
401 / Invalid API key | Key 复制不完整,或令牌被禁用 | 到 令牌页 重新复制 |
| 对话报模型不存在 | 模型名拼错,或令牌所在分组没有该模型 | 对照 定价页 核对名字 |
回复很慢或报 429 | 触发限流,通常是并发过高 | 稍后重试;持续出现联系客服提额 |
| 用量日志里没有记录 | 「默认聊天模型」没有切换成新提供商 | 回到「配置文件」页面确认默认聊天模型选中的是 Models Hub 提供商 |
更多排查见 故障排查。
常见问题
计费方式? 按每次对话实际消耗的输入与输出 token 计费,价格看各模型定价页,用量日志里能看到每条请求的明细。
和直接用 OpenAI 官方接口有什么区别? 请求格式一致,只是把地址换成了 Models Hub;一个 Key 能在同一个提供商下切换 Claude、GPT 等多家模型。
怎么切换模型? 回到「模型提供商」编辑刚配置的 OpenAI 提供商,改模型名称;或新增另一个提供商,再到「配置文件」页面切换默认聊天模型。