跳至主要内容

Cherry Studio

Cherry Studio 可透過 OpenAI compatible Provider 使用 /v1 Base URL。

設定前先確認​

  • 本頁只寫預留值；實際 Key 從 PopGo API 金鑰頁複製，模型從模型與價格頁複製。
  • 一鍵設定適合已安裝並註冊協定的軟體；瀏覽器提示開啟外部應用程式時，需要允許一次。
  • 手動設定時先保存最小 Provider，第一個請求成功後再啟用串流、工具呼叫或多模型路由。

官方來源與核驗​

本頁於 2026-07-13 依官方來源核驗 Cherry Studio 1.9.12。 官方來源. 核驗範圍為 Cherry Studio 的自訂 Provider 設定。

一鍵設定​

登入 PopGo API 金鑰頁，在目標 Key 所在列開啟操作選單。公開文件不會產生或顯示任何包含 Key 的跳轉連結。 開啟 Chat 子選單，再選擇 Cherry Studio。 匯入後確認 Provider 為 OpenAI compatible，並選擇目前可用模型。

手動設定​

在 Provider 設定中選擇 OpenAI compatible，再填寫下表。

欄位值
Provider 類型OpenAI compatible
Base URLhttps://api.popgo.site/v1
API KeyYOUR_API_KEY
ModelYOUR_MODEL

文字版設定流程​

  1. 安裝或更新 Cherry Studio 到目前版本，開啟後進入「設定 → 模型服務」。
  2. 新增「自訂服務商」，協定選擇 OpenAI compatible。不要直接修改軟體內建的官方服務商。
  3. Base URL 填 https://api.popgo.site/v1，API Key 填 YOUR_API_KEY，Model 填模型與價格頁中的 YOUR_MODEL。
  4. 儲存後建立新會話，先傳送一則短訊息；成功後再啟用圖片、影片、工具呼叫或較長上下文。
  5. 不同協定或模型族建議分別建立服務商，避免混用 Claude、Gemini 和 OpenAI compatible 的位址。

常見設定現象​

  • 模型清單為空不一定表示連線失敗，許多用戶端不會自動取得第三方模型；直接手動填寫 YOUR_MODEL。
  • 儲存設定後仍請求預設服務時，切換到新 Provider，關閉舊會話並重啟用戶端。
  • 舊版用戶端看不到新能力時，先更新用戶端，再以目前介面顯示的欄位為準。

成功判斷​

在模型測試或新會話傳送短訊息；正常回傳內容即成功。

常見錯誤與恢復​

  • 連線測試失敗時，檢查 Base URL 尾端沒有重複的 /v1。
  • 出現 401 時，重新貼上 YOUR_API_KEY 並檢查前後空白。
  • 出現 404 時，核對 Base URL 層級，避免用戶端重複附加 /v1。