文件

文件

ChatWise

ChatWise 的所有供應商都使用相同的三個欄位。為自訂供應商命名,填入 API Base URL 和金鑰,按下「Fetch」,模型選擇器就會載入 Claude 和 GPT 的 ID,並共用同一筆餘額。

Settings → Providers → "+" 透過三個欄位建立自訂供應商 — Provider name、設為 https://api.kunavo.com/v1 的 API Base URL,以及 API Key — 然後 Fetch 從端點讀取模型清單。

設定 → Providers → 「+」 → custom configuration
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
API Base URL 須保留 /v1。 ChatWise 直接在欄位下方說明規則 —「請勿在 URL 中包含 /chat/completions」— 因此此欄位應填入路由所依附的根 URL,而非路由本身。文件中唯一展示已填入該欄位的託管閘道,採用的也是相同格式:https://aihubmix.com/v1。若基礎 URL 已包含路由,請求會回傳 404,而非驗證錯誤。
本設定內容是根據本文下方日期當時 ChatWise 自身的文件整理而成。Kunavo 尚未使用其端點執行過 ChatWise——無論是建立工作階段、串流回合,還是工具往返呼叫;此系列中的其他用戶端也一樣。公開的設定頁面不等於相容性測試。請保留任何目前可正常運作的路由,以便在嘗試此設定時使用。
Kunavo 不提供嵌入、文字轉語音或語音轉文字模型,因此此路由只處理聊天和圖像生成,不提供其他功能。ChatWise 的音訊輸入功能則不同,不受影響:它會將音訊檔案附加至訊息,供能處理音訊的模型使用,而非呼叫轉錄服務。
填入此欄位會停用 ChatWise 的一項擴充功能。其可觀測性頁面警告:「請確認各供應商的 API Base URL 為空,否則將無法啟用可觀測性。」Cloudflare AI Gateway 儀表板和重新指定的基礎 URL 無法同時用於同一供應商 — 因此建議將 Kunavo 新增為獨立的供應商項目,而非修改內建項目。
有數個毫無關聯的產品都使用 ChatWise 這個名稱。本頁介紹的是位於 chatwise.app 的桌面用戶端,支援 macOS、Windows 和 Linux;其文件位於 docs.chatwise.app。其公開 GitHub 發佈動態遠早於目前出貨版本便已停止更新,因此如果此處的畫面截圖與您看到的不同,請以應用程式本身的下載版本為準,而非該動態。
還沒有金鑰?建立 Kunavo 帳戶,建立金鑰(以 sk-kn- 開頭),並從 $10 起新增額度——呼叫會從該餘額扣款,失敗的呼叫不會計費。之後儀表板會開啟 ChatWise 設定。

逐步操作

  1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
  2. 在 ChatWise 中,開啟設定 → 供應商,然後點選 "+" 新增供應商。文件提供兩種方式:選擇其中一個內建預設項目,或是建立自訂設定——Kunavo 不是預設項目,因此請選擇第二種方式。
  3. 如上所述,填入 Provider name、API Base URL 和 API Key。表單中沒有選擇廠商的欄位:模型 ID 由端點解析,因此在 OpenAI 相容供應商後方使用 Claude ID,正是預期的組合,並非設定不相符。
  4. 在模型那一列按下 Fetch。ChatWise 文件指出,如果 API 支援 /models 端點,就能自動新增可用模型;Kunavo 會回應 GET /v1/models,因此清單會自動載入。若您想自行輸入 ID,也可以按下 + New。
  5. 如果您手動新增模型,文件列出的欄位如下:Model ID 是 API 識別碼,Display Name 只是標籤,因此 ID 必須與型錄完全一致。勾選 Capabilities 並將 Context length 設為與模型相符——這些設定會告訴用戶端要提供哪些功能,不會改變端點的行為。
  6. 在模型選擇器中選擇該供應商,並傳送訊息。對於圖像模型,ChatWise 的圖像生成頁面還要求多做一步:必須先將模型類型設為 Image,它才會出現在圖像選擇器中。

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

這是簡短版本。完整指南——模型選擇、實際工作階段費用,以及失敗情況——請參閱 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 權杖的美元價格,輸入/輸出。

模型 IDKunavo 輸入/輸出它在 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使用同一個金鑰,透過另一個模型系列尋求第二意見
計費方式是從預付餘額按權杖計費,沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取 對帳單的影響比模型選擇更大。

常見問題

如何在 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,因此請將本頁視為設定說明,而非實測結果。