文件

Chatbox

Chatbox 會將端點拆分為主機和路徑，並自動填入路徑。因此，主機欄位應填來源網址——這個用戶端最容易讓人犯的錯，就是在主機中加上 /v1。

新增一個類型為 OpenAI API Compatible 的供應商，將 API Host 設為服務根目錄 — Chatbox 會自行附加 /v1/chat/completions。

Chatbox 設定

Settings → Model Providers → Add

  API 提供方名称 / Provider name   Kunavo
  API 类型 / Type                 OpenAI API 兼容 (OpenAI API compatible)
  API 密钥 / API Key              sk-kn-...
  API 主机 / API Host             https://api.kunavo.com
  API 路径 / API Path             (leave empty → /v1/chat/completions)
  Model                           claude-sonnet-5

API Host 應填 https://api.kunavo.com，不含 /v1。Chatbox 設有獨立的 API Path 欄位，預設值為 /v1/chat/completions，因此如果主機網址已以 /v1 結尾，送出的請求就會指向 /v1/v1/chat/completions。除非您確定需要其他設定，否則請將路徑留空。

Chatbox 的供應商類型選擇器指定的是傳輸格式。請選擇 OpenAI API 相容 (OpenAI API compatible)，接著輸入 Claude 模型 ID——端點會解析該 ID，因此兩者並不衝突。

還沒有金鑰？建立 Kunavo 帳戶，建立金鑰（以 sk-kn- 開頭），並從 $10 起新增額度——呼叫會從該餘額扣款，失敗的呼叫不會計費。之後儀表板會開啟 Chatbox 設定。

逐步操作

在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
開啟設定 → 模型供應商，然後點選新增。
為供應商命名，將類型設為 OpenAI API 相容，並貼上 API Key。
將 API 主機 / API Host 設為 https://api.kunavo.com，並將 API 路徑 / API Path 留空。
新增您要使用的模型 ID，儲存後即可開始對話。

已於 2026年9月6日根據 Chatbox 的供應商設定指南進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Chatbox 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

模型 ID	Kunavo 輸入／輸出	它在 Chatbox 中的位置
`claude-sonnet-5`	$1.40 / $7.00	預設對話模型
`claude-haiku-4-5`	$0.70 / $3.50	適合短對話，延遲和價格都很重要
`claude-opus-5`	$3.50 / $17.50	保留為第二個供應商項目，供難題使用
`gpt-5-6-terra`	$0.70 / $4.20	使用同一個金鑰呼叫不同模型系列

計費方式是從預付餘額按權杖計費，沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取對帳單的影響比模型選擇更大。

常見問題

OpenAI 相容端點的 Chatbox API Host 應填什麼？

填入來源網址，不含路徑，例如 https://api.example.com。Chatbox 設有獨立的 API Path 欄位，預設值為 /v1/chat/completions；其文件指出通常不需要填寫，因此 /v1 來自路徑欄位，而非主機。若主機網址以 /v1 結尾，請求就會指向 /v1/v1/chat/completions，並回傳 404。

如何在 Chatbox 中新增自訂模型供應商？

開啟「設定」→「模型供應商」，點選「新增」，接著為供應商命名、選擇 OpenAI 相容 API 類型、貼上 API 金鑰、將 API Host 設為端點的來源網址，並將 API Path 留空。新增您要使用的模型 ID 並儲存後，該供應商就會出現在每個對話的模型選擇器中。

Chatbox 可以使用 Claude 模型嗎？

可以，透過提供這些模型的 OpenAI 相容端點即可。Chatbox 會將您輸入的模型 ID 傳送至所設定的主機，因此 Claude ID 會由該端點解析，而非由 Chatbox 解析；應用程式本身不需要 Anthropic 憑證。供應商類型選擇器選擇的是傳輸格式，而非廠商。

什麼時候應該填寫 Chatbox 的 API Path？

只有在端點不透過 /v1/chat/completions 提供聊天完成服務時才需要填寫。此欄位是為路由方式特殊的閘道而設；對標準的 OpenAI 相容服務，留空才是正確設定。輸入路徑是常見的 404 原因，而且這類 404 容易被誤認為是驗證問題。