用 Codex 生成图片（gpt-image-2）

Codex 支持通过安装 tokenflows-image 技能来使用 gpt-image-2 模型生成或编辑图片。安装后在 Codex 里输入 /tokenflows-image 即可调用，支持文生图（按文字描述出图）和图生图（改一张已有的图）。

前置条件

  • Codex：已安装 Codex App 或 Codex CLI。
  • API Key：在 TokenFlows 控制台 获取一个 API Key。

费用说明

通过 TokenFlows 使用 gpt-image-2，每生成一张图片计费 $0.3，按次从额度中扣除。

⚠️ 风险提示：Agent 在生成图片后会自行检查结果，如果觉得不合适，可能会自动发起多次请求来重新生成。所以你可能会看到使用记录中有多条调用。如果你需要严格控制每次只调用一次，建议直接通过 TokenFlows API /images/generations 接口手动调用，或通过 prompt 增强控制。

快速安装（AI 自动配置）

不想手动操作？把下面这句话复制给 Codex，它会读取本教程并自动完成安装：

请完成 tokenflows-image 技能的安装：
1. 从 https://tokenflows.org/skills/tokenflows-image.zip 下载压缩包，解压到 ~/.codex/skills/ 目录，确保解压后得到 ~/.codex/skills/tokenflows-image/SKILL.md 和 ~/.codex/skills/tokenflows-image/scripts/ 下的 openai-image.sh 和 openai-image.ps1
2. 在 ~/.codex/.env 中写入：
   base_url=https://api.tokenflows.org/v1
   api_key=sk-xxx
3. api_key 先留占位 sk-xxx，最后提醒我换成自己的密钥

手动安装

1. 下载并解压技能包

从以下地址下载技能压缩包：

下载后将其解压到 ~/.codex/skills/ 目录。完成后目录结构如下：

~/.codex/skills/tokenflows-image/
├── SKILL.md              # 技能说明
└── scripts/
    ├── openai-image.sh   # macOS / Linux 脚本
    └── openai-image.ps1  # Windows 脚本

~ 代表你的用户主目录，.codex 是隐藏文件夹。Mac 可在访达按 Command + Shift + G 输入 ~/.codex 进入；Windows 在资源管理器地址栏输入 %USERPROFILE%\.codex 进入。

2. 配置接口地址和密钥

在 ~/.codex/.env 中写入：

base_url=https://api.tokenflows.org
api_key=sk-你的密钥

将 sk-你的密钥 替换为你在 TokenFlows 控制台 创建的 API Key。如果文件里已有 http_proxy 等代理设置，保留即可。

使用

在 Codex 中输入 /image，选择 tokenflows-image 技能，然后描述你想要的图片，例如：

画一只戴贝雷帽、坐在木桌上的小水獭，柔和光线

调用方式

技能内置的脚本支持两种模式：

文生图（generate）： 根据文字描述直接生成图片。

bash ~/.codex/skills/tokenflows-image/scripts/openai-image.sh generate \
  --prompt "一只戴贝雷帽、坐在木桌上的小水獭，柔和光线" \
  --size 1024x1024 --out ./otter.png

图生图 / 编辑（edit）： 传入已有图片进行修改。

bash ~/.codex/skills/tokenflows-image/scripts/openai-image.sh edit \
  --prompt "把背景换成下雪的雪山" \
  --image ./otter.png --out ./otter-snow.png

常用参数：

参数说明
--prompt图像描述（必填）
--model默认 gpt-image-2
--size分辨率：1024x1024、1536x1024（横）、1024x1536（竖）、auto
--n生成数量，默认 1
--out保存路径，默认 image-时间戳.png

接口参考

接口方法用途关键参数
/images/generationsPOST (JSON)文生图model prompt n size quality
/images/editsPOST (multipart)图生图 / 编辑image[]（必填，可多张）prompt mask n size

要点：

  • gpt-image-2 返回 Base64 格式，脚本自动解码为图片文件。
  • mask 是可选掩码 PNG（透明区域表示重绘位置），仅用于局部修改。

常见问题

  • 报错”未找到 base_url 或 api_key” → 检查 ~/.codex/.env 是否包含正确的接口地址和密钥。
  • 接口报错（余额不足 / 鉴权失败） → 检查 API Key 是否有效、账户余额是否充足。
  • 保存出 0B 文件 → 确认接口地址正确，网络连接正常。
  • 换模型 → 加 --model 模型名。