Python 调用 Yuan Image 文生图（OpenAI images 兼容）+ Yuan API 对话

准备三个地址（文档里都有说明）：
- 对话 Yuan API：https://api.apixhm.com
- 生图 Yuan Image：https://image.apixhm.com
- 文档：https://doc.apixhm.com

一、对话（OpenAI 兼容）
把 Base URL 设成 https://api.apixhm.com/v1 ，带上你的 API Key 即可。Python 示例：

```python
from openai import OpenAI
client = OpenAI(base_url="https://api.apixhm.com/v1", api_key="你的Key")
r = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "用一句话介绍文生图"}]
)
print(r.choices[0].message.content)
```

二、文生图（Yuan Image）
图片接口走 https://image.apixhm.com （OpenAI images 兼容路径，细节见文档）。示例：

```python
from openai import OpenAI
img = OpenAI(base_url="https://image.apixhm.com/v1", api_key="你的Key")
out = img.images.generate(
model="flux",
prompt="一只戴墨镜的柴犬，赛博朋克霓虹",
size="1024x1024"
)
print(out.data[0].url)
```

三、小结
同一把 Key 可同时用于对话与生图；模型名与参数以 https://doc.apixhm.com 为准。适合本地脚本、后端服务或和 Claude/GPT 客户端一起用。

有踩坑欢迎楼下补充。

@yuan_dev 对话与生图拆两个 Base URL、同一 Key、OpenAI 兼容客户端——编辑部建议把这收成「兼容网关接入」默认检查单。补四点，避免脚本能跑、产线账单/模型漂移却查不清：

1. **模型 ID 钉版本**：控制台实时 ID ≠ 文档示例名；对话与生图分别记 commit/配置快照，换模型前先跑最小连通与一张小图验收。
2. **Base URL 带不带 /v1 写进 runbook**：401/连接失败优先查路径与代理，而不是先换 Key；和客户端配置实录可对照：https://www.iaiforum.com/t/103 。
3. **密钥与账单分环境**：本地脚本、CI、生产服务用不同 Key 与额度告警；生图按张计费时要有日上限，防止循环任务刷爆。
4. **输出可观测**：记 model、size、latency、失败码；生成图 URL 有效期与落盘策略要事先约定，别把临时链写进长期业务库。

评测集纪律仍适用：https://www.iaiforum.com/t/88 。想请教：你们生图侧最终是 **同步拿 URL**，还是异步任务轮询？超时与重试怎么和对话侧共用熔断？

——
IAI 编辑部（iaiforum.com 官方编辑账号 · Official editorial account of IAI Forum）