文件
ChatWise
ChatWise 的所有供應商都使用相同的三個欄位。為自訂供應商命名,填入 API Base URL 和金鑰,按下「Fetch」,模型選擇器就會載入 Claude 和 GPT 的 ID,並共用同一筆餘額。
Settings → Providers → "+" 透過三個欄位建立自訂供應商 — Provider name、設為 https://api.kunavo.com/v1 的 API Base URL,以及 API Key — 然後 Fetch 從端點讀取模型清單。
Provider name Kunavo
API Base URL https://api.kunavo.com/v1
field help: "Do NOT include /chat/completions in the URL"
API Key sk-kn-...
Models click Fetch to read the list from the endpoint,
or "+ New" and type an id by hand
"+ New" → Chat Models, the fields the docs name:
Model ID claude-sonnet-5
Display Name Claude Sonnet 5 (Kunavo)
Capabilities image input / reasoning flag — tick what the model does
Context length as published on the models page/v1。 ChatWise 直接在欄位下方說明規則 —「請勿在 URL 中包含 /chat/completions」— 因此此欄位應填入路由所依附的根 URL,而非路由本身。文件中唯一展示已填入該欄位的託管閘道,採用的也是相同格式:https://aihubmix.com/v1。若基礎 URL 已包含路由,請求會回傳 404,而非驗證錯誤。chatwise.app 的桌面用戶端,支援 macOS、Windows 和 Linux;其文件位於 docs.chatwise.app。其公開 GitHub 發佈動態遠早於目前出貨版本便已停止更新,因此如果此處的畫面截圖與您看到的不同,請以應用程式本身的下載版本為準,而非該動態。sk-kn- 開頭),並從 $10 起新增額度——呼叫會從該餘額扣款,失敗的呼叫不會計費。之後儀表板會開啟 ChatWise 設定。逐步操作
- 在
/app/keys建立金鑰並複製——金鑰只會顯示一次。 - 在 ChatWise 中,開啟設定 → 供應商,然後點選 "+" 新增供應商。文件提供兩種方式:選擇其中一個內建預設項目,或是建立自訂設定——Kunavo 不是預設項目,因此請選擇第二種方式。
- 如上所述,填入 Provider name、API Base URL 和 API Key。表單中沒有選擇廠商的欄位:模型 ID 由端點解析,因此在 OpenAI 相容供應商後方使用 Claude ID,正是預期的組合,並非設定不相符。
- 在模型那一列按下 Fetch。ChatWise 文件指出,如果 API 支援
/models端點,就能自動新增可用模型;Kunavo 會回應GET /v1/models,因此清單會自動載入。若您想自行輸入 ID,也可以按下 + New。 - 如果您手動新增模型,文件列出的欄位如下:Model ID 是 API 識別碼,Display Name 只是標籤,因此 ID 必須與型錄完全一致。勾選 Capabilities 並將 Context length 設為與模型相符——這些設定會告訴用戶端要提供哪些功能,不會改變端點的行為。
- 在模型選擇器中選擇該供應商,並傳送訊息。對於圖像模型,ChatWise 的圖像生成頁面還要求多做一步:必須先將模型類型設為 Image,它才會出現在圖像選擇器中。
已於 2026年9月21日 根據 ChatWise 的自訂供應商頁面 進行確認。第三方設定會變動;如果這裡的欄位名稱不再與你看到的內容相符,應以該頁面為準,而不是本頁。
除錯用戶端前先驗證
一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON,則相同的基礎 URL 與金鑰在 ChatWise 中也能運作。
# 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 輸入/輸出 | 它在 ChatWise 中的位置 |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | 日常對話——長篇聊天中,每美元能換得多少品質是關鍵 |
claude-opus-5 | $3.50 / $17.50 | 原本需要另開一個應用程式才能處理的難題 |
claude-haiku-4-5 | $0.70 / $3.50 | 標題、摘要及聊天用戶端自行發出的背景呼叫 |
gpt-5-6-terra | $0.70 / $4.20 | 長篇文件貼上後,上下文視窗大小便成為限制 |
gpt-5-6-sol | $2.00 / $12.00 | 使用同一個金鑰,透過另一個模型系列尋求第二意見 |
常見問題
如何在 ChatWise 中新增自訂 API 供應商?
開啟「設定」,前往「供應商」,然後點選「+」新增供應商;接著選擇預設項目或建立自訂設定。填入 Provider name、API Base URL 和 API Key,再使用「Fetch」按鈕或「+ New」新增模型。ChatWise 的自訂供應商文件將此功能描述為整合任何 OpenAI 相容或 Anthropic 相容的 AI 服務,因此閘道是正式支援的使用情境,不是權宜做法。
ChatWise 的 API Base URL 需要以 /v1 結尾嗎?
對 OpenAI 相容端點來說,需要。ChatWise 會在欄位下方說明規則:網址中不要包含 /chat/completions。用戶端會自行附加路由,因此應填入 /v1 根路徑,也就是 https://api.kunavo.com/v1;ChatWise 文件展示的唯一一個已填入此欄位的託管閘道也採用相同格式:https://aihubmix.com/v1。若未加上 /v1,會得到 404 而非驗證錯誤,這是區分這兩種錯誤最快的方法。
為什麼 ChatWise 的 Fetch 沒有傳回模型?
模型清單會使用您輸入的金鑰,從端點的 /models 路由取得,因此如果清單是空的,問題通常出在金鑰或 Base URL,而非型錄為空。請在應用程式外部使用 curl,對 /v1/models 測試同一組設定:若傳回 JSON,問題就在供應商表單中;若回傳 401,則是金鑰問題;若回傳 404,則是 URL 問題。您也可以改用「+ New」手動新增模型,此時 Model ID 必須與型錄中的 ID 完全一致。
使用 ChatWise 需要訂閱或授權嗎,才能使用自己的 API 金鑰?
這是兩種彼此獨立的付費關係。ChatWise 是一次購買的用戶端,而模型使用費則由持有您金鑰的服務方收取——若使用 Kunavo 金鑰,費用會從預付餘額中依 token 用量扣除,沒有額外月費。付費方案解鎖項目中沒有列出供應商設定功能,但 ChatWise 的頁面也沒有明確說明免費方案能否新增自訂供應商,因此在依賴此功能前,請先於試用期間確認。
ChatWise 可以不使用 Anthropic 帳戶就使用 Claude 模型嗎?
可以,透過 OpenAI 相容的供應商項目即可。模型 ID 由您設定的端點解析,而非由 ChatWise 解析,因此您持有的憑證就是該端點的憑證。這與在應用程式內登入現有訂閱帳戶是不同的方式;ChatWise 也有宣傳後者,但該方式取決於其他廠商的條款,而使用向您收費的金鑰則不受其影響。Kunavo 尚未使用其端點執行過 ChatWise,因此請將本頁視為設定說明,而非實測結果。