GPT-Image-2 快速生成器

要解决什么问题

在 Agent 或对话里生图时，常见痛点是：密钥写进脚本、生成和保存拆成多步、以及还没调用就先跑一遍模型列表。这个技能面向 OpenAI 兼容网关上的 gpt-image-2，目标是让你在 shell 里用一次 python -c 完成「请求 → 解码 b64_json → 写 PNG」，并把凭证统一放在环境变量里复用。

技能如何工作

凭证：只从 GPT_IMAGE_API_KEY、GPT_IMAGE_BASE_URL 读取；未设置时向用户索取，用 export 写入当前会话，后续命令不再重复问。

生成路径：优先直接 POST /images/generations；只有失败（例如 400 模型不支持）时，才查 /v1/models 排查，且必须与生成接口使用同一 gateway 与同一组凭证。

尺寸：格式 {宽}x{高}，范围 768×768～3840×3840，宽高均需能被 16 整除（如 1024x1024、1536x1024）。

输出约定：默认保存为当前目录 gpt_image_2.png；成功时在 stdout 打印 SUCCESS:文件名，便于程序判断；展示给用户时用 present_files。

依赖仅为 Python 标准库（urllib、ssl、base64、pathlib 等），无第三方包。

边界与注意点

• 401：核对 Key 与 Base URL 是否同一套配置，export 后可用 echo 验证。
• 超时：模型可能较慢，建议约 180 秒，可重试一次；insufficient balance 属于账户额度，不是接口 bug。
• 证书问题：优先查系统证书链、代理与网络，不要通过跳过 SSL 校验规避。
• 文档与示例中不保存真实密钥；b64_json 不要在对话里二次传递，应在同一段 python -c 内解码落盘。