大家好，之前写过一遍 Cherry Studio 的基础接入。这次把最容易踩的坑单独拆开：对话和生图不要共用同一个 API Host，在 Cherry Studio 里建成两个供应商更稳。

## 1. 准备

- 文档：https://doc.apixhm.com

- 对话（Yuan API）：https://api.apixhm.com

- 生图（Yuan Image）：https://image.apixhm.com

在后台创建 API Key，只放在本地客户端里，不要写进仓库或帖子。

## 2. 添加对话供应商

1. 打开 Cherry Studio → 设置 → 模型服务 → 添加「OpenAI 兼容」

2. 名称可填 Yuan API

3. API Host：先填 https://api.apixhm.com 。若请求报错路径里出现 /v1/v1，说明客户端已经自动补了 /v1；若提示找不到 /v1/chat/completions，再改成 https://api.apixhm.com/v1

4. API Key 填本地密钥

5. 按 https://doc.apixhm.com 添加可用对话模型，不要猜模型名

6. 新建对话，发一句「用三句话说明什么是 OpenAI 兼容接口」验证

## 3. 再添加生图供应商

不要把上面的 Host 改成生图地址后混用，另建一个供应商：

1. 再添加一个 OpenAI 兼容服务，名称可填 Yuan Image

2. API Host：https://image.apixhm.com（同样注意不要重复拼接 /v1）

3. 用同一把 Key 即可；模型 ID 以 https://image.apixhm.com 模型广场和文档为准

4. 在生图功能里选这个供应商，用一句简单 prompt 试一张图，例如「一只橘猫坐在键盘旁，扁平插画」

可选：先用 curl 确认生图鉴权（把 YOUR_API_KEY 换成本地密钥，模型名改成你账号实际可用的生图模型 ID，不要照抄占位符）：

curl https://image.apixhm.com/v1/images/generations \

  -H "Authorization: Bearer YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"model":"YOUR_IMAGE_MODEL","prompt":"a small orange cat at a keyboard, flat illustration","size":"1024x1024"}'

## 4. 常见问题

- 对话超时或 429：降低并发，检查额度

- 出图失败但对话正常：多半是 Host 仍指向 https://api.apixhm.com，确认已切换到 Yuan Image 供应商

- 模型名、完整路径都以 https://doc.apixhm.com 为准

欢迎补充在 Xiuno 站务或插件里对接兼容 API 的经验。