Codex 使用官方 Image Gen Skill 接入胜算云 API

这篇文章教你如何在 Codex 中通过官方 Image Gen Skill 调用胜算云的 gpt-image-2 模型，完成文生图和图片编辑。

一句话总结： 在项目里创建一个配置文件，写上胜算云 API 地址和密钥 → 重启 Codex → 在对话中用 CLI 模式让 Image Gen Skill 调用胜算云模型生图。

1. 前置准备

开始前，请确认：

已安装并打开 Codex；
已从胜算云个人控制台获取 API Key；

2. 编辑配置文件

2.1 方法一：Codex 自动完成（推荐）

不需要手动创建文件夹和文件，使用Codex 自动创建 .codex 文件夹和 config.toml 文件并编辑。在需要使用生图功能的Codex项目对话框中发送以下内容：

在这个项目中找到.codex文件，没有就自己创建
找到 .codex/config.toml 文件，没有config.toml也自己创建一个
在.codex/config.toml 里写入以下内容，注意如果文件里已经有 [shell_environment_policy.set]：直接在下面追加两个变量即可，不要重复写这个表头。
[shell_environment_policy.set]
OPENAI_BASE_URL = "https://router.shengsuanyun.com/api/v1"
OPENAI_API_KEY = "请填写胜算云 API Key"
然后给我打开config.toml文件，我来填写胜算云API Key

Codex会创建config.toml文件，在Codex中点击打开，将自己的胜算云 API Key 粘贴到对应位置即可（前往胜算云个人控制台获取）。

2.2 方法二：手动编辑

2.2.1 创建配置文件

在需要使用生图功能的项目根目录下（就是 Codex 打开的那个文件夹）下创建配置文件。

macOS ：按住 option 键+右键点击文件夹，菜单里会出现「拷贝“xx”作为路径名称」，点击复制。打开一个新终端并发送：

cd 你的项目路径
mkdir -p .codex
touch .codex/config.toml

Window：在项目根目录新建一个文件夹，命名 .codex，然后在里面新建一个文本文件，改名为 config.toml（注意把 .txt 后缀去掉）。

2.2.2 写入配置内容

把下面这段内容粘贴到 config.toml 文件里，把「你的胜算云 API Key」替换成你自己的密钥（（前往胜算云个人控制台获取）：

[shell_environment_policy.set]
OPENAI_BASE_URL = "https://router.shengsuanyun.com/api/v1"
OPENAI_API_KEY = "你的胜算云 API Key"

具体操作：

macOS ：在终端发送： open -e .codex/config.toml，会用「文本编辑」打开文件，把上面内容粘贴进去，Cmd + S 保存；
Window：右键 config.toml，打开方式选择「记事本」，把上面的内容粘贴进去，Ctrl + S 保存。

注意：打开文件如果发现文件里已经有 [shell_environment_policy.set] 这一行，就不要重复写入，直接在下面追加下面两行变量即可。

3. 保护 API Key

配置文件里写了你的 API Key，千万不要提交到公开的代码仓库。可以在 Codex 对话框中说：

帮我把 .codex/config.toml 加到 .gitignore 里

如果你希望这个配置对所有项目生效，也可以让 Codex 把相同内容写到 ~/.codex/config.toml（用户级全局配置）。

4. 重启 Codex

保存配置文件后，关闭并重新打开 Codex 项目，让环境变量生效。

Codex 只会加载受信任项目中的 .codex/config.toml。如果首次打开项目时弹出信任提示，请确认信任该项目。

5. 开始生图（文生图）

Codex 有两种生图方式：

内置生图模式：走 Codex 自己的后端，不会读取你配置的胜算云 API Key；
Image Gen Skill 的 CLI 模式：运行 Python 脚本调用 OpenAI SDK，会读取你配置的环境变量，从而走胜算云。

所以必须在提示词中明确写"/Image Gen 使用 CLI 模式"官方生图skill，否则不会走胜算云。如：

6. 图生图

把要编辑的图片拖入 Codex 对话框，然后输入你的提示词，如：

7. 如何确认接入成功？

如果执行信息中出现以下内容，说明接入成功：

命令中看到 image_gen；
模型显示为 gpt-image-2；
图片保存到了 output/imagegen/ 目录。

8. 常见问题

8.1 配置后没有走胜算云？

检查提示词中是否明确写了 "使用 Image Gen Skill 的 CLI 模式"。如果只说"帮我生成一张图片"，Codex 会用内置模式，不会走胜算云。另外确认已重启 Codex 且项目为受信任状态。

8.2 报 401 或 403 错误？

API Key 是否从胜算云控制台正确复制（注意不要有多余空格）；
账号是否有调用 gpt-image-2 的权限。

8.3 报 404 错误？

Base URL 是否只写到了 /api/v1？不要在末尾加 /images/generations 或 /images/edits。

8.4 提示缺少 OpenAI SDK？

CLI 模式依赖 OpenAI Python SDK。如果提示缺少 openai，让 Codex 在当前环境中安装后重试即可。

8.5 如何调整图片质量？

gpt-image-2 支持 low、medium、high 三档。快速试稿用 low，正式出图用 high。在提示词中说明即可。