【教程】超简单！在 Codex 里调用第三方 API 生图的快速实现方法

简单聊聊#

最近 GPT Image 2.5 发布后，我也试着接入第三方 API 生图，却发现配置过程比想象中复杂。所以我做了这个方便自己随时切换 API、直接在 Codex 里生图的 Skill，也分享给想尝试的朋友。

为什么我想把生图放进 Codex#

平时使用第三方图片服务，往往要先看接口文档、拼请求参数、处理返回的图片，再手动保存文件。不同服务商的模型、价格和接口地址也不一样；想换一个服务时，又要重新研究一遍流程。

我做的 Codex Image2 Skill，就是把这段重复工作整理成一个固定流程。它会读取你自己保存在本机的 API 配置，让 Codex 根据你的文字需求或参考图调用兼容接口，生成后直接把图片保存到本机，并在对话中预览。它不是免费的图片服务，也不会替你提供 API Key；你仍然需要选择服务商并承担该服务商的调用费用。

先让 Codex 安装 Codex Image2#

这个 Skill 的项目主页在 GitHub，也可以直接从 Release 下载 ZIP 安装包。如果你的 Codex 已经连接 GitHub，最简单的方式是直接告诉它：

1
请根据这个 GitHub 项目帮我安装 Codex Image2 Skill：
2
https://github.com/zhuya624-cell/codex-image2

安装完成后，它会知道这个 Skill 能做什么；之后你只要用自然语言描述想要的画面，Codex 会协助组织提示词和调用命令。

如果想手动安装，也可以下载上面的 ZIP，解压后将 codex-image2 文件夹放进本机的 ~/.codex/skills/ 目录，再重新打开 Codex。重点是保留 Skill 内的 SKILL.md 和 scripts 文件夹；不要只复制其中一个脚本，否则 Codex 无法正确识别它。

只配置三项自己的 API 信息#

安装并不等于已经可以生图。第三方 API 的信息需要由你自己在本机填写，配置文件位于：

1
~/.config/codex-image2/.env

里面只需要三项：

1
API_URL=服务商提供的 API 地址
2
IMAGE_API_KEY=你的图片 API Key
3
IMAGE_API_MODEL=服务商提供的图片模型名称

这里的 API 可以理解为服务商提供给程序使用的通道；API_URL 决定请求发往哪里，IMAGE_API_KEY 用于验证你的账户，IMAGE_API_MODEL 则决定使用哪个模型。这个 Skill 采用兼容 OpenAI Images API 格式的请求，因此服务商需要支持图片生成或编辑接口，并且返回标准的图片 URL 或 Base64 图片数据。

**API Key 只应该存在你的本机 .env 文件中。**不要把它放进 GitHub、博客文章、截图或聊天记录；截图配置页面时，请务必将密钥完整打码。如果怀疑泄露，应立即到服务商后台删除旧 Key 并重新创建。

先用 dry-run 检查，不会产生费用#

配置后不要马上生成复杂图片。先在 macOS 的 Terminal 运行一次 dry-run：

1
~/.codex/skills/codex-image2/scripts/run-image2.sh generate --prompt "configuration check" --dry-run

CLI 是 Command Line Interface 的缩写，也就是在终端输入命令来操作程序。这里不需要记住所有参数，Codex 平时会代为调用；但理解它能帮助你检查问题。dry-run 不会真正请求生图，也不会消耗额度，它只会确认 Skill 是否读到了 API_URL、IMAGE_API_KEY 和 IMAGE_API_MODEL，并显示最终会调用的接口地址与模型名。

如果结果含有 "dry_run": true，且地址、模型名都正确，就可以继续。出现 API_URL is not set 等提示时，先检查 .env 的文件位置、变量拼写和是否保存成功。请注意：这一步不能验证 API Key 是否有效、账户是否有余额或模型是否有权限；这些只能通过一次真实请求确认。

我推荐使用 参考图编辑功能。你可以上传一张人物、宠物或插画作为参考，再说明新场景。例如我用小金毛卡通图作为参考，让它创作“小金毛穿着宇航服在太空玩耍”。这类需求使用 edit，每一张参考图对应一次 --image 参数。参考图能帮助模型延续角色、配色或画风，但不代表每次都能完全一致，仍要检查最终结果。

它也提供 generate-batch，可读取 JSONL 文件后批量处理多条独立提示词。也就是可以一次性生成多个图片，这个能力比较适合准备多篇文章的配图、探索商品图方向或制作素材，建议第一次先从单张文生图和参考图编辑开始，确认模型、成本和提示词风格都符合预期后再批量执行。

推荐使用的理由#

第三方 API 的优势是可以自由选择服务商、模型与价格方案；Skill 的价值则在于把配置、提示词整理、命令执行和图片输出连接起来。以后想更换服务商时，只需更新 .env 中的三项值，再重新运行一次 dry-run，无需重装 Skill。

对于不想每次对着接口文档研究参数的人，这是一种很顺手的工作方式。它适合做博客封面、文章插图和参考图的延展创作。不过生成图片前仍要确认服务商的价格、内容政策与商用授权；尤其是涉及人物参考图、品牌素材和商业用途时，不要忽略版权与平台规则。