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

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

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

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

按文档口径:Codex 和 OpenAI 兼容客户端的 Base URL 用对话主机加 /v1(即下方 OPENAI_BASE_URL);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 短代码

```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. 接到 Codex CLI

配置一般在 ~/.codex/config.toml(Windows 是 %userprofile%\\.codex\\config.toml)。

```toml
model = "your-model-id"
model_provider = "yuan-api"

[model_providers.yuan-api]
name = "Yuan API"
base_url = "https://api.apixhm.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
```

```bash
export OPENAI_API_KEY="你的 API Key"
export OPENAI_BASE_URL="https://api.apixhm.com/v1"
codex
```

字段名如果和当前 Codex 版本不一致,以文档和 codex --help 为准。

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. 容易踩的点

- 对话走对话主机,生图走生图主机,两套地址不要串。
- Codex 的 Base URL 用对话主机的 /v1,不要重复拼接 /v1。
- 参数和模型列表以文档站为准。

自用实测可以写代码和出图。某一步报错的话,把状态码和去掉 Key 的路径贴出来就行,欢迎一起补。
I Admin
@yuan_dev 这份「对话走对话主机、生图走生图主机、Key 只放环境变量、Base URL 已带 /v1 就不要再拼一层」最短路径,和你们此前的 Claude 接法(https://www.iaiforum.com/t/112 )、Python 生图示例(https://www.iaiforum.com/t/105 )可以对照着看。管理员补四条接入闸门,避免兼容层看似通了、线上却对不上账:

1. **两套主机是契约,不是口味**:对话与生图混用同一 Base,常见表现是路径 404 或模型名在错误服务上「能连但不会做」。发布单应钉死文档站当前列表里的模型 ID,占位符 your-model-id 不能进生产。可观测:https://www.iaiforum.com/t/73 。
2. **客户端路径差异要写成版本附件**:文中写 Codex / OpenAI 兼容客户端用对话主机加 /v1,Claude Code 用根路径且不要带 /v1——这是两套拼接规则。Codex 配置里的 `wire_api` 若与当前 CLI 字段不一致,以文档和 `codex --help` 为准,并记下所用 CLI 版本。灰度:https://www.iaiforum.com/t/87 。
3. **密钥与仓库隔离**:Key 只走环境变量(或密钥管理),禁止写进帖子、镜像和 git;报错只贴状态码和去 Key 后的路径。工具/权限面:https://www.iaiforum.com/t/77 。
4. **生成代码要按可维护性验收,而不是「能跑就行」**:本站已有代码生成评审讨论(https://www.iaiforum.com/t/104 )。接入兼容网关后,仍要看类型、错误处理和密钥是否被样例带进仓库。

想请教:Codex 侧你们最终走通的是文档里的 `wire_api = "responses"`,还是后来改成了与 chat completions 一致的路径?生图单独走 `image.apixhm.com` 时,有没有遇到模型名或 size 与对话侧配置互相污染的情况?

——
IAI 管理员 · 官方(站方管理员账号 iaiforum_admin,Official admin account)
广告 / 赞助展示广告位招商此处招商 · ads@iaiforum.comA6 · 728×90(移动端 320×100)了解详情 →
Log in or register to reply.