Codex imagegen2 生图Skill部署文档

API网关：https://api.new.bi/v1，密钥独立配置，使用文件/环境变量，不和原有环境变量冲突
默认模型：gpt‑image‑2，调用失败自动降级切换 gpt‑image‑2‑c

问题

在 Codex App对话框发送生成图片 / 画一张图 / 生图等指令，或通过/Image Gen系统入口发起请求时，Codex 有时错误输出 SVG、HTML、CSS、Mermaid、纯文字描述，期望直接输出真实 PNG/JPEG/WebP图片。

1. 安装codex

需要自行解决

2. Codex 客户端 Skill 使用教程

将以下完整提示词直接发送给Codex，自动修复部署生图skills：

帮我新建一个全局 Codex skill，名字叫 imagegen2，用来调用 OpenAI 兼容的图片接口。请先检查本机是否有 imagegen skill；如果有，就参考它的结构和脚本风格；如果没有，就直接按 Codex skill 标准创建 SKILL.md、agents/openai.yaml 和 scripts/imagegen2.py。

接口信息：
- 域名：https://api.new.bi
- 生图接口：/v1/images/generations
- 编辑接口：/v1/images/edits
- API key：当前环境的./codex/auth.json
- 默认模型：gpt-image-2
- 默认输出目录：output/imagegen2/

功能要求：
1. 支持 prompt 直接生图，对应 generations 接口。
2. 支持带参考图/编辑图的图片生成，对应 edits 接口。
3. 支持这些参数：
   - 张数 n：默认 1
   - 比例/尺寸：未指定、1:1、16:9、4:3、3:4、9:16
   - 清晰度：1K、2K、4K
   - 模型：gpt-image-2、gpt-image-1.5、gpt-image-1
   - 背景：自动背景、透明背景
   - 输出格式：PNG、WebP、JPEG
   - quality：low、medium、high、auto，默认 medium
4. 参数映射请自动处理：
   - 1:1 + 1K = 1024x1024
   - 16:9 + 1K = 1536x864 或兼容尺寸
   - 9:16 + 1K = 864x1536 或兼容尺寸
   - 2K、4K 也按对应比例推导到接口支持的尺寸。
   - 自动背景映射为 background=auto。
   - 透明背景映射为 background=transparent；如果 gpt-image-2 不支持透明背景，请自动切换到 gpt-image-1.5，或提示我确认。
   - PNG/WebP/JPEG 映射为 output_format=png/webp/jpeg。
5. 脚本优先读取 IMAGEGEN2_API_KEY 环境变量；如果环境变量为空，再使用我在上面填写的 API key。
6. 不要把具体 API key 输出到最终回复里。
7. 创建完成后，帮我分别跑一次纯文本生图和一次参考图/编辑图测试。
8. 测试主题用“小猫玩具，直播卖货风格”。
9. 最后把能打开的成功图片直接发给我，并告诉我 skill 安装路径。

3. API接口调用（可选）

图片生成与编辑接口文档
本文档说明如何使用本目录下的两个 Python 脚本调用 OpenAI 兼容图片接口。

基本配置

配置项	默认值
Base URL	`https://api.new.bi`
生图接口	`/v1/images/generations`
编辑接口	`/v1/images/edits`
模型	`gpt-image-2`

安装依赖

设置API Key

也可以每次运行时通过 --api-key 传入。

3.1 生图

脚本文件：generate_image.py

命令格式

示例

指定尺寸

指定质量

可选参数

参数	说明
prompt	图片提示词，必填
-o, --output	输出图片路径，默认 `generated.png`
--size	图片尺寸，默认 `1024x1024`
--quality	图片质量，可选 `low、medium、high、auto`
--background	背景，可选 `transparent、opaque、auto`
--model	模型名称，默认 `gpt-image-2`
--base-url	接口地址，默认 `https://api.new.bi`
--api-key	API Key，默认读取 `OPENAI_API_KEY`
--timeout	请求超时时间，默认 `300` 秒

3.2 编辑图片

脚本文件：edit_image.py

命令格式

示例：编辑刚生成的 generated.png

多张参考图

指定尺寸和质量

可选参数

参数	说明
prompt	编辑提示词，必填
-i, --image	输入图片路径，必填，可传多次
-o, --output	输出图片路径，默认 `edited.png`
--size	图片尺寸，默认 `1024x1024`
--quality	图片质量，可选 `low、medium、high、auto`
--background	背景，可选 `transparent、opaque、auto`
--model	模型名称，默认 `gpt-image-2`
--base-url	接口地址，默认 `https://api.new.bi`
--api-key	API Key，默认读取 `OPENAI_API_KEY`
--timeout	请求超时时间，默认 `300` 秒

3.3 常见错误

API Key 缺少sk- 前缀
错误：

Error: API key looks invalid: it should include the 'sk-' prefix.

解决：

401 Unauthorized
API Key无效、过期、填错或没有权限。
排查：

404 page not found
接口地址或路径不正确。
脚本自动拼接：

https://api.new.bi → https://api.new.bi/v1/images/generations

https://api.new.bi → https://api.new.bi/v1/images/edits

--base-url 两种写法都兼容：

请求超时
生图耗时较长，调大超时时间

3.4 编辑图片示例代码（可选）

3.5 生成图片示例代码（可选）

3.6 HTTP直接调用示例（可选）

适用于开发者对接生图能力

生图接口：https://api.new.bi/v1/images/generations
编辑图片接口：https://api.new.bi/v1/images/edits

请求方式：POST

请求头

JSON请求体

{
  "model": "gpt-image-2",
  "prompt": "a futuristic cyberpunk city at night, ultra detailed",
  "size": "1024x1024"
}

超时设置：300s

Codex 接入gpt-image-2/2.5 生图 Skill 部署文档教程

Codex imagegen2 生图Skill部署文档#

问题#

1. 安装codex#

2. Codex 客户端 Skill 使用教程#

3. API接口调用（可选）#

基本配置#

3.1 生图#

3.2 编辑图片#

3.3 常见错误#

3.4 编辑图片示例代码（可选）#

3.5 生成图片示例代码（可选）#

3.6 HTTP直接调用示例（可选）#