广告 / 赞助展示NVIDIA DGX B200 AI 系统官方产品图GPU 与加速计算访问官网 →

GPT(OpenAI 兼容)接 Yuan API 写代码 + Yuan Image 配图

Started by yuan_dev · 2026-11-10 04:53 北京时间 · 25 views · 1 replies
Y Member
最近把 GPT(以及同一套 OpenAI 兼容接口)接到 Yuan API 上写代码和对话,生图单独走 Yuan Image,这里记一份能跑通的最短步骤。

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

按文档口径:GPT 和 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,指向 GPT 兼容网关)

```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. 接到常见 GPT / OpenAI 兼容客户端
在客户端里新建自定义提供商,类型选 OpenAI Compatible:
- API Host / Base URL:对话主机加 /v1(与上面的 OPENAI_BASE_URL 一致)
- API Key:只填本地保存的密钥
- 模型名:填文档站当前列表里的 ID,不要把 your-model-id 带进生产

保存后切到该提供商即可对话。字段名如果和当前客户端不一致,以文档为准。

4. 生图走另一条 Base
对话和生图不要混用主机。生图示例:

```python
import os
from openai import OpenAI

img = OpenAI(
api_key=os.environ["OPENAI_API_KEY"],
base_url="https://image.apixhm.com/v1",
)
out = img.images.generate(
model="flux",
prompt="flat illustration of a laptop and a coffee cup, soft light",
size="1024x1024",
)
print(out.data[0].url)
```

5. 容易踩的点
- 对话走对话主机,生图走生图主机,两套地址不要串。
- GPT / OpenAI 兼容客户端的 Base URL 用对话主机的 /v1,不要重复拼接 /v1。
- 参数和模型列表以文档站为准。

自用实测可以写代码和出图。某一步报错的话,把状态码和去掉 Key 的路径贴出来就行,欢迎一起补。
I IAI 编辑部 · 官方 Official
@yuan_dev 这份 GPT / OpenAI 兼容客户端接 Yuan API、生图单独走 Yuan Image 的最短路径,可以和昨天 Codex 那篇(https://www.iaiforum.com/t/183 )对照着看:对话主机与生图主机分家、Base URL 已带 /v1 就不要再拼一层、Key 只放环境变量——这三条是同一套契约,只是客户端从 Codex 换成了常见 GPT 兼容入口。编辑部不重复那几条接入纪律,只补三条容易在「换客户端」时悄悄走样的闸门:

1. **客户端字段名以当前文档和该客户端版本为准,不要照抄另一款客户端的配置键**:OpenAI Compatible 提供商里的 API Host / Base URL / 模型名,和 Codex 的 `wire_api` 不是同一张表。发布附件应记下所用客户端名称与版本,占位符 your-model-id 不能进生产。灰度:https://www.iaiforum.com/t/87 。
2. **同一进程里两个 OpenAI() 客户端也要隔离配置**:对话走 `api.apixhm.com`、生图走 `image.apixhm.com`;若共享了默认 Base 或把生图模型名写进对话侧环境变量,常见表现是路径 404 或「能连但不会做」。可观测:https://www.iaiforum.com/t/73 。
3. **生图模型 ID 与 size 以文档站当前列表为准**:示例里的 `flux` 和 `1024x1024` 只是示意,换账号或换文档版本后必须自测。生成代码仍要按可维护性验收,不要「能跑就行」:https://www.iaiforum.com/t/104 。工具/密钥面:https://www.iaiforum.com/t/77 。

想追问:你们最终跑通的 GPT 兼容客户端,字段名和文档完全一致,还是改过 Host 写法?生图这边文档列表里的模型 ID,和示例里的 `flux` 是否同一条?同一脚本里同时持有对话、生图两个客户端时,有没有出现过环境变量互相覆盖?

——
IAI 编辑部(iaiforum.com 官方编辑账号 · Official editorial account of IAI Forum)
广告 / 赞助展示广告位招商此处招商 · ads@iaiforum.comA6 · 728×90(移动端 320×100)了解详情 →
Log in or register to reply.