Cherry Studio API 設定——新增供應商與位址

在 Cherry Studio 中設定 API 的路徑是 Settings → Model Provider → Add Provider。輸入 API Key，分別在 Endpoint settings 的 OpenAI 與 Anthropic 欄位填入根位址，接著儲存並使用「Sync models」匯入模型，再用「Check」確認即可。首先要知道的是：Cherry Studio 沒有韓文 UI，因此選單保留英文原文。本頁以 2026 年 9 月 30 日發布的 v2.1.4 為準；由於 v2 的供應商新增畫面已有重大變更，v1 時代「Type: OpenAI」的說明已不再符合目前畫面。

本文適用於 CherryHQ/cherry-studio 的桌面版本（AGPL-3.0、Windows·macOS·Linux）。截至 2026 年 10 月 1 日，儲存庫尚未封存，最新版本為 v2.1.4。App Store 中同名的應用程式是其他開發者製作、與此無關的應用程式。內建 UI 語言共有 13 種，沒有韓文（依據 v2.1.4 的 UI 翻譯檔），因此本文以使用英文 UI 操作為前提。

逐步設定

Cherry Studio v2.1.4（英文 UI）

Settings → Model Provider → Add Provider
  (대화상자 제목: Add Custom Provider)

  Provider Name       Kunavo
  API Key             sk-kn-...
  Endpoint settings
    OpenAI            https://api.kunavo.com/v1
    Anthropic         https://api.kunavo.com
  More options
    OpenAI Responses            https://api.kunavo.com/v1   (선택)
    Image Generation Base URL   https://api.kunavo.com/v1   (선택)
    Gemini                      비워 둠

→ Save → 모델 목록에서 "Sync models" → 쓸 모델 추가 → "Check"

在 Settings → Model Provider 中按下 Add Provider。開啟的對話方塊標題是「Add Custom Provider」。如果需要 Coding Plan 類型的服務、帳戶或專案分離，也可以透過上方的「Start from a preset (optional)」從現有預設開始。
輸入 Provider Name 與 API Key。
Endpoint settings 預設包含 OpenAI 與 Anthropic 兩個欄位。至少需要一個文字端點（留空會出現「Configure at least one text endpoint」錯誤）。填妥兩個欄位後，不僅能在聊天中選擇模型，也能在 Agent 或使用 Anthropic 格式的功能中選擇模型。
展開 More options 後，會看到 OpenAI Responses、Gemini、Image Generation Base URL 與 Image Edit Base URL 欄位。不使用的欄位請留空。
儲存後確認該供應商已啟用（Enable）。官方文件指出，只完成設定但未啟用的供應商，不會出現在模型選擇清單中。這是「金鑰無法使用」最常見的原因。
在模型清單中使用 Sync models 匯入模型，新增要使用的模型後，再用 Check 確認其中一個。

位址寫法：只填根位址

根據 v2.1.4 原始碼，各欄位應填入根位址。若沒有版本部分，系統會自動附加 /v1（已有時則不會附加），之後再附加各欄位的固定路徑。每個欄位下方都會以「Request path」顯示最終 URL，請在儲存前確認。

欄位	Cherry Studio 附加的路徑	Kunavo
OpenAI	`/chat/completions`	支援
Anthropic	`/messages`	支援
OpenAI Responses（More options）	`/responses`	支援
Image Generation Base URL（More options）	`/images/generations`	支援
Image Edit Base URL（More options）	`/images/edits`	支援
Gemini（More options）	`/models/{model}:generateContent`	不支援，留空

常見錯誤有兩種。若貼上包含 /chat/completions 或 /messages 的完整 URL，路徑會重複附加並導致 404。此外，結尾的 # 依畫面說明「Add # at the end to disable the automatically appended API version」，也就是停用自動新增 API 版本的符號；若加在標準端點上，就會缺少 /v1。若要確認位址與金鑰本身，以下命令最快。

Sync models 為空時，請確認金鑰與地址

curl https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer $KUNAVO_API_KEY"

節省費用的基本模型設定

