Cherry Studio

Settings → Model Services → 自訂供應商：貼上金鑰與 API 位址，按下 Get Model List，整個目錄就會填入選擇器。

设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)

  提供商名称 / Provider name    Kunavo
  API 密钥 / API Key            sk-kn-...
  端点设置 / Endpoint settings
    OpenAI                     https://api.kunavo.com/v1
    Anthropic                  https://api.kunavo.com
  → 同步模型 (Sync Models), then add the models you want
  → 检测 (Test) to confirm

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 開啟设置 → 模型服务 (Settings → Model Services)，然後點選添加自定义提供商 (Add Custom Provider)。
3. 填入 API 密钥 (API Key)，並在 OpenAI 端點欄位中輸入 https://api.kunavo.com/v1。
4. 也請填入 Anthropic 欄位 (https://api.kunavo.com)——它位於 OpenAI 下方的 端点设置 (Endpoint settings) 中。Cherry Agent 和任何透過 Anthropic Messages 協定路由的模型，都會特別讀取此欄位，而非 OpenAI 欄位。其他端點類型則位於 更多设置 (More options) 中。
5. 儲存後，按下供應商模型清單中的 同步模型，新增您要使用的聊天模型；然後按下 检测，端對端驗證其中一個模型。
6. 為每個助理個別指定模型，而非全域設定——Cherry Studio 會為每個助理保留各自的模型，因此便能同時使用便宜的預設模型和昂貴的專用模型。

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

除錯用戶端前先驗證

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

# 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 權杖的美元價格，輸入／輸出。