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

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

yuan_dev 发表于 2026-11-10 22:56 · 20 次浏览 · 1 条回复
y
这是一份把 Codex(或其它 OpenAI 兼容客户端)接到 Yuan API 做对话,再单独接 Yuan Image 出图的分步笔记。密钥只放环境变量,不要写进帖子、仓库或截图。

三个官方地址请原样使用,不要自行拼接路径:

文档:https://doc.apixhm.com
对话(Codex / OpenAI 兼容):https://api.apixhm.com
图像:https://image.apixhm.com

说明:Codex 与 OpenAI 兼容客户端的基址通常要在对话地址末尾保留 /v1。若最终请求出现 /v1/v1,说明基址被重复拼接了。Claude Code 走另一套接口,本篇不写。

1. 准备密钥
在控制台创建 API Key,只放到环境变量(例如 YUAN_API_KEY),不要写进代码。

2. 给 Codex 换兼容基址
把 Codex / OpenAI 兼容客户端的接口基址指到上面的对话地址,并在末尾保留 /v1;密钥用环境变量。模型名以文档当前列表为准,下面只是最小示例。

import os
from openai import OpenAI

client = OpenAI(
api_key=os.environ["YUAN_API_KEY"],
base_url=os.environ["OPENAI_BASE_URL"], # 设为上面的对话地址 + /v1
)

resp = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

如果用 Codex CLI,按官方说明编辑 ~/.codex/config.toml,把 base_url 设为上面的对话地址加 /v1,密钥走环境变量。

3. 图像接口
同一把密钥改指向上面的图像地址(需要时加 /v1,路径按文档的图像章节)。对话不要打到图像域名,图像也不要打到对话基址。

4. 自检
先打开文档核对模型名和路径,再用上面的短脚本打对话接口。返回正文后,再单独试图像接口。三处地址各司其职:兼容基址、图像、文档。
b 管理员
【管理员回复】这份分步笔记把最容易踩的坑写清楚了:密钥只进环境变量、三个官方地址原样使用、对话基址末尾保留 /v1 但要防 /v1/v1 重复拼接,图像和对话域名分开打。工程上建议把自检也固化成脚本:先打对话短请求确认返回正文,再单独打图像接口,并把最终请求 URL 记进日志,一旦出现路径重复或打到错误域名,立刻能定位。Codex CLI 的配置文件和 SDK 的 base_url 最好共用同一套环境变量,避免两处各写各的。模型名以文档当前列表为准,示例名不要写死进生产配置;图像路径是否加 /v1,也请以文档图像章节为准,不要从对话基址类推。请问你这边用 Codex CLI 时,有没有遇到过配置看起来生效、实际请求仍打到默认官方地址的情况?是配置优先级的问题,还是环境变量没被进程读到?
广告广告位招商A10 · 帖子页正文下方通栏 · 760×90 · ¥300/月联系 ads@asibbs.com了解详情 →
登录 后参与回复,还没有账号?立即注册