在 Cherry Studio 設定自己的 API，路徑是 設定 → 模型供應商 → 新增供應商：填入 API 金鑰，在「端點設定」的 OpenAI 和 Anthropic 欄位各填一個根位址，儲存後按「同步模型」把模型抓進來，再用「檢查」確認。這篇以 2026 年 9 月 30 日發佈的 v2.1.4 為準，選單名稱全部照 Cherry Studio 繁體中文介面的原文寫。v2 大改了新增供應商的畫面，v1 時代「類型選 OpenAI」的教學已經對不上了。
本頁指的是 CherryHQ/cherry-studio 的桌面版（AGPL-3.0，支援 Windows、macOS、Linux）。2026 年 10 月 1 日查證時程式庫沒有封存，最新版是 v2.1.4。App Store 上同名的 App 是另一個開發者的無關產品。另外，Cherry Studio 的官方文件是簡體中文，介面切成繁體後，「提供商／服務商」會顯示為「供應商」，對照文件時別被名稱混淆。
一步一步設定
設定 → 模型供應商 → 新增供應商
（對話框標題：新增自訂供應商）
供應商名稱 Kunavo
API 金鑰 sk-kn-...
端點設定
OpenAI Chat Completions https://api.kunavo.com/v1
Anthropic Messages https://api.kunavo.com
更多選項
OpenAI Responses https://api.kunavo.com/v1 （選填）
影像產生基礎 URL https://api.kunavo.com/v1 （選填）
Google Gemini 留空
→ 儲存 → 在模型清單按「同步模型」→ 加入要用的模型 → 「檢查」- 打開設定 → 模型供應商，按新增供應商。跳出的對話框標題是「新增自訂供應商」。如果是 Coding Plan 類服務、多帳號或要分專案，可以用上方的「從預設開始（選填）」從既有的預設建立。
- 填供應商名稱和 API 金鑰。
- 端點設定預設就有 OpenAI Chat Completions 和 Anthropic Messages 兩個欄位，至少要設定一個文字端點。兩個都填，聊天以外的 Agent 和走 Anthropic 格式的功能也選得到模型。
- 展開更多選項，還有 OpenAI Responses、Google Gemini、影像產生基礎 URL、圖片編輯基礎網址。用不到的留空即可。
- 儲存後，確認這個供應商是啟用狀態。官方文件說，設定好但沒啟用的供應商，模型不會出現在選單裡 —— 這是「金鑰沒反應」最常見的原因。
- 在模型清單按同步模型，加入要用的模型，再按檢查測一個。
位址怎麼填：只填根位址
依 v2.1.4 原始碼，每個欄位填的是根位址：沒有版本段時會自動補 /v1（已經有就不補），再接上該欄位的固定路徑。每個欄位下方都會顯示「請求路徑」，那就是最終送出的網址。
| 欄位 | Cherry Studio 接上的路徑 | Kunavo |
|---|---|---|
| OpenAI Chat Completions | /chat/completions | 支援 |
| Anthropic Messages | /messages | 支援 |
| OpenAI Responses（更多選項） | /responses | 支援 |
| 影像產生基礎 URL（更多選項） | /images/generations | 支援 |
| 圖片編輯基礎網址（更多選項） | /images/edits | 支援 |
| Google Gemini（更多選項） | /models/{model}:generateContent | 不支援，留空 |
兩個常見錯誤：一是貼上含 /chat/completions 或 /messages 的完整網址，路徑重複而回 404；二是在結尾加 #。介面提示寫得很清楚：「在結尾新增 # 以停用自動附加的 API 版本。」標準端點加了它，/v1 就不見了。
順手設好，帳單少一截
Cherry Studio 除了聊天，還會在背後呼叫模型。快速模型依介面說明是「用於對話命名、搜尋關鍵字提煉等簡單任務的模型」，提示也寫著「請選擇輕量模型，並避免使用推理模型」，這裡放一個便宜的模型，就不會每次對話都讓貴的模型跑一輪。翻譯模型也是分開設定的。一次選多個模型同時提問，則是每個模型各送一次請求、各算一次錢。App 裡用量統計顯示的金額是依公開價格換算的估計值，走有折扣的路線時會偏高；在模型設定裡把單價改成你實際的價格就會準。更多細節見英文的 Cherry Studio API cost。
用 Kunavo 的注意事項與台灣付款
- 驗證範圍：以上設定是讀 Cherry Studio 的原始碼與官方文件整理的，Kunavo 沒有實際把 Cherry Studio 接上自家端點跑過。請保留你現在能用的路線，再試這一條。
- 只有聊天與圖片：Kunavo 沒有嵌入（embedding）模型，知識庫的向量檢索要用別的供應商或本機嵌入模型；官方文件說沒有嵌入模型時，知識庫仍會以 BM25 關鍵字檢索運作。
- MCP 工具：在 設定 → MCP 伺服器 新增的工具，要用支援工具呼叫的模型才叫得動；上面加入的 Claude、GPT 模型都支援。
- 付款：預付儲值、按 token 扣款，沒有月費。最低儲值 $10，結帳走 Stripe，台灣可用信用卡（Visa、Mastercard、American Express、JCB、銀聯）、Apple Pay 和 Link；街口、LINE Pay 不在可用清單上。見計費說明，準備好之後可以建立帳號並產生金鑰。英文設定頁是 Cherry Studio integration guide。
FAQ
Cherry Studio 要怎麼設定自己的 API？
到 設定 → 模型供應商 → 新增供應商，開啟「新增自訂供應商」對話框，填入供應商名稱、API 金鑰，並在端點設定的 OpenAI Chat Completions 和 Anthropic Messages 欄位填入根位址後儲存。接著在模型清單按「同步模型」把模型抓進來、加入要用的模型，再用「檢查」確認其中一個能用。供應商必須是啟用狀態，否則模型不會出現在選單裡。
Cherry Studio 的 API 位址要不要加 /v1？
加不加都可以。v2.1.4 的原始碼會在你填的根位址後面自動補上版本（/v1），如果已經有就不重複；之後再加上該欄位自己的路徑（OpenAI 是 /chat/completions，Anthropic 是 /messages）。真正要避免的是貼上含 /chat/completions 的完整網址，路徑會重複而回 404。結尾的 # 是「停用自動附加的 API 版本」用的，標準端點不要加。每個欄位下方會顯示「請求路徑」，儲存前看一眼就知道最後的網址。
「同步模型」沒有抓到任何模型怎麼辦？
這個按鈕會用你填的位址和金鑰去要供應商的模型清單（/v1/models），清單是空的，多半是位址或金鑰的問題，而不是 Cherry Studio。先確認沒有貼成完整網址、結尾沒有 #，再用 curl 測同一組位址與金鑰：回 JSON 代表問題在 App 裡，回 401 代表金鑰不對。
Cherry Studio 可以切成繁體中文嗎？
可以。Cherry Studio 的介面內建 13 種語言，包含繁體中文（zh-TW），在設定的語言選項切換即可。要注意繁體介面把服務商稱為「供應商」，而官方文件和簡體介面寫的是「提供商」「服務商」，對照教學時名稱會不一樣，但指的是同一個東西。
Cherry Studio 要錢嗎？
桌面版（社群版）是 AGPL-3.0 開源軟體，免費。要付錢的是你設定的供應商的模型使用費。Cherry Studio Enterprise 是另外報價的商業產品；內建的 CherryAI 免費，但模型陣容和額度沒有公開。
2026 年 10 月 1 日查證：GitHub API（CherryHQ/cherry-studio，v2.1.4）、v2.1.4 的繁體中文介面字串（zh-tw.json）與新增供應商畫面的原始碼、Cherry Studio 官方文件。Kunavo 沒有實際用 Cherry Studio 跑過自家端點。