首頁 → 指南 → Chatbox 接入自訂 API：主機、路徑、Claude 與生圖

Chatbox 接入自訂 API：主機、路徑、Claude 與生圖

Chatbox 接自訂 API 有三處容易出錯：API 主機和 API 路徑的搭配；Claude 模式要帶 /v1，而 Claude Code 偏偏不能帶；還有圖片產生器，它完全不認自訂供應商。我們讀了 Chatbox 1.23.5 的原始碼，把每種填法都在我們的閘道上實測一遍，並整理了真實 Chatbox 使用者遇到的錯誤。

新增供應商

1. 開啟 設定 → 模型供應商，點 新增自訂供應商。取個名字，API 模式 選 相容 OpenAI API。
2. API 主機 填 https://apiclan.us，API 路徑 留空。
3. 貼上主控台中的 API 金鑰。
4. 點 獲取 取得金鑰所屬分組的模型，再點 檢查 確認金鑰可用。

API 主機	API 路徑	Chatbox 實際請求
https://apiclan.us	（留空）	/v1/chat/completions ✓
https://apiclan.us/v1	/chat/completions	/v1/chat/completions ✓
https://apiclan.us	/chat/completions	/chat/completions ✗ 404

只有 API 路徑 為空時，Chatbox 才會替主機補上 /v1。一旦填了路徑，主機就原樣使用——所以 https://apiclan.us 配 /chat/completions 會漏掉 /v1，回傳內容為空的 404。要嘛路徑留空，要嘛把 /v1 寫進主機。

接入 Claude

有兩種方式，位址規則不同：

API 模式	API 主機	Chatbox 實際請求
相容 OpenAI API	https://apiclan.us	/v1/chat/completions ✓
相容 Claude API	https://apiclan.us/v1	/v1/messages ✓
相容 Claude API	https://apiclan.us	/messages ✗ 404

最簡單的是再新增一個 相容 OpenAI API 模式的自訂供應商，填 Claude 分組的金鑰——我們記錄到的 43 次 Chatbox 呼叫裡，有 29 次是用這種方式呼叫 claude-fable-5-1。若想用 相容 Claude API 模式，主機必須以 /v1 結尾，因為 Chatbox 只會在後面補 /messages。這和 Claude Code 正好相反：ANTHROPIC_BASE_URL 不能 帶 /v1。

在 Chatbox 裡產生圖片

圖片產生器 只列出內建的 OpenAI 供應商（以及 Chatbox 自家和 Gemini）。自訂供應商在程式碼裡寫死了沒有圖片模型，選它會出現 Provider doesnt support image generation。

1. 開啟 設定 → 模型供應商 → OpenAI（內建的那個，不是你新增的自訂供應商）。
2. API 主機 填 https://api.apiclan.us，金鑰用在 生圖分組 建立的那把。
3. 新增模型 gpt-image-2.5，模型類型 選 圖片。
4. 開啟 圖片產生器，選 gpt-image-2.5。

聊天模型繼續放在自訂供應商裡：一把金鑰只屬於一個分組，內建 OpenAI 供應商裡那把生圖金鑰跑不了 GPT 聊天模型。這裡用 api.apiclan.us，是因為大圖可能要好幾分鐘，而主位址超過 100 秒就會中斷。我們依 Chatbox 的請求格式實測，一張 1024×1024 的圖花了 21 秒。

真實 Chatbox 呼叫花了多少

截至 2026 年 10 月 12 日的 30 天內，我們閘道上全部 43 次 Chatbox 呼叫，都是經 /v1/chat/completions 的串流請求：

模型	呼叫次數	首字中位數	每則訊息平均
claude-fable-5-1	29	5.2 s	$0.039
gpt-6-astra	8	1.4 s	$0.006
gpt-5.6-sol	6	7.6 s	$0.004

這裡 Claude 一則回覆的花費約是 GPT 的 7 倍，主要因為回答較長（平均 622 個輸出 token）。Chatbox 每一輪都會把整段對話重送一遍，但在 Claude 上平均每次有 4,071 個 token 以快取讀取計費，而非全價輸入，長對話因此不會貴得離譜。gpt-5.6-sol 最便宜，但出首字最慢，因為它要先推理再回答。

真實 Chatbox 使用者遇到的錯誤

• 404 且內容為空 → 填了 API 路徑但主機裡沒有 /v1，或 相容 Claude API 模式沒帶 /v1。對照上面兩張表。
• 400 This model is not supported on the Chat Completions endpoint → 把 gpt-image-2.5 當聊天模型用了。圖片模型只能在 圖片產生器 裡用。
• 403 Image generation is not enabled for this group → OpenAI 供應商裡的金鑰不是生圖分組的。
• 404 model_not_found (is not supported by any configured account in this group) → 這個模型不在你金鑰的分組裡（有使用者手動輸入了 gpt-5.2-pro，我們沒有這個模型）。用 獲取 取得清單，不要手動輸入名稱。
• Provider doesnt support image generation → 圖片產生器選的是自訂供應商。改用內建的 OpenAI 供應商。

其他桌面用戶端： Cherry Studio 接入自訂 API · Claude Code 的 base URL.

開始使用

無訂閱、無最低消費、不用跟業務通話。用 USDT 儲值，用多少花多少 —— 1 USDT = 2 額度。

看 30 秒快速開始

語言: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

本頁價格由即時計費資料自動填入；第三方條款引自對方公開文件。