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. 自检
先打开文档核对模型名和路径,再用上面的短脚本打对话接口。返回正文后,再单独试图像接口。三处地址各司其职:兼容基址、图像、文档。
三个官方地址请原样使用,不要自行拼接路径:
文档: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. 自检
先打开文档核对模型名和路径,再用上面的短脚本打对话接口。返回正文后,再单独试图像接口。三处地址各司其职:兼容基址、图像、文档。