img-gen

img-gen — 直接图像生成

通过进程环境变量读取 API key，直接发起 HTTP 请求生成/编辑图片。 不依赖 MCP 中间层，也不读取任何 .env 文件。

适用范围

• 用户要求生成图片（GPT-Image 2.5 / Nano Banana 2）
• 用户要求编辑已有图片
• gpt-icon-generate 等依赖生图能力的技能的下层实现

配置门禁（先读这一节）

技能只认进程环境变量。变量由宿主在启动时注入（DSH 启动时注入，见「环境配置」）， 技能自身不解析文件、不落盘、不缓存 token。

每次任务开始先跑：

python3 scripts/check_env.py        # 或 python3 scripts/img_gen.py check

• 两个 key 都是 ✗ → 停下，不要继续。 直接告诉用户缺哪个变量，并给出可复制的 export ...（或「启动 DSH 前注入」）做法，等用户补齐后再重跑本检查。 这一条优先于其它所有步骤：不要猜 key、不要去翻别人的配置文件、不要换 provider 硬试、不要因为「上次能用」就假设这次也有。
• 至少一个 ✓ → 继续，默认走 --preset auto。
• 只有 nano-banana 的 key 时，generate 仍可跑 Gemini 协议 preset（--preset 显式指定， 或 auto 链里只剩 banana 路线）。

计费模型与默认路线

路线	模型名	计费	定位
便宜路线	gpt-image-2.5-vip（别名 sunburst-vip）、-flare-vip、-sunburst-vip、gpt-image-2-vip	$0.03/张，按次；1K/2K/4K 与 quality 都不加价	日常唯一默认
贵路线	gpt-image-2.5-flare / -sunburst、gpt-image-2（无 -vip）	官转，按输出 token 计费，明显更贵	最后手段

规则：

1. 默认用 --preset auto（不写 --preset 即是 auto）。auto 只走 $0.03/张 的 -vip 路线，顺序为 apiyi → laozhang，同价互为备份。
2. 不要主动用贵路线。 贵路线 preset 标记为 tier=last_resort，只有两种入口： 显式写 preset 名，或 auto 加 --allow-expensive。CLI 命中时会打印 [!] LAST-RESORT ROUTE 警告。
3. 只有当所有 $0.03 路线都失败（配额不足、分组饱和、5xx、超时）时才考虑 --allow-expensive；用了必须在交付说明里写明「本次走了按 token 计费的官转路线」。
4. 参数写错（HTTP 400）不换路线重试——所有路线都会同样失败，直接改参数。

当前实测状态（2026-10-26）

• apiyi apiyi_gpt_image_2_5_vip（gpt-image-2.5-vip）实测可用： 1280×720 + low 生成 29.9 s，2048×1152 + low 编辑 29.8 s，1280×1280 + url 响应 39.6 s，返回尺寸与请求逐像素一致。
• 同一 key 当天早些时候曾报 403 配额不足 / insufficient_quota，随后恢复——说明该错误 是账号配额波动。auto 链遇到 403 会自动落到下一条同价路线，无需改配置。
• laozhang 网关在 02:11 可用（27 s 出图），02:20 起对本机 TLS 直接断连 （SSL: UNEXPECTED_EOF_WHILE_READING，openssl 握手同样被 reset）。这是 laozhang 侧 的可用性问题，不是技能代码问题；laozhang 的 -vip preset 仍保留为同价备份。
• 环境变量 IMG_GEN_GPT_IMAGE_2_OFFICIAL_PRESET 现为 apiyi_gpt_image_2_5_vip （$0.03/张）。

技能文件

所有脚本为技能自包含：

scripts/
├── img_gen.py              ← 统一 CLI（check / generate / edit），--preset auto 链路
├── check_env.py            ← 环境变量检测（缺变量时给出具体设置指引）
├── lib/
│   ├── presets.py          ← preset 目录 + tier/计费/quality/size 校验 + auto 链
│   ├── openai_images.py    ← OpenAI Images 协议（360 s 超时、url/b64 双兜底）
│   └── gemini_gen.py       ← Gemini generateContent 协议
└── presets/
    ├── gpt/    (20 个)     ← 每个 preset 一个 Python 封装
    └── banana/ (3 个)