在 Cherry Studio 中使用 Ace Data Cloud
内容提要
本文介绍如何在Cherry Studio中接入Ace Data Cloud，通过一份API Token使用Claude、GPT、Gemini等多家模型。配置时需注意API地址规则：Claude用默认路径不加#，其他家族需以#结尾指向各自入口。还说明了gpt-4o-image可在对话中画图，而gpt-image-2等专用模型需用curl直接调用。
延伸解读
API 地址拼接规则是配置成败的关键
Cherry Studio 对 API 地址有特殊拼接规则：不以 # 结尾会自动追加 /v1/chat/completions，以 # 结尾则直接使用完整 URL。Ace Data Cloud 为每个模型家族提供独立入口，Claude 恰好使用默认路径，因此无需加 #；其他家族必须加 # 指向各自路径。若漏掉 # 或混淆入口，会导致模型不存在或 404 错误。
一份 Token 统一管理多家模型，但需分组配置
通过 Ace Data Cloud，只需一份 API Token 即可使用 Claude、GPT、Gemini 等多家模型，额度共享。但 Cherry Studio 中每个模型家族需单独创建供应商配置，分别填写对应 API 地址和模型 ID。虽然也可使用通用入口 /v1/chat/completions 统一添加所有模型，但分组配置更清晰，便于管理和排查问题。
对话画图与专用图像模型的区别
Cherry Studio 的对话面板只能使用 chat-completion 形态的图像模型，如 gpt-4o-image，它通过 Markdown 返回图片 URL。而 gpt-image-2 等专用图像模型采用 Images-API 形态，无法在 Cherry Studio 中直接使用，需通过 curl 或 SDK 调用 /openai/images/generations 接口。若需在对话中画图，务必选择 gpt-4o-image。
使用专用图像模型时的注意事项
调用 gpt-image-2 等专用模型时，需注意 size 参数必须满足宽高为 16 的倍数、长边不超过 3840、总像素不超过 8,294,400。计费按张数固定，与 size 无关。此外，gpt-image-* 和 nano-banana* 家族不支持 n>1，即使传入更大的 n 也只会返回一张图。长耗时任务可传入 callback_url 进行异步回调。
Q&A
如何在 Cherry Studio 中配置 Ace Data Cloud 的 Claude 模型？
在 Cherry Studio 中添加自定义服务商，提供商类型选择 OpenAI，API 密钥填入 Ace Data Cloud 的 API Token，API 地址填写 https://api.acedata.cloud（不要加 #），然后添加模型 ID 如 claude-opus-4-8。
为什么在 Cherry Studio 中配置非 Claude 模型时 API 地址要以 # 结尾？
因为 Cherry Studio 的 API 地址拼接规则是：不以 # 结尾会自动追加 /v1/chat/completions，而以 # 结尾则直接使用完整 URL。非 Claude 家族（如 GPT、Gemini）的入口不是默认路径，所以必须用 # 结尾来指定完整路径，否则请求会发错地方。
在 Cherry Studio 中如何使用 gpt-4o-image 模型生成图片？
在配置好的 GPT 供应商下添加模型 gpt-4o-image，然后在对话中选择该模型，直接输入提示词即可。Cherry Studio 会渲染返回的 Markdown 图片 URL。如果要在已有图片上修改，可以附带图片，并确保在模型管理中开启视觉能力开关。
为什么 gpt-image-2 等专用图像模型不能在 Cherry Studio 中使用？
因为 gpt-image-2 等专用图像模型是 Images-API 形态，请求体是 {model, prompt, size}，而 Cherry Studio 的自定义供应商只支持 chat-completion 形态，无法对接 /openai/images/generations 接口。因此这些模型只能通过 curl 或 SDK 直接调用。
如何通过 curl 调用 Ace Data Cloud 的 gpt-image-2 模型生成图片？
使用 curl 命令，向 https://api.acedata.cloud/openai/images/generations 发送 POST 请求，请求头包含 Authorization: Bearer {token} 和 Content-Type: application/json，请求体包含 model、prompt、size 等参数。响应中的 data[0].url 即为生成的图片地址。
在 Cherry Studio 中配置 Ace Data Cloud 时，如果模型添加了但在对话选择器里看不到，可能是什么原因？
最常见的原因是供应商的启用开关没有打开。Cherry Studio 在供应商未启用时不会把它的模型加入对话选择器。请检查目标供应商的启用开关是否已打开。
Ace Data Cloud 的 API Token 可以在多个模型家族中复用吗？
可以。同一份 API Token 可以在所有供应商中复用，额度也是共享的。
在 Cherry Studio 中配置非 Claude 模型时，如果 API 地址末尾漏掉 # 会怎样？
如果漏掉 #，Cherry Studio 会自动在末尾拼接 /v1/chat/completions，导致请求发到错误的入口，从而出现模型不存在或 404 错误。
