Skip to Content
在工具裡使用Cherry Studio

Cherry Studio 設定

Cherry Studio  是一款跨平台的 AI 桌面用戶端（支援 Windows、macOS、Linux），支援多模型對話、知識庫和工作流，是目前功能最豐富的開源 AI 用戶端之一。

透過設定 OfoxAI 作為服務商，你可以在 Cherry Studio 中使用 GPT、Claude、Gemini、DeepSeek 等 100+ 大模型，只需一個 API Key。

四種協議說明

Cherry Studio 支援透過以下四種協議接入 OfoxAI：

OpenAI Chat — 基於 /v1/chat/completions，適用於 GPT 系列模型，如 openai/gpt-6.1-sol、openai/gpt-6-luna。

OpenAI Response — 基於 /v1/responses，適用於 GPT 系列模型，如 openai/gpt-6.1-sol、openai/gpt-6-luna。

Claude — 基於 /anthropic/v1/messages，適用於 Claude 系列模型，如 anthropic/claude-sonnet-5.5、anthropic/claude-opus-5.5。

Gemini — 基於 /gemini/v1beta/models，適用於 Gemini 系列模型，如 google/gemini-3.8-flash、google/gemini-3.5-flash-lite。

前提條件

設定步驟

第 1 步：開啟設定

啟動 Cherry Studio，點擊右上角的 設定 圖示。

開啟 Cherry Studio 設定

第 2 步：新增模型提供商

進入左側 模型服務，捲動到底部，點擊 + 新增。在彈出的對話框中填寫提供商名稱，並選擇對應的提供商類型。

OpenAI Chat

提供商類型選擇 OpenAI，點擊確定。

新增 OpenAI Chat 提供商

OpenAI Response

提供商類型選擇 OpenAI（後續在設定頁開啟 Response 模式），點擊確定。

新增 OpenAI Response 提供商

Claude

提供商類型選擇 Anthropic，點擊確定。

新增 Claude 提供商

Gemini

提供商類型選擇 Gemini，點擊確定。

新增 Gemini 提供商

第 3 步：填寫 API 設定

在對應提供商的設定頁中填寫 API 密鑰和 API 地址。

OpenAI Chat

設定項值
API 密鑰你的 OfoxAI API Key
API 地址https://api.ofox.io/v1

OpenAI Chat 設定

OpenAI Response

設定項值
API 密鑰你的 OfoxAI API Key
API 地址https://api.ofox.io/v1

OpenAI Response 設定

Claude

設定項值
API 密鑰你的 OfoxAI API Key
API 地址https://api.ofox.io/anthropic

Claude 設定

Gemini

設定項值
API 密鑰你的 OfoxAI API Key
API 地址https://api.ofox.io/gemini

Gemini 設定

確認頁面右上角的開關處於 開啟（ON） 狀態，否則該提供商不會出現在模型選擇器中。

第 4 步：新增模型

點擊模型區域的 管理 按鈕自動拉取模型列表，點擊模型右側的 + 新增到啟用列表。

OpenAI Chat

OpenAI Chat 模型列表

OpenAI Response

OpenAI Response 模型列表

Claude

Claude 模型列表

Gemini

Gemini 模型列表

第 5 步：驗證設定

點擊 檢測 按鈕，選擇任意模型進行測試，顯示檢測通過即設定成功。

OpenAI Chat

OpenAI Chat 驗證

OpenAI Response

OpenAI Response 驗證

Claude

Claude 驗證

Gemini

Gemini 驗證

開始使用

回到主介面，點擊對話頂部的模型選擇器，在對應提供商分組下選擇模型，即可開始對話。

選擇模型開始對話

圖片生成

Cherry Studio 支援透過 Gemini 協議呼叫 OfoxAI 的圖片生成模型，在對話中直接生成圖片。

第 1 步：新增 Gemini 提供商

進入 模型服務，點擊底部 + 新增。

新增提供商

在彈出的對話框中，提供商類型選擇 Gemini，點擊確定。

選擇 Gemini 類型

第 2 步：設定並取得生圖模型

API 地址填寫 https://api.ofox.io/gemini，點擊 取得模型列表，新增以下生圖模型：

  • Google: Nano Banana Pro (Gemini 3 Pro Image Preview)
  • Google: Nano Banana (Gemini 2.5 Flash Image)
  • Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)

取得生圖模型

第 3 步：編輯助手，設定生圖參數

在主介面右鍵點擊助手，選擇 編輯助手。

編輯助手

在編輯頁面中：

  1. 預設模型 選擇剛新增的生圖模型
  2. 點擊 + 新增參數，新增以下兩個自訂參數：
參數名類型值
responseModalitiesJSON["IMAGE"]
imageConfigJSON{"aspectRatio": "1:1", "imageSize": "1K"}

imageConfig 中可以調整圖片的寬高比和解析度，如需 2K 圖片，將 imageSize 改為 "2K"。

設定生圖參數

第 4 步：開始生圖

儲存設定後，在對話框中輸入圖片描述，即可生成圖片。

生圖效果

新版 Cherry Studio：一個服務商，多種協議

新版 Cherry Studio 支援在同一個服務商裡為每種協議分別設定請求位址。只需新增一個 OfoxAI 服務商，就能同時使用 GPT、Claude、Gemini 模型，並支援影像產生與圖片編輯。

第 1 步：填寫請求設定

在服務商設定頁填好 API 密鑰後，開啟 請求設定，按下表填寫各協議的位址，點擊 儲存：

協議 / 欄位位址
OpenAI（預設）https://api.ofox.io/v1
Anthropichttps://api.ofox.io/anthropic
Geminihttps://api.ofox.io/gemini
OpenAI Responseshttps://api.ofox.io/v1
影像產生基礎 URLhttps://api.ofox.io/v1
圖片編輯基礎網址https://api.ofox.io/v1
請求設定：OpenAI、Anthropic、Gemini、OpenAI Responses 位址 請求設定：影像產生與圖片編輯基礎網址

設為預設值 決定一般對話預設使用哪種協議。影像產生基礎 URL 對應 /images/generations，圖片編輯基礎網址 對應 /images/edits，留空時使用預設對話端點的 Base URL。截圖中使用的是鏡像位址 api.ofox.io，中國大陸網路可直接照填；其他網路使用 api.ofox.io。

第 2 步：多模型對話

新增模型後，在同一個服務商下即可切換 Gemini、GPT、Claude 等不同廠商的模型對話，下圖依序為 Gemini 3.8 Flash、GPT-6 Luna、Claude Sonnet 5.5：

同一服務商下使用 Gemini、GPT、Claude 模型對話

第 3 步：影像產生與編輯

新增影像模型（如 openai/gpt-image-2）後，在繪圖頁選擇該模型，輸入描述即可產生圖片：

使用 GPT-Image-2 產生圖片

上傳一張參考圖並輸入修改指令（如「變成一隻狗」），即可基於原圖編輯：

使用 GPT-Image-2 編輯圖片

常見問題

Q: 點擊「管理」後模型列表為空

檢查 API 地址是否填寫正確（末尾不加斜線），以及 API 密鑰是否完整複製，無多餘空格。

Q: 檢測時提示連線失敗

  1. 確認 API Key 從 OfoxAI 控制台  完整複製，無多餘空格
  2. 確認 API 地址填寫正確
  3. 確認網路連線正常

Q: 提供商不出現在模型選擇器中

檢查設定頁右上角的開關是否已開啟。

最後更新於
WorkBuddyLobeHub