Cherry Studio 設定 New API 教學
依照 Cherry Studio 官方 New API 整合文件新增 穷哥么 服務商,使用 OpenAI 相容類型與主網域根位址完成設定。
快速設定
- 整合入口
設定 → 模型服務 → 新增服務商- 服務商類型
OpenAI- 官方線上文件的主要流程;若新版介面提供 New API 專用項目,也可以選擇該項目。
- 名稱
穷哥么- API Key
在穷哥么權杖控制台建立的 Key- API 位址
https://qionggeme.com- OpenAI 相容請求實際使用 https://qionggeme.com/v1;若另外建立 Anthropic 原生服務商,其 Base URL 為 https://qionggeme.com。
本教學以 Cherry Studio 官方線上文件的主要流程為準:新增服務商時選擇 OpenAI 類型。若你的新版介面另外提供 New API 專用項目,也可以選擇它;兩者都使用下方相同的 API Key 與位址規則。請先在 穷哥么 權杖控制台 建立 API Key。
最容易填錯的是「API 位址」:Cherry Studio 的 New API 欄位應填寫根位址 https://qionggeme.com,不要加上 /v1,也不要填入內容站位址。
設定步驟
建立並複製 API Key
開啟 穷哥么 權杖控制台,建立權杖並複製 Key。接著將 Key 貼到 Cherry Studio 的 API Key 欄位,不要把密鑰寫進名稱或 API 位址。
依官方路徑新增服務商
在 Cherry Studio 中依序進入 設定 → 模型服務 → 新增服務商,依官方線上文件將服務商類型選為 OpenAI。若新版介面提供 New API 專用項目,也可以選擇該項目;後續都要填寫名稱、API Key 與 API 位址。
填寫名稱、API Key 與 API 位址
- 名稱:
穷哥么 - API Key:貼上剛才建立的 Key
- API 位址:
https://qionggeme.com
此處必須填寫根位址。不要改成
https://qionggeme.com/v1,更不要加上/docs。- 名稱:
理解 API 位址與實際端點
Cherry Studio 的「API 位址」欄位固定填寫根位址
https://qionggeme.com,用戶端會將 OpenAI 相容請求傳送到https://qionggeme.com/v1。若另外建立 Anthropic 原生服務商,其 Base URL 使用https://qionggeme.com。這不是要你在兩個位址間反覆嘗試,而是不同協定各自有明確的 Base URL。啟用服務商並驗證請求
儲存後開啟該服務商的 啟用(Enable) 開關,再選擇目前可用的正確模型送出測試請求。模型可能隨上架情況調整,請到 模型價格頁 或控制台模型清單核對;收到正常回覆即表示設定成功。
設定範例
# Cherry Studio → New API 名稱: 穷哥么 API Key: 你的穷哥么 API Key API 位址: https://qionggeme.com # 協定對應的實際 Base URL OpenAI 相容: https://qionggeme.com/v1 Anthropic 原生(單獨設定時): https://qionggeme.com
疑難排解
請求回傳 401 或提示 API Key 無效
重新從 權杖控制台 複製 Key,檢查前後是否有空白,並確認權杖狀態、餘額與模型權限正常。
請求回傳 404 或無法辨識位址
確認依官方流程使用 OpenAI 類型;若你的版本提供 New API 專用項目,也可以使用該項目。「API 位址」都必須嚴格填寫 https://qionggeme.com,不要加上 /v1 或 /docs。
提示模型不存在或無法使用
到 模型價格頁 核對目前可用的模型 ID,並確保名稱完整一致;不要繼續使用已下架或拼寫不同的名稱。
OpenAI 與 Anthropic 位址看起來不一致
這是預期行為:本頁的 OpenAI 相容服務商在「API 位址」中填寫 https://qionggeme.com,實際 OpenAI Base URL 為 https://qionggeme.com/v1;若另外建立 Anthropic 原生服務商,則使用 https://qionggeme.com。
常見問題
Cherry Studio 接入 New API 時,「API 位址」到底要不要帶 /v1?
不要。依官方整合文件,該欄位填寫 https://qionggeme.com;Cherry Studio 會將 OpenAI 相容請求傳送到 https://qionggeme.com/v1。
可以把內容站位址填進 API 位址嗎?
不可以。API 位址必須是 https://qionggeme.com,不能使用帶有 /docs 的內容站位址。
名稱欄位必須填什麼?
建議填寫「穷哥么」以便辨識;真正決定驗證與請求目標的是 API Key 和 API 位址。
為什麼 OpenAI 與 Anthropic 的實際 Base URL 不同?
兩類 API 的路徑慣例不同:OpenAI 相容請求使用 https://qionggeme.com/v1,Anthropic 原生請求使用 https://qionggeme.com。若分別建立服務商,請依各自協定填寫。
要從哪裡確認模型名稱?
請查看本站模型價格頁中的目前可用模型。若某模型未出現在目前資料來源中,請勿繼續使用舊名稱。