技能介绍

要解决的问题

调用 OpenAI 兼容的图片接口时，两个需求常常被拆散：生成新图和改一张已有的图。前者通常只能选 t2i 类模型，后者又要求另一个只支持编辑的模型名；代理网关一换，参数约定也随之变化。更实际的问题是尺寸：多数编辑接口不管你传什么，输出一律标准化成 1024x1024，想把 logo 的透明背景换成白色、又保持版面不动，就得再裁一次。

这个技能把两件事收进同一个脚本：底层模型固定为 qwen-image-2.0，文生图与图片编辑共用 https://www.omniboxai.cn/v1/images/generations 这一个地址，不需要在模型名之间切换。

工作方式

入口是 ~/.workbuddy/skills/zhwx-image/zhwx_image.py，通过 --mode 区分两条路径：

文生图：--mode t2i，传 --prompt，尺寸默认 1024x1024，也可用 --size WxH 指定。
图片编辑：--mode edit，额外传 --image 指向本地文件。脚本读取图片后以 data:image/;base64,... 内联，不需要图床或上传步骤。

编辑模式下 --size 默认 auto：脚本先用 Pillow 量出输入图的宽高并回传给模型，因此 750x502 的输入会得到 750x502 的输出；显式传 --size 时才按指定尺寸出图。响应可能只给 url，也可能只给 b64_json，脚本两种都处理：优先 base64，否则下载 URL，最后统一落盘为本地 PNG，默认路径 ./zhwx_image_out.png。--n 控制生成数量。

API Key 按 环境变量 ZHWX_API_KEY > --key 指定文件 > 默认项目密钥文件的优先级查找。默认文件不存在或内容为空时，脚本会提示前往 https://www.omniboxai.cn/ 注册申请，而不是直接抛栈。

适用边界

gpt-image-2 在该代理上只用于图片编辑，拿它跑纯文生图会收到 500 image is required；文生图请用 qwen-image-2.0。
edit 模式若既不传 --size 也不走脚本的 auto，模型会把输出归一化成 1024x1024。依赖 auto 尺寸时需要 Pillow；托管 Python 已自带，缺失时脚本会回退到固定尺寸。
运行环境写定为托管 Python（3.13.12），t2i 模式不依赖 Pillow。