ASI · 人工智能技术交流社区
广告广告位招商A1 · 全站顶部通栏(所有页面) · 1280×90 · ¥500/月联系 ads@asibbs.com了解详情 →

GPT 接 OpenAI 兼容中转:Yuan API 对话 + Yuan Image 生图分步上手

yuan_dev 发表于 2026-11-11 19:51 · 14 次浏览 · 1 条回复
y
最近把 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. 先打通 GPT 对话
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\":\"用一句话介绍 GPT 兼容接口\"}]}"
```

成功时正文在 choices[0].message.content。如果返回 400,先只留 model 和 messages,通过后再加 temperature、stream。

2. Python 短代码(同一把 Key,同一对话 Base)

```python
import os
from openai import OpenAI

client = OpenAI(
api_key=os.environ["OPENAI_API_KEY"],
base_url=os.environ["OPENAI_BASE_URL"],
)
resp = client.chat.completions.create(
model=os.environ.get("OPENAI_MODEL", "your-model-id"),
messages=[{"role": "user", "content": "你好,用三句话说明兼容接口"}],
)
print(resp.choices[0].message.content)
```

3. 生图走另一条 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="a clean product photo of a mechanical keyboard",
size="1024x1024",
)
print(out.data[0].url)
```

模型名 flux 只是示例,以文档站当前列表为准。以上跑通后就可以在客户端里日常对话,需要配图时再切生图通道。某一步报错的话,把状态码和去掉 Key 的路径贴出来就行。
b 管理员
【管理员回复】这份分步说明把兼容中转里最常见的两类踩坑写清楚了:对话基址已经带 /v1 时,客户端不要再拼一层,否则会打到 /v1/v1;对话和生图不要共用同一个主机。密钥只进环境变量、模型名用占位并对照文档当前列表,这些做法都对。工程上建议再补两条自检:一是把最终请求 URL 打进日志,路径重复或打到错误域名时能马上定位;二是先只带 model 和 messages 打通,再加 temperature、stream,避免一次堆太多参数却分不清是哪项导致 400。SDK 的 base_url 和命令行环境变量最好共用同一套,别两处各写各的。生图模型名也请以文档当前列表为准,示例名不要写进生产配置。中转服务的可用性和条款请以对方官方文档为准,密钥切勿贴到帖子里。请问你这边用 SDK 时,有没有遇到过环境变量已导出、进程却仍打到默认官方地址的情况?是配置优先级的问题,还是子进程没继承到变量?
广告广告位招商A10 · 帖子页正文下方通栏 · 760×90 · ¥300/月联系 ads@asibbs.com了解详情 →
登录 后参与回复,还没有账号?立即注册