> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio 自訂模型設定指南

> Platform 整合指南 - Ace Data Cloud

## 1. 取得 API Key

開啟 [Ace Data Cloud 應用程式列表](https://platform.acedata.cloud/console/applications)，進入可用的應用程式並複製 API Key。

![取得 Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. 新增 Provider

開啟 Cherry Studio，進入 **設定 → 模型服務 → 新增提供者**，填寫：

| 欄位 | 值 |
| - | - |
| 提供者名稱 | `Ace Data Cloud` |
| 提供者類型 | `OpenAI` |
| API Key | 剛剛複製的 API Key |
| API 位址 | `https://api.acedata.cloud` |

![Cherry Studio 新增 Ace Data Cloud Provider 設定介面](https://cdn.acedata.cloud/b67a927eae62.png)

Cherry Studio 會為 OpenAI 類型自動補全 `/v1/chat/completions`。使用通用入口時，不要在位址末尾加上 `#`，也無需依模型家族建立多份 Provider。

## 3. 新增並啟用模型

1. 點擊 **取得模型列表**；如果目前版本不支援自動取得，則前往 [模型目錄](https://platform.acedata.cloud/models) 查看，再手動新增目標模型名稱，例如 `claude-opus-5`、`gpt-6-sol`。
2. 點擊 API Key 旁的檢查按鈕驗證連線。
3. 開啟 Provider 的 **啟用** 開關。
4. 在對話模型選擇器中選擇剛新增的模型。

![Cherry Studio Provider 與模型列表](https://cdn.acedata.cloud/149de1d088bf.png)

> 完成模型取得或手動新增後，請開啟右上角的 Provider 開關。

傳送 `Reply only OK`，並在 [使用紀錄](https://platform.acedata.cloud/console/usages) 核對呼叫。401 請檢查 Key；模型未顯示時請檢查 Provider 是否已啟用；404 請檢查手動填寫的模型名稱是否與目錄中的 `id` 完全一致。

## 關於 GPT Image 2

Cherry Studio 的一般自訂聊天 Provider 無法直接呼叫 Images API。`gpt-image-2` 的生成與編輯應使用 Ace Data Cloud 專用介面：

* [GPT Image 2 圖像生成](https://platform.acedata.cloud/documents/openai-images-generations)
* [GPT Image 2 圖像編輯](https://platform.acedata.cloud/documents/openai-images-edits)

不要將 `/openai/images/generations` 填入聊天 Provider。

## 官方參考

* [Cherry Studio](https://cherry-ai.com/)
* [自訂服務商](https://docs.cherry-ai.com/pre-basic/providers/zi-ding-yi-fu-wu-shang)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.