Codex 配置教程：使用 NewAPI 调用 GPT Image 2

约 1571 字大约 5 分钟

Codex GPT Image 2 NewAPI

2026-08-27

这篇教程面向不熟悉终端和代码的用户。你只需要把提示词发给 Codex，再按提示提供 API Key，后面的文件创建、配置和测试都交给 Codex 完成。

先确认

本文使用的 gpt-api.jiaohaohao.xyz 是第三方中转服务，不是 OpenAI 官方服务。请确认你的账户中已经有可用的图片模型和 API Key。不要把 API Key 发到公开群聊、评论区或 GitHub。

第一步：打开 Codex

请使用你自己的 Codex 桌面应用、CLI 或 IDE 扩展，并确保它可以操作本机文件。不要在公开聊天中执行下面的操作。

第二步：复制这段提示词，发送给 Codex

请完整复制下面的内容，一次性发送：

请直接帮我在这台 Mac 上配置并测试一个全局可复用的 NewAPI 图片生成 Skill，不要只给教程。

我的目标是：以后我说“生成图片、画一张图、制作海报、编辑图片、修改背景、扩图、重绘或局部修改”时，优先使用这个 Skill 调用 NewAPI 图片接口。

请完成以下工作：

1. 创建或更新全局 Skill：
   ~/.codex/skills/newapi-image-gen/SKILL.md

2. 创建或更新执行脚本：
   ~/.codex/skills/newapi-image-gen/scripts/newapi_image_gen.py

3. 使用下面的 NewAPI 配置：
   - API 根地址：https://gpt-api.jiaohaohao.xyz/v1
   - 默认模型：gpt-image-2
   - 生成接口：/v1/images/generations
   - 编辑接口：/v1/images/edits

4. API Key 安全处理：
   - 下一条消息会提供 API Key，请只把它写入 macOS Keychain；
   - Keychain 服务名使用 codex-newapi-image-key；
   - 不要在回复、日志、脚本、Skill、配置文件或 Git 中显示或保存完整 Key；
   - 不要把 Key 写入 ~/.zshrc；
   - 如果无法安全保存，请停止并告诉我原因，不要把 Key 写进代码。

5. 脚本至少支持：
   - 生成图片和编辑图片；
   - prompt、model、size、quality、background、output、输入图片和 mask；
   - 默认模型 gpt-image-2；
   - 默认把图片保存到当前工作区的 generated_images/；
   - 支持接口返回 b64_json 或 url；
   - 自动检查真实图片格式、文件大小和尺寸；
   - 文件重名时不要覆盖旧文件；
   - 错误信息中不得出现 API Key 或完整 Base64。

6. 重要限制：
   - 图片生成只能调用 /v1/images/generations；
   - 图片编辑只能调用 /v1/images/edits；
   - 不要使用 /v1/chat/completions 或 /v1/responses 生成图片；
   - 不要重复拼接 /v1/v1；
   - Skill 只能优先匹配图片任务，不能强制覆盖系统级工具规则；
   - 如果接口返回 JPEG 或 WebP，不要只改文件名伪装成 PNG。

7. 请先检查系统是否为 macOS、Skill 文件和 Python 脚本是否可用，再进行测试。

8. API Key 安全保存后，立即使用下面的描述测试生成一张图片：
   一只可爱的小猫，坐在柔软的米色毯子上，温暖自然光，写实摄影风格，清晰细腻的毛发和眼睛，正面看向镜头

   测试结果保存为本地图片，不覆盖已有文件，并使用当前环境的图片查看能力展示。

9. 最终只报告：
   - Skill 路径；
   - 脚本路径；
   - 测试是否成功；
   - 图片绝对路径、真实格式、尺寸和文件大小；
   - 不要报告 API Key。

第三步：把 API Key 单独发给 Codex

发送完上面的提示词后，再发送一条新消息，只放你的 API Key。示例：

这是我的 NewAPI Key，请按照上一条要求安全保存到 macOS Keychain，不要在回复中重复显示：
粘贴你的真实 API Key

只在自己的 Codex 私人会话中发送，不要把真实 Key 放进本文、截图、公开仓库或群聊。Codex 不应该把完整 Key 回显出来；如果它要求把 Key 写进 Python 或配置文件，请拒绝并让它改用 Keychain。

第四步：等待 Codex 完成

Codex 会自动完成以下工作：

创建 Skill 和图片脚本；
保存 API Key；
调用 gpt-image-2 生成测试图片；
将图片保存到当前工作区的 generated_images/；
展示图片并报告文件信息。

你不需要手动创建文件，也不需要自己输入接口地址。

第五步：以后如何使用

配置成功后，直接告诉 Codex 你想要什么，例如：

生成一张雨后广州街道的写实图片，横向构图，蓝绿色调。

编辑本地图片时，告诉 Codex 图片的绝对路径：

编辑 /Users/你的用户名/Pictures/input.png，把背景改成春日公园。

如果 Codex 没有自动使用这个 Skill，可以明确指定：

$newapi-image-gen 生成一张简洁的科技风海报，深蓝色背景。

如果配置失败怎么办？

把 Codex 显示的错误原文发回给它，但先遮住 API Key。常见情况如下：

提示	说明
`model_not_found`	中转站没有开放 `gpt-image-2`，需要查看模型列表
`no available channel`	当前模型没有可用上游渠道
`401` 或 `403`	API Key 无效或没有图片权限
`余额不足` 或 `quota`	账户额度不足
`404`	接口地址可能写错，检查是否出现 `/v1/v1`
请求超时	图片生成较慢，或中转站、Cloudflare、源站的超时设置较短

如果只有生成成功、编辑失败，通常表示中转站暂时没有实现 /v1/images/edits。这时不要把“编辑”偷偷改成“重新生成”，应先确认服务商是否支持图片编辑。

安全提醒

API Key 相当于账户密码，泄露后应立即吊销并重新创建。
第三方中转服务可能看到你的提示词和上传图片，不要上传身份证件、私密照片或未脱敏资料。
不要把 generated_images/ 中的私人图片自动提交到 Git。
模型和接口可用性会变化，升级配置后先用一张普通图片小额测试。

本文中的接口和模型名称参考 OpenAI GPT Image 2 文档及图片生成指南；中转站是否完整兼容这些能力，以实际测试结果为准。