Y
Member
最近把 Cherry Studio 接到 Yuan API 上对话和写代码,生图单独走 Yuan Image,这里记一份能跑通的最短步骤。
准备三个地址(文档里都有说明):
- 文档:https://doc.apixhm.com
- 对话(Yuan API):https://api.apixhm.com
- 生图(Yuan Image):https://image.apixhm.com
按文档口径:Cherry Studio 和 OpenAI 兼容客户端的 Base URL 用对话主机加 /v1;Claude Code 才用对话主机根路径(不要带 /v1)。模型 ID 以文档站和控制台当前列表为准,下面用 your-model-id 占位。Key 只放环境变量或客户端本地保存,不要写进帖子或仓库。
1. 先打通对话
Base URL 已经带 /v1 时,客户端不要再拼一层,否则会变成 /v1/v1。
```bash
export OPENAI_API_KEY="你的 API Key"
export OPENAI_BASE_URL="https://api.apixhm.com/v1"
export OPENAI_MODEL="your-model-id"
curl "$OPENAI_BASE_URL/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d "{\"model\":\"$OPENAI_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"用三句话说明 OpenAI 兼容接口\"}]}"
```
成功时正文在 choices[0].message.content。
2. Python 短代码(官方 openai SDK,指向同一网关)
```python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["OPENAI_API_KEY"],
base_url=os.environ["OPENAI_BASE_URL"],
)
r = client.chat.completions.create(
model=os.environ.get("OPENAI_MODEL", "your-model-id"),
messages=[{"role": "user", "content": "写一个读取 JSON 文件的 Python 函数"}],
)
print(r.choices[0].message.content)
```
3. 接到 Cherry Studio
打开 Cherry Studio → 设置 → 模型服务,添加一个提供商,类型选 OpenAI Compatible(或 OpenAI 兼容):
- API Host / Base URL:对话主机加 /v1(与上面的 OPENAI_BASE_URL 一致,https://api.apixhm.com/v1)
- API Key:只填本地保存的密钥
- 模型名:按文档站当前列表添加 ID,不要把 your-model-id 带进生产
保存后把对话模型切到该提供商即可。字段名如果和当前版本不一致,以文档为准。
4. 生图走另一条 Base
对话和生图不要混用同一个 Base。在 Cherry Studio 的图像/绘画相关设置里(或另加一个 OpenAI 兼容图像提供商),把生图接口指到 Yuan Image(https://image.apixhm.com,具体路径以文档为准),Key 同样只放本地。不要把对话的 /v1 chat 地址填进生图,也不要在生图地址后再叠一层 /v1。
以上跑通后就可以在 Cherry Studio 里日常对话、写代码,需要配图时再切生图通道。
准备三个地址(文档里都有说明):
- 文档:https://doc.apixhm.com
- 对话(Yuan API):https://api.apixhm.com
- 生图(Yuan Image):https://image.apixhm.com
按文档口径:Cherry Studio 和 OpenAI 兼容客户端的 Base URL 用对话主机加 /v1;Claude Code 才用对话主机根路径(不要带 /v1)。模型 ID 以文档站和控制台当前列表为准,下面用 your-model-id 占位。Key 只放环境变量或客户端本地保存,不要写进帖子或仓库。
1. 先打通对话
Base URL 已经带 /v1 时,客户端不要再拼一层,否则会变成 /v1/v1。
```bash
export OPENAI_API_KEY="你的 API Key"
export OPENAI_BASE_URL="https://api.apixhm.com/v1"
export OPENAI_MODEL="your-model-id"
curl "$OPENAI_BASE_URL/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d "{\"model\":\"$OPENAI_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"用三句话说明 OpenAI 兼容接口\"}]}"
```
成功时正文在 choices[0].message.content。
2. Python 短代码(官方 openai SDK,指向同一网关)
```python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["OPENAI_API_KEY"],
base_url=os.environ["OPENAI_BASE_URL"],
)
r = client.chat.completions.create(
model=os.environ.get("OPENAI_MODEL", "your-model-id"),
messages=[{"role": "user", "content": "写一个读取 JSON 文件的 Python 函数"}],
)
print(r.choices[0].message.content)
```
3. 接到 Cherry Studio
打开 Cherry Studio → 设置 → 模型服务,添加一个提供商,类型选 OpenAI Compatible(或 OpenAI 兼容):
- API Host / Base URL:对话主机加 /v1(与上面的 OPENAI_BASE_URL 一致,https://api.apixhm.com/v1)
- API Key:只填本地保存的密钥
- 模型名:按文档站当前列表添加 ID,不要把 your-model-id 带进生产
保存后把对话模型切到该提供商即可。字段名如果和当前版本不一致,以文档为准。
4. 生图走另一条 Base
对话和生图不要混用同一个 Base。在 Cherry Studio 的图像/绘画相关设置里(或另加一个 OpenAI 兼容图像提供商),把生图接口指到 Yuan Image(https://image.apixhm.com,具体路径以文档为准),Key 同样只放本地。不要把对话的 /v1 chat 地址填进生图,也不要在生图地址后再叠一层 /v1。
以上跑通后就可以在 Cherry Studio 里日常对话、写代码,需要配图时再切生图通道。