Cherry Studio 不只會用於聊天，也會在背景呼叫模型。Quick Model 依畫面說明用於「命名對話與擷取搜尋關鍵字等簡單工作」，提示文字也建議「選擇輕量模型，避免使用推理模型」。在此設定便宜模型，就不會每次對話都執行昂貴模型。也請另行設定 Translate Model。一次選擇多個模型提問時，會按照模型數量分別發出請求並分別計費。應用程式的使用量統計金額是依公開價格換算的估算值，在折扣路徑下會高於實際金額。將模型設定中的單價改為實際費率後即可校正。詳細內容請參閱英文頁面 Cherry Studio API cost。

使用 Kunavo 時的注意事項與付款

驗證範圍：本設定是根據 Cherry Studio 原始碼與官方文件撰寫，並非 Kunavo 實際將 Cherry Studio 連接至自家端點後進行的驗證。請維持目前使用的路徑進行測試。
僅限聊天與圖片：Kunavo 沒有嵌入模型，因此知識庫的向量搜尋需要其他供應商或本機嵌入模型。官方文件說明，即使沒有嵌入模型，知識庫仍會透過 BM25 關鍵字搜尋運作。
MCP 工具：在 Settings → MCP Servers 中新增的工具，必須搭配支援工具呼叫的模型使用。上方新增的 Claude 與 GPT 模型支援此功能。
付款：採無月費的預付儲值模式，依 token 從餘額中扣款。最低儲值金額為 $10；Stripe 結帳頁支援信用卡（Visa、Mastercard、American Express、JCB、UnionPay）、Apple Pay、Google Pay 與 Link。若結帳頁以韓元顯示，也會提供 KakaoPay、Naver Pay、PAYCO、Samsung Pay，以及禁止海外交易的韓國國內信用卡作為付款選項（新增於 2026 年 10 月 3 日，目前尚無透過這些方式完成的付款）。金額以美元定價，Stripe 會換算並以韓元顯示，匯率包含由付款人負擔的 2–4% 換匯手續費。沒有 Toss Pay。請查看付款說明並建立帳戶以取得金鑰。英文設定頁面為 Cherry Studio integration guide。

常見問題

如何在 Cherry Studio 中設定 API？

按一下 Settings → Model Provider → Add Provider，會開啟「Add Custom Provider」對話方塊。輸入 Provider Name 與 API Key，在 Endpoint settings 的 OpenAI 和 Anthropic 欄位中輸入根 URL，然後儲存。接著在模型清單中使用「Sync models」匯入模型，加入要使用的模型，再使用「Check」確認其中一個。供應商必須已啟用（Enable），模型才會出現在選擇清單中。

可以用韓文使用 Cherry Studio 嗎？

UI 不支援韓文。v2.1.4 包含的 UI 語言共有 13 種：英文、簡體中文、繁體中文、日文、德文、法文、西班牙文、葡萄牙文、俄文、希臘文、羅馬尼亞文、土耳其文與越南文。由於選單通常以英文顯示，本頁保留英文選單名稱。與模型的對話本身可以使用韓文。

API 位址必須加上 /v1 嗎？

可以加，也可以不加。根據 v2.1.4 原始碼，如果輸入的根位址沒有版本（/v1），系統會自動加上；如果已有，則維持原樣，接著附加各欄位的路徑（OpenAI 為 /chat/completions，Anthropic 為 /messages）。應避免貼上已包含 /chat/completions 的完整 URL，否則路徑會重複附加並導致 404。結尾的 # 是停用自動新增版本的符號，請勿用於標準端點。最終 URL 可在欄位下方的「Request path」查看。

按下 Sync models 後仍沒有模型，該怎麼辦？

此按鈕會使用輸入的位址與金鑰請求供應商的模型清單（/v1/models），因此若清單為空，通常是位址或金鑰問題。確認沒有貼上完整 URL，且結尾沒有 #，再使用相同的位址與金鑰執行 curl。若收到 JSON，表示是應用程式端問題；若為 401，表示是金鑰問題。

Cherry Studio 免費嗎？

桌面社群版本採 AGPL-3.0 開放原始碼授權，因此免費。需要付費的是所設定供應商的模型使用費。Cherry Studio Enterprise 是需另行報價的產品；內建的 CherryAI 免費，但模型配置與額度尚未公開。

2026 年 10 月 1 日確認：GitHub API（CherryHQ/cherry-studio、v2.1.4）、v2.1.4 的 UI 翻譯檔清單與英文 UI 字串（en-us.json）、新增供應商畫面的原始碼，以及 Cherry Studio 官方文件。Kunavo 尚未實際執行 Cherry Studio 連接至自家端點。