用途:gpt-image2 是一个轻量级图像生成与编辑工作流技能,供 Codex 在需要配置 OpenAI 兼容图像 API 通道、生成或编辑图像时使用。它通过内置 Node.js CLI 完成操作,无 npm 依赖,支持 OpenAI 兼容的图像端点。
主要能力:支持文生图(POST /images/generations,JSON)与图像编辑。编辑有两种传输方式:默认 multipart 走官方风格 POST /images/edits 表单;generations 方式使用统一 JSON,图像以字符串数组传入,最多 5 张参考图,该模式不支持 --mask。提供提示词模板(列表、搜索、查看、试用)、尺寸查询(可按方向筛选)、配置管理(多通道 API key、base URL、模型名)、--dry-run 查看最终载荷、--curl 输出 curl 命令。
使用方式:在技能目录运行 node scripts/gpt-image2.mjs --help 与 node scripts/imgbb-upload.mjs --help。配置通道示例:node scripts/gpt-image2.mjs config set openai --api-key "$OPENAI_API_KEY" --base-url "https://ai-api.qzsyzn.com/v1" --model "gpt-image-2" --edit-transport generations,再用 config use openai 激活。生成示例:node scripts/gpt-image2.mjs generate --prompt "..." --size 1024x1024 --output outputs/lamp.png。编辑示例:node scripts/gpt-image2.mjs edit --image input.png --prompt "..." --output outputs/edited.png --edit-transport generations。generations 模式下本地文件默认自动上传 ImgBB(内置密钥,加密存储于 scripts/imgbb-upload.mjs),也可用 IMGBB_API_KEY 或 --imgbb-key 覆盖,或先运行 node scripts/imgbb-upload.mjs ./test/image.png 再以 URL 编辑。--embed-local-base64 仅在需要 data URL 时使用。
配置优先级:CLI 参数、配置文件活动通道、环境变量(GPT_IMAGE_API_KEY、OPENAI_API_KEY、API_KEY;GPT_IMAGE_BASE_URL、OPENAI_BASE_URL、BASE_URL;GPT_IMAGE2_EDIT_TRANSPORT;IMGBB_API_KEY)。配置文件默认 ~/.gpt-image2/config.json,可用 GPT_IMAGE2_CONFIG 覆盖。
限制与注意:API 调用失败时应报告 HTTP 状态与响应体,不要盲目重试;选择 --size 前先运行 sizes list;模板存于 references/prompts.json,使用 {{variable}} 占位符,避免真实私人人物姓名或肖像;密钥应放在配置或环境变量中,不要写入受版本控制的文件。具体收费、价格与平台支持范围资料未提供。