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。請選上下文視窗裝得下的模型；另外部分模型種類在輸入跨過閾值後會升檔，詳見「模型接入」下各族自己的頁面。