HopBase 文档WorkBuddy
把 HopBase 设为 WorkBuddy 的 OpenAI 兼容模型供应商。
WorkBuddy 可以把 OpenAI 兼容端点当作底层模型来调用，因此 HopBase 可以作为它背后的模型底座。
一键生成配置（推荐）
粘贴一把对话类分组的密钥，生成器会用它调 GET /v1/models，列出能在 WorkBuddy 里用的模型，再生成写入配置文件的命令。模型 ID 必须一字不差，从密钥读出来就不会写错。
配置文件是 ~/.workbuddy/models.json，Windows 上是 %USERPROFILE%\.workbuddy\models.json。WorkBuddy 会自动重新加载它，写入后模型下拉框里就能看到新模型。
命令会整份覆盖这个文件，原文件先备份为 models.json.bak-<时间>。之前手动加过模型的话，可以从备份里把对应条目复制回来。
在界面里手动填写
| 配置项 | 填什么 |
|---|---|
| 协议 / 供应商类型 | OpenAI（Chat Completions） |
| API 地址 / Base URL | https://api.hop-base.com/v1 |
| API 密钥 | 一把对话类模型分组的密钥 |
| 模型 | 用该密钥调 GET /v1/models 返回的精确 ID |
界面里填 Base URL 即可。直接编辑 models.json 时，url 要写完整端点：
https://api.hop-base.com/v1/chat/completions生产实测：WorkBuddy 打的是 POST /v1/chat/completions，流式正常。
选一把能调对话模型的密钥
登录控制台，使用分组提供 OpenAI 协议对话模型的密钥——GPT / Codex、GLM、Kimi K3、DeepSeek、通义千问、Grok 都可以。
读取精确的模型 ID
curl https://api.hop-base.com/v1/models \
-H "Authorization: Bearer sk-your-key"从返回结果里原样复制一个 ID。
填写供应商
在 WorkBuddy 的模型供应商设置里选择 OpenAI 兼容类型，再填入上面的 Base URL、密钥与模型 ID。
发一条测试消息
让它只回一个词。这一次成功往返就同时验证了密钥、分组、协议、模型 ID 四项都对得上。
常见报错
| 报错 | 原因 | 改法 |
|---|---|---|
route_not_found | 密钥属于生图或视频分组，没有对话端点 | 换对话模型分组的密钥 |
404 model_not_found | 模型 ID 写成了简写，比如 glm | 写完整 ID，比如 glm-5.3 |
可灵、Seedance、MiniMax、万相 / 快乐马这些分组提供的是任务制的媒体端点，不提供 chat/completions。模型 ID 带版本或日期，一律从 GET /v1/models 原样复制。
关于 Claude 模型
Claude 走的是 Anthropic 协议，不是 Chat Completions，WorkBuddy 调不了。请把它指向提供 OpenAI 协议模型的对话分组。各模型种类分别用什么协议，见第三方客户端里的对照表。
长系统提示词
WorkBuddy 会下发很长的指令上下文，单轮就可能带上数万输入 Token。请选上下文窗口装得下的模型；另外部分模型种类在输入跨过阈值后会升档，详见「模型接入」下各族自己的页面。