y
最近在本地用 Cherry Studio 接 OpenAI 兼容接口,顺手把对话和文生图都打通了,记一下步骤,方便同类工具复用。
## 1. 准备
- 任意 OpenAI 兼容客户端(本文以 Cherry Studio 为例)
- 一个兼容网关的 API Key(下文以 Yuan API 为例)
文档:https://doc.apixhm.com
对话/兼容入口:https://api.apixhm.com
文生图入口:https://image.apixhm.com
## 2. Cherry Studio 对话
1. 设置 → 模型服务 → 添加「OpenAI 兼容」
2. API 地址填:https://api.apixhm.com/v1
3. 填入 API Key,拉取模型列表后选一个对话模型
4. 新建助手对话,确认能正常流式输出
## 3. 文生图(Yuan Image)
以 curl 为例:
curl https://image.apixhm.com/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "dall-e-3", "prompt": "flat illustration of a desk with dual monitors, soft lighting", "size": "1024x1024"}'
具体可用模型名以控制台或文档为准。
## 4. 最小 Python 对话示例
```python
from openai import OpenAI
client = OpenAI(api_key="YOUR_KEY", base_url="https://api.apixhm.com/v1")
r = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "用三句话介绍文生图工作流"}],
)
print(r.choices[0].message.content)
```
## 5. 踩坑
- base_url 要带 /v1
- 对话与生图若分属不同域名,客户端里分别配置
- Key 权限不够时先在控制台开通对应能力
以上是自用笔记,欢迎补充其它客户端的配置。
## 1. 准备
- 任意 OpenAI 兼容客户端(本文以 Cherry Studio 为例)
- 一个兼容网关的 API Key(下文以 Yuan API 为例)
文档:https://doc.apixhm.com
对话/兼容入口:https://api.apixhm.com
文生图入口:https://image.apixhm.com
## 2. Cherry Studio 对话
1. 设置 → 模型服务 → 添加「OpenAI 兼容」
2. API 地址填:https://api.apixhm.com/v1
3. 填入 API Key,拉取模型列表后选一个对话模型
4. 新建助手对话,确认能正常流式输出
## 3. 文生图(Yuan Image)
以 curl 为例:
curl https://image.apixhm.com/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "dall-e-3", "prompt": "flat illustration of a desk with dual monitors, soft lighting", "size": "1024x1024"}'
具体可用模型名以控制台或文档为准。
## 4. 最小 Python 对话示例
```python
from openai import OpenAI
client = OpenAI(api_key="YOUR_KEY", base_url="https://api.apixhm.com/v1")
r = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "用三句话介绍文生图工作流"}],
)
print(r.choices[0].message.content)
```
## 5. 踩坑
- base_url 要带 /v1
- 对话与生图若分属不同域名,客户端里分别配置
- Key 权限不够时先在控制台开通对应能力
以上是自用笔记,欢迎补充其它客户端的配置。