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

Codex CLI(OpenAI 兼容)接 Yuan API 写代码,生图单独走 Yuan Image

Started by yuan_dev · 2026-11-12 03:37 北京时间 · 28 views · 2 replies
Y Member
最近用 Codex CLI 走 OpenAI 兼容接口接到 Yuan API 上写代码,生图不再走对话主机,而是单独接 Yuan Image。下面是一份能跑通的最短步骤,以 CLI 配置为主。

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

按文档口径:Codex 和 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\":\"用四步列出一个可维护的错误处理函数\"}]}"
```

成功时正文在 choices[0].message.content。

2. 接到 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 为准。wire_api 先按文档试 responses,不通再对照文档改,不要同时改 Base 和模型名。

3. 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"],
)
r = client.chat.completions.create(
model=os.environ.get("OPENAI_MODEL", "your-model-id"),
messages=[{"role": "user", "content": "写一个带重试的文件复制函数,只要关键逻辑"}],
)
print(r.choices[0].message.content)
```

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="isometric desk with a monitor and a plant, soft daylight",
size="1024x1024",
)
print(out.data[0].url)
```

模型名 flux 只是示例,以文档站当前列表为准。以上跑通后就可以用 Codex CLI 日常写代码,需要配图时再切生图通道。某一步报错的话,把状态码和去掉 Key 的路径贴出来就行。
I IAI 编辑部 · 官方 Official
@yuan_dev 这篇把同一条 Yuan API / Yuan Image 路径写到了 Codex CLI:对话主机加 /v1、生图走独立主机、Key 只放环境变量、模型 ID 以文档和控制台为准。可以和前两篇对照,而不把接入纪律整段再贴一遍:Codex 配置总述见 https://www.iaiforum.com/t/183 ,图形客户端 Cherry Studio 见 https://www.iaiforum.com/t/202 ,GPT / OpenAI 兼容客户端见 https://www.iaiforum.com/t/198 。编辑部只补四条在 CLI / `config.toml` 里更容易走样的闸门:

1. **`~/.codex/config.toml` 的字段名以当前 Codex 版本和 `codex --help` 为准**:`model_provider`、`base_url`、`env_key`、`wire_api` 不要从其他客户端或旧版示例直接抄键名;发布附件应记下 CLI 版本。灰度:https://www.iaiforum.com/t/87 。
2. **`wire_api` 要单独验证,不要和 Base、模型名同时改**:先按文档试 `responses`,不通时一次只改这一项并留下请求路径(脱敏)和状态码,否则 404 / 模式不匹配会难以归因。可观测:https://www.iaiforum.com/t/73 。
3. **环境变量与 toml 必须指向同一套对话 Base**:`OPENAI_BASE_URL` 已带 `/v1` 就不要再叠一层;若 toml 里的 `base_url` 和环境变量不一致,要以一次实际请求的最终 URL 为准。工具/密钥:https://www.iaiforum.com/t/77 。
4. **生图不要写进 Codex 的对话提供商**:对话走 `api.apixhm.com/v1`,生图走文档中的 Image 主机(示例里的模型名只是占位,以当前列表为准)。CLI 写代码和配图是两条客户端路径,不要把图像 Base 填进 `model_providers`。

想追问:你们实际使用的 Codex CLI 版本里,`wire_api = "responses"` 是一次就通,还是改过其他取值?`config.toml` 的 `base_url` 和环境变量是否完全一致,最终请求有没有被叠成 `/v1/v1`?生图是用独立脚本打 Image 主机,还是也曾误接到对话提供商上?

——
IAI 编辑部(iaiforum.com 官方编辑账号 · Official editorial account of IAI Forum)
P Member
Quick question: is the main advantage here performance or cost compared to the classic approach?
广告 / 赞助展示广告位招商此处招商 · ads@iaiforum.comA6 · 728×90(移动端 320×100)了解详情 →
Log in or register to reply.