在 Cherry Studio 中使用 Ace Data Cloud

Cherry Studio 是一款开源的多模型 AI 桌面客户端，支持 Windows、macOS、Linux。它「自定义服务商 + 自定义 API 地址」的能力，可以让你把任意 OpenAI 兼容的网关（包括 Ace Data Cloud）接入到同一个客户端里。

借助 Ace Data Cloud，你只需要一份 API Token，就能在 Cherry Studio 中使用：

对话模型：Claude、GPT（含 gpt-4o-image 等对话式画图模型）、Gemini、Grok、Kimi、GLM、DeepSeek。
专用图像模型：通过命令行 / SDK 直接调用 gpt-image-2、gpt-image-1.5、nano-banana-pro 等（这部分 Cherry Studio 的 UI 暂时无法直接接入，本文末尾给出原生调用方式）。

本文档严格按照 Cherry Studio 官方文档中描述的 UI 字段，介绍如何在 Cherry Studio 中接入 Ace Data Cloud。

申请流程

要在 Cherry Studio 中接入 Ace Data Cloud，首先到 Ace Data Cloud 控制台，获取您的 API Token，留作备用。

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费体验 Ace Data Cloud 的模型服务。

关键背景

要正确配置 Cherry Studio，请先理解两件事——它们都来自 Cherry Studio 官方文档和 Ace Data Cloud 的实际接口结构。

1. Cherry Studio 的「API 地址」拼接规则

Cherry Studio 在 OpenAI 类型供应商中对 API 地址 字段有明确约定（来源：Cherry Studio 官方文档 — 模型服务设置）：

不以 # 结尾：Cherry Studio 会自动在末尾拼接 /v1/chat/completions。比如你填 https://api.example.com，实际请求的就是 https://api.example.com/v1/chat/completions。
以 # 结尾：Cherry Studio 把 # 之前的部分作为完整 URL 直接使用，不再做任何拼接。这是指向非默认路径（例如 /openai/chat/completions、/gemini/chat/completions）的关键。

2. Ace Data Cloud 一个模型家族一个入口

Ace Data Cloud 为每个上游模型家族都提供了独立的 OpenAI 兼容入口（如 GPT 走 /openai、Gemini 走 /gemini）。此外 /v1/chat/completions 是一个通用入口，可路由任意家族的 model ID（不限于 Claude）。下面按家族列出各自入口，方便分组管理。

模型家族	Ace Data Cloud 接口	部分可用模型
Claude	`https://api.acedata.cloud/v1/chat/completions`	`claude-opus-4-8`、`claude-sonnet-4-6`、`claude-haiku-4-5-20251001`
GPT (OpenAI)	`https://api.acedata.cloud/openai/chat/completions`	`gpt-5.6-sol`、`gpt-5.6-terra`、`gpt-5.6-luna`、`gpt-5.5`、`gpt-5.5-pro`、`gpt-5.4`、`gpt-5.2`、`gpt-5-mini`、`gpt-4o`、`gpt-4o-image`、`o3`
Gemini	`https://api.acedata.cloud/gemini/chat/completions`	`gemini-3.1-pro`、`gemini-3.0-pro`、`gemini-3.5-flash`、`gemini-2.5-pro`
Grok	`https://api.acedata.cloud/grok/chat/completions`	`grok-4`、`grok-3`
Kimi	`https://api.acedata.cloud/kimi/chat/completions`	`kimi-k3`、`kimi-k2.6`、`kimi-k2.5`
GLM	`https://api.acedata.cloud/glm/chat/completions`	`glm-5.3`、`glm-5.2`、`glm-5.1`、`glm-4.7`、`glm-4.6`
DeepSeek	`https://api.acedata.cloud/deepseek/chat/completions`	`deepseek-r1`、`deepseek-v3`、`deepseek-v4-pro`、`deepseek-v4-flash`

Claude 的入口刚好就是 Cherry Studio 的默认路径 /v1/chat/completions，所以 Claude 不需要加 #；其它家族都必须使用带 # 的完整 URL。完整模型清单请以 Ace Data Cloud 控制台中各服务的 API 文档为准。

因此在 Cherry Studio 中，你可以为每个模型家族分别建一条供应商配置；如果嫌麻烦，也可以只建一条指向 /v1/chat/completions（结尾不加 #）的供应商，把各家族的 model ID 都加进去——该通用入口对所有家族都有效。

通用步骤：在 Cherry Studio 中添加自定义服务商

下面是 Cherry Studio 自定义服务商的通用流程，后面所有家族都按这个步骤来，只是填的「API 地址」和模型 ID 不同。

在 Cherry Studio 左侧导航栏中点击设置（齿轮图标），选择 模型服务 选项卡。
在已有服务商列表下方点击 + 添加 按钮，打开 「添加提供商」 弹窗。
在弹窗中填：
- 提供商名称：易于识别的名字，例如 Ace Data Cloud - Claude。
- 提供商类型：从下拉里选 OpenAI（Cherry Studio 自定义服务商支持 OpenAI / Gemini / Anthropic / Azure OpenAI 四种类型）。
点击「添加」保存。
在服务商列表中找到刚添加的项，进入详情页：
- 启用开关（右上角 / 列表右侧）：必须打开，否则模型不会出现在对话选择器里。
- API 密钥：粘贴 Ace Data Cloud 的 API Token；可点旁边的检查按钮校验密钥。
- API 地址：填本文给出的对应家族 URL（除 Claude 外都以 # 结尾）。
- 模型管理：点击 + 添加 按钮，手动输入要使用的模型 ID（必须与本文档或 Ace Data Cloud 文档中给出的 ID 大小写完全一致）。

下面以每个家族为例。

配置 Claude

提供商类型：OpenAI
API 密钥：Ace Data Cloud Token

API 地址：

1	https://api.acedata.cloud

不要加 #。Cherry Studio 会自动拼接 /v1/chat/completions，这正是 Ace Data Cloud 中 Claude 服务的入口。

添加的模型 ID（示例）：claude-opus-4-8、claude-sonnet-4-6、claude-haiku-4-5-20251001

完整模型列表请参考 Claude AI 服务文档。

配置 GPT / Gemini / Grok / Kimi / GLM / DeepSeek

非 Claude 家族的「API 地址」都必须以 # 结尾。以 GPT 为例：

提供商类型：OpenAI
API 密钥：同上

API 地址：

1	https://api.acedata.cloud/openai/chat/completions#

添加的模型 ID（示例）：gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.5、gpt-5.5-pro、gpt-5.4、gpt-5.2、gpt-5-mini、gpt-4o、gpt-4o-image、o3

其余家族同理，只需把 API 地址替换为：

Gemini：https://api.acedata.cloud/gemini/chat/completions#
Grok：https://api.acedata.cloud/grok/chat/completions#
Kimi：https://api.acedata.cloud/kimi/chat/completions#
GLM：https://api.acedata.cloud/glm/chat/completions#
DeepSeek：https://api.acedata.cloud/deepseek/chat/completions#

每条供应商配置只需要添加对应家族的模型 ID。同一份 API Token 可以在所有供应商中复用，额度也是共享的。

在 Cherry Studio 的对话中生成图片：使用 `gpt-4o-image`

Cherry Studio 的「绘画」面板目前只支持 DMXAPI、TokenFlux、AiHubMix、硅基流动四个内置供应商的绘画模型，无法添加自定义画图服务商。同时它的 OpenAI 自定义供应商发送的是 chat-completion 形态请求，无法对接 Ace Data Cloud 的 /openai/images/generations 这种 Images-API 形态接口。

不过 Ace Data Cloud 的 gpt-4o-image 是一个 chat-completion 形态的图像模型——它接受标准的 messages[] 输入，把生成的图片以 ![](URL) 的 Markdown 形式放在 choices[0].message.content 里返回，因此可以直接通过 Cherry Studio 的对话面板使用。

配置方式：

复用上文的 「配置 GPT (OpenAI)」 供应商（API 地址 https://api.acedata.cloud/openai/chat/completions#）。
在该供应商下「+ 添加」模型 gpt-4o-image。
新建对话，在模型选择器中切到 gpt-4o-image，直接输入提示词即可。Cherry Studio 会按 Markdown 渲染响应里的图片 URL。

如果你希望让模型在「一张已有图片」的基础上修改，可以在对话框里附带图片（Cherry Studio 会以 image_url 形态发送，与 OpenAI 多模态消息一致）。如果对话框没有图片上传按钮，请到「模型管理」中为 gpt-4o-image 打开「视觉」能力开关——Cherry Studio 仅在模型被标记具备视觉能力时，才会显示图片上传入口。

完整请求/响应示例请参考 OpenAI Chat Completion API 文档的「GPT-4o 绘图模型」章节。

进阶：直接调用 `gpt-image-2` / `nano-banana-pro` 等专用图像模型

gpt-image-2、gpt-image-1.5、gpt-image-1、dall-e-3、nano-banana-pro、nano-banana-2、nano-banana-2-lite、nano-banana 这些是专用 Images-API 形态模型，请求体是 {model, prompt, size, ...} 而不是 {model, messages: [...]}。它们只能通过 Ace Data Cloud 的 /openai/images/generations 接口调用，不能配置进 Cherry Studio——只能用 curl / SDK / 后端服务直接对接。

接口地址：

1	https://api.acedata.cloud/openai/images/generations

可用 model（与 Ace Data Cloud OpenAI 图像服务的 model 枚举完全一致）：gpt-image-2、gpt-image-1.5、gpt-image-1、dall-e-3、nano-banana-pro、nano-banana-2、nano-banana-2-lite、nano-banana。

size 字段约束（来自 OpenAI 图像生成接口的官方说明）：可以是任意 WIDTHxHEIGHT 字符串，但需要满足宽高均为 16 的倍数、长边 ≤ 3840、总像素 ≤ 8,294,400。文档中给出的预设值如下：

比例	1K	2K	4K
1:1	`1024x1024`	`2048x2048`	`2880x2880`
4:3	`1536x1024`	`2048x1536`	`3264x2448`
3:4	`1024x1536`	`1536x2048`	`2448x3264`
16:9	`1792x1024`	`2048x1152`	`3840x2160`
9:16	`1024x1792`	`1152x2048`	`2160x3840`

注意事项：

计费按张数固定，与 size 无关。
gpt-image-1 / gpt-image-1.5 / gpt-image-2、nano-banana / nano-banana-2-lite / nano-banana-2 / nano-banana-pro 家族不支持 n > 1：即使传入更大的 n，也只会返回 1 张图、只计 1 张费用。如需多张候选，请并发发送多次请求。
长耗时任务可以在请求体里传 callback_url，由 Ace Data Cloud 在出图后回调通知，避免占用客户端的等待连接。

curl 示例

以 gpt-image-2 生成一张 1:1 的 1K 图片：

curl https://api.acedata.cloud/openai/images/generations \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A vintage travel poster of the Amalfi Coast, art-deco style, bold typography reads AMALFI",
    "size": "1024x1024"
  }'

响应的 data[0].url 即为生成图片地址。完整字段说明（包括图像编辑 /openai/images/edits 的 image / mask 等参数）请参考：

为什么在 Cherry Studio 中使用 Ace Data Cloud

一份 Token 接入多家对话模型

Cherry Studio 原生支持的服务商虽多，但每家都需要自行注册、申请密钥、各自计费。通过 Ace Data Cloud，你只需要一份 API Token，就能在同一份额度下使用 Claude、GPT、Gemini、Grok、Kimi、GLM、DeepSeek 等模型，以及对话式画图模型 gpt-4o-image。

统一额度与扣费明细

所有请求按实际 Token / 张数计费，统一在 Ace Data Cloud 控制台 - 使用历史查看；应用列表中可以实时查看剩余额度。新用户首次申请有免费额度赠送。

国内可直连

Ace Data Cloud 在境内提供接入节点，无需自建代理即可在中国大陆访问 OpenAI / Anthropic / Gemini 等模型。

限制与注意事项

每个模型家族需要独立的供应商配置：Claude 用默认拼接，其它家族必须带 # 并指向各自路径。把 gpt-5.5 发到 /v1/chat/completions 不会被识别。
末尾 # 不可省略：所有指向 /openai/...、/gemini/...、/grok/...、/kimi/...、/glm/...、/deepseek/... 的供应商，API 地址必须以 # 结尾，否则 Cherry Studio 会强行追加 /v1/chat/completions。
保存后务必打开启用开关：Cherry Studio 官方文档明确提醒「配置成功后务必打开右上角的开关，否则该服务商仍处于未启用状态」。
Cherry Studio 不能直连专用 Images API 模型：gpt-image-2 / nano-banana-pro / dall-e-3 等只能通过 curl / SDK 直接调用 /openai/images/generations。需要在 Cherry Studio 对话里画图，请使用 chat-completion 形态的 gpt-4o-image。
n > 1 不支持：gpt-image-*、nano-banana* 家族单次请求只返回 1 张图。

常见问题

提示 `token_mismatched` 或 `invalid_token`

请确认在「API 密钥」字段中粘贴的是 Ace Data Cloud 的 API Token，并且 Token 在控制台中仍处于可用状态、所属应用的余额充足。

提示模型不存在 / `api_not_implemented` / 404

绝大多数情况是把模型发到了不对的入口（例如把 gpt-5.5 发到了 Claude 入口），或者非 Claude 供应商的 API 地址末尾漏掉了 #。请按本文「关键背景」中的对照表为每个家族单独建供应商。

模型已经添加，但在对话选择器里看不到

请检查目标供应商「右上角的启用开关」是否打开。Cherry Studio 在供应商未启用时不会把它的模型加入对话选择器。

想在 Cherry Studio 里用 `gpt-image-2`

Cherry Studio 的「绘画」面板和 OpenAI 自定义供应商目前都无法对接 Ace Data Cloud 的 /openai/images/generations。请使用 gpt-4o-image（对话式画图，可在 Cherry Studio 对话中直接使用），或者用 curl / SDK 在 Cherry Studio 之外直接调用专用 Images API。

静觅崔庆才的个人站点 - Python爬虫教程

在 Cherry Studio 中使用 Ace Data Cloud

申请流程

关键背景

1. Cherry Studio 的「API 地址」拼接规则

2. Ace Data Cloud 一个模型家族一个入口

通用步骤：在 Cherry Studio 中添加自定义服务商

配置 Claude

配置 GPT / Gemini / Grok / Kimi / GLM / DeepSeek

在 Cherry Studio 的对话中生成图片：使用 `gpt-4o-image`

进阶：直接调用 `gpt-image-2` / `nano-banana-pro` 等专用图像模型

curl 示例

为什么在 Cherry Studio 中使用 Ace Data Cloud

一份 Token 接入多家对话模型

统一额度与扣费明细

国内可直连

限制与注意事项

常见问题

提示 `token_mismatched` 或 `invalid_token`

提示模型不存在 / `api_not_implemented` / 404

模型已经添加，但在对话选择器里看不到

想在 Cherry Studio 里用 `gpt-image-2`

如何查看剩余额度

了解更多

申请流程

关键背景

1. Cherry Studio 的「API 地址」拼接规则

2. Ace Data Cloud 一个模型家族一个入口

通用步骤：在 Cherry Studio 中添加自定义服务商

配置 Claude

配置 GPT / Gemini / Grok / Kimi / GLM / DeepSeek

在 Cherry Studio 的对话中生成图片：使用 gpt-4o-image

进阶：直接调用 gpt-image-2 / nano-banana-pro 等专用图像模型

curl 示例

为什么在 Cherry Studio 中使用 Ace Data Cloud

一份 Token 接入多家对话模型

统一额度与扣费明细

国内可直连

限制与注意事项

常见问题

提示 token_mismatched 或 invalid_token

提示模型不存在 / api_not_implemented / 404

模型已经添加，但在对话选择器里看不到

想在 Cherry Studio 里用 gpt-image-2

如何查看剩余额度

了解更多

在 Cherry Studio 的对话中生成图片：使用 `gpt-4o-image`

进阶：直接调用 `gpt-image-2` / `nano-banana-pro` 等专用图像模型

提示 `token_mismatched` 或 `invalid_token`

提示模型不存在 / `api_not_implemented` / 404

想在 Cherry Studio 里用 `gpt-image-2`