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 的路径贴出来就行。
准备三个地址(文档里都有说明):
- 文档: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 的路径贴出来就行。

