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,也不要填入內容站位址。

設定步驟

  1. 建立並複製 API Key

    開啟 穷哥么 權杖控制台,建立權杖並複製 Key。接著將 Key 貼到 Cherry Studio 的 API Key 欄位,不要把密鑰寫進名稱或 API 位址。

  2. 依官方路徑新增服務商

    在 Cherry Studio 中依序進入 設定 → 模型服務 → 新增服務商,依官方線上文件將服務商類型選為 OpenAI。若新版介面提供 New API 專用項目,也可以選擇該項目;後續都要填寫名稱、API Key 與 API 位址。

  3. 填寫名稱、API Key 與 API 位址

    • 名稱穷哥么
    • API Key:貼上剛才建立的 Key
    • API 位址https://qionggeme.com

    此處必須填寫根位址。不要改成 https://qionggeme.com/v1,更不要加上 /docs

  4. 理解 API 位址與實際端點

    Cherry Studio 的「API 位址」欄位固定填寫根位址 https://qionggeme.com,用戶端會將 OpenAI 相容請求傳送到 https://qionggeme.com/v1。若另外建立 Anthropic 原生服務商,其 Base URL 使用 https://qionggeme.com。這不是要你在兩個位址間反覆嘗試,而是不同協定各自有明確的 Base URL。

  5. 啟用服務商並驗證請求

    儲存後開啟該服務商的 啟用(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

準備好開始了嗎?

註冊 穷哥么 取得 API Key,立即使用全部在售模型

立即註冊

常見問題

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。若分別建立服務商,請依各自協定填寫。

要從哪裡確認模型名稱?

請查看本站模型價格頁中的目前可用模型。若某模型未出現在目前資料來源中,請勿繼續使用舊名稱。