常見問題

不需要。HopBase 在國內可直接訪問，無需任何代理。

OpenAI 協議（GPT、Codex、第三方客戶端）帶 /v1；Anthropic 協議（Claude Code、Anthropic SDK）不帶，客戶端會自動補全。

選擇 OpenAI Chat Completions（需開啟路由），Base URL 填 https://api.hop-base.com/v1，模型填 glm-5.3。

使用 OpenAI Images 協議：POST https://api.hop-base.com/v1/images/generations，傳 model、prompt、size。Gemini Banana 與 Seedream 系列也走同一協議結構；各模型的圖生圖與非同步能力不同。Seedream 支援同步文生圖及最多 10 張參考圖的圖生圖 / 編輯：在 generations JSON 加 image，或使用 /v1/images/edits，請參見圖片生成 API。

可以。一把金鑰最多可包含 10 個分組，可以跨平台：在控制台「API 金鑰」建立金鑰時同時選上 Codex Plus 或 Codex Pro 分組與 Claude Max 分組，或編輯已有金鑰補上缺的分組。每次請求按服務該模型的分組計費。各模型仍走自己的協議：GPT 用 OpenAI 相容端點，Claude 用 /v1/messages。

完全可以。推薦走控制台「一鍵接入」（彈窗裡切到 Windows PowerShell 命令）；手動配置見 Claude Code 與 Codex CLI 兩頁的 Windows PowerShell 分頁。

命令裡帶的是 15 分鐘內有效、只能使用一次的接入權杖，不是金鑰本身；腳本只寫本機配置檔，原有配置會自動備份。

可以，同一把金鑰可在多裝置使用，用量合併計入同一帳戶。建議給不同裝置各建一把並命名，方便在用量裡區分。

登入控制台，「使用記錄」裡可以看每一筆調用的模型、token 數和扣費。程式裡用 API 金鑰調 GET https://api.hop-base.com/v1/usage，可查這把金鑰當前可用的餘額（已按金鑰額度與企業額度取小），返回欄位見帳戶 API。

登入控制台，在選單中點「增值」，選好金額後按頁面提示付款；付款前頁面會列出實付金額與到帳金額，付款成功後餘額自動入帳。需要對公轉帳等其他付款方式，聯絡我們。

自 2026-10-01 起，餘額以美元（USD）計價：控制台的餘額、扣費與使用記錄都以 $ 顯示，模型按官方美元價乘以分組倍率計費。切換前的餘額已按固定比例換算為美元，可用量不變。介面回傳的 cost 是同一筆扣費的人民幣金額，美元金額看 cost_usd，見餘額與計價幣種。增值時付款幣種、手續費與到帳金額以「增值」頁付款前顯示的為準；人民幣對公轉帳或線下增值的到帳美元金額以客服確認為準。

按服務條款第 4 節：已消耗的額度，以及促銷、獎勵等贈送額度，不按現金退還。其他退款需求請帶上帳戶郵箱與「增值記錄」裡的訂單號，聯絡我們。

需要發票或對公結算時，請帶上帳戶郵箱、「增值記錄」裡的訂單號與開票資訊，聯絡我們。

通常是該模型暫時不可用或響應超時：稍等後退避重試，也可以換同系列的其他模型。持續超過 10 分鐘，請帶上回應頭裡的 X-Request-ID 聯絡我們。重試規則見錯誤碼與重試。

看 error.message（無 code，不扣費），改好再提交。見錯誤碼與重試。

已支援瀏覽器直連。使用 OpenAI / GPT / GLM 模式時，網頁版通常不會自動補 API 路徑，Base URL 必須手動填完整的 https://api.hop-base.com/v1；只填 https://api.hop-base.com 會連不上。Claude 的 Anthropic 模式依上文規則不帶 /v1。