HopBase 文檔第三方客戶端
在 Cherry Studio、NextChat、LobeChat 等客戶端中配置 HopBase。
Cherry Studio、NextChat、LobeChat 等桌面或網頁客戶端都使用同一組核心參數。供應商類型必須與模型協議一致。
| 你要用的模型 | 供應商類型 | API 地址 / Base URL | API Key |
|---|---|---|---|
| GPT / GLM / Gemini 系列 gpt-5.6-sol / glm-5.3 / gemini-3.8-flash 等 | OpenAI（Chat Completions） | https://api.hop-base.com/v1 | 對應分組的金鑰 |
| Claude 系列 claude-sonnet-5 等 | 必須選「Anthropic」 | https://api.hop-base.com（不帶 /v1） | Claude Max(官號滿血版)或 Claude Max(官號滿血版)- 限時特惠分組金鑰；Claude Max（ccmax）只能用於 Claude Code |
配置步驟
確認可用模型
使用目標分組金鑰調用 GET /v1/models，複製完整模型 ID。
新增自訂供應商
在客戶端設定中按上表填入供應商類型、Base URL、API Key 和模型 ID。
保存並測試
選擇剛新增的模型，傳送「只回覆 ok」。如果返回 404，先檢查 Claude 是否誤選了 OpenAI 類型，以及 Base URL 是否多了或少了 /v1。
Claude 金鑰必須選 Anthropic 類型：
Claude 分組金鑰別選「OpenAI」類型——會報 404「目前平台不支援此 API 路徑」，必須選「Anthropic」類型。客戶端沒有 Anthropic 類型就換一個（Cherry Studio 有），或用控制台線上對話。
網頁版已支援直連，但通常不會自動補 API 路徑。使用 OpenAI / GPT / GLM 模式時，Base URL 必須填完整的 https://api.hop-base.com/v1；Claude 的 Anthropic 模式依上表不帶 /v1。