智盒万象生图 / 图片编辑（gpt-image-2.5-sunburst）
统一封装智盒万象代理的 OpenAI 兼容图片接口，底层模型固定为 gpt-image-2.5-sunburst，同时支持文生图和图片编辑两种模式。
- 接口：
https://www.omniboxai.cn/v1/images/generations（OpenAI 兼容） - 模型：
gpt-image-2.5-sunburst（2026-09-24 基于 zhwx-image 拆分出的 GPT 版；实测文生图 / 图片编辑均正常出图） - 响应：标准
{data:[{url|b64_json}]}，脚本自动下载/解码保存为本地 PNG。
> 与 qwen 版（zhwx-image，默认 qwen-image-3.0-pro）的区别：本技能默认走 GPT 模型 gpt-image-2.5-sunburst。两套技能并存，按需选用。
何时使用
- 用户要「生成一张图」→ 文生图模式
- 用户要「改这张图 / 在图上加个东西 / 换背景」→ 图片编辑模式
- 用户指定用智盒万象 / gpt-image / GPT 生图
用法
脚本：~/.workbuddy/skills/zhwx-image-qj/zhwx_image_qj.py（Python）
> 运行环境：编辑模式 auto 尺寸需要 Pillow。请用带 Pillow 的托管 venv 运行：
> C:\Users\wzx\.workbuddy\binaries\python\envs\default\Scripts\python.exe zhwx_image_qj.py ...
> 直接用托管 python.exe（无 Pillow）也能跑，但 auto 尺寸会回退 1024x1024。
文生图：
python zhwx_image_qj.py --mode t2i --prompt "写实摄影，夏日校园草坪上一群大学生欢笑奔跑，佳能5D4，胶片质感" --output out.png
图片编辑（在输入图上改/加元素）：
python zhwx_image_qj.py --mode edit --image input.jpg --prompt "在左边石碑上坐一个大学女生在看书" --output edited.png
> edit 模式 --size 默认 auto：自动读取输入图尺寸并回传给模型，保证输出与原图同尺寸（实测可精确还原原尺寸）。如需其他尺寸可显式 --size 1024x1024。
参数
| 参数 | 说明 |
|---|---|
--mode |
t2i（文生图）或 edit（图片编辑），必填 |
--prompt |
描述，必填，中英文均可 |
--image |
edit 模式必填，输入图片路径（本地文件，自动 base64） |
--output |
输出 PNG 路径，默认 ./zhwx_image_qj_out.png |
--size |
WxH；t2i 默认 1024x1024，edit 默认 auto（沿用原图尺寸） |
--n |
生成数量，默认 1 |
--model |
模型名，默认 gpt-image-2.5-sunburst（可临时切其他模型） |
--key |
API Key 文件路径，默认读项目密钥 D:\公司\AI聚合平台\AI工作区\.secrets\zhwxkey.txt |
API Key 优先级：环境变量 ZHWX_API_KEY > --key 文件 > 默认项目密钥文件。
首次使用找不到 Key 的处理：脚本在以下两种情况会自动提示用户去注册并申请 API Key，而不会直接崩溃式报错：
1. 默认密钥文件 D:\公司\AI聚合平台\AI工作区\.secrets\zhwxkey.txt 不存在（也未设环境变量 / --key）；
2. 密钥文件存在但内容为空。
提示文案包含注册地址 https://www.omniboxai.cn/，引导用户先注册申请 Key，再写入文件（或设 ZHWX_API_KEY、用 --key 指定）后重试。
关键约定 / 踩坑（已实测）
gpt-image-2.5-sunburst同时支持文生图（不传 image）和图片编辑（传 image），两种模式共用同一接口同一模型，无需切换模型名（2026-09-24 实测两种模式均正常出图，1024x1024 约 1~1.6MB PNG）。注意：旧版gpt-image-2在此代理上是「图片编辑」专用，纯文生图会报500 image is required——本模型已无此限制。- 编辑模式尺寸：模型默认把输出标准化成 1024x1024（不传 size 时），会破坏「不改原图大小」的诉求。务必在 edit 模式传
--size或依赖脚本的auto（读原图尺寸回传），实测可精确还原原尺寸。 - 输入图以
data:image/<mime>;base64,...内联，无需图床/上传。 - 响应可能同时返回
url和b64_json，脚本两种都兼容；优先用 b64，否则下载 url。 - 文生图尺寸：模型仅支持标准规格，
--size用1024x1024、512x512、1536x1024这类标准值会被严格遵守；传非标准值（如768x512）模型会自动吸附到最近的规格（实测 768x512 → 约 1523x1032），属模型行为而非脚本 bug。edit模式auto读取的是源图真实像素尺寸并原样回传，可稳定保留原尺寸。
运行环境
- 推荐用带 Pillow 的托管 venv：
C:\Users\wzx\.workbuddy\binaries\python\envs\default\Scripts\python.exe - 编辑模式
auto尺寸需要 Pillow（venv 已装 12.3.0）；无 Pillow 时 edit 回退 1024x1024。
