用途：作为 product-shots 生态的图像生成引擎，提供单一参数化入口，根据模型家族把请求分发到正确端点（OpenAI 的 /v1/images/generations 与 /v1/images/edits，或 Gemini 的多模态 /v1/chat/completions），预处理参考图并返回磁盘文件路径。
主要能力：自动识别模型家族，调用方无需指定；未指定模型时默认 gemini-3-pro-image-preview；参考图发送前自动缩放到最长边 ≤1024px 且 ≤1MB；负向约束以“Avoid: …”追加到提示词；宽高比在 OpenAI 侧转为像素尺寸、在 Gemini 侧追加到提示词；输出始终落盘并返回路径；每次调用记录成本与 token；图生图对可重试错误最多重试 3 次（指数退避 1s/4s/16s），文生图不重试，401/403 快速失败。
使用方式：先配置网关密钥，解析顺序为 OMNIMAAS_API_KEY、PRODUCT_SHOTS_IMAGEGEN_API_KEY、RENDER_API_KEY、CANVASFLOW_IMAGEGEN_API_KEY，或 ~/.product_shots_imagegen_api_key 等文件。示例：export OMNIMAAS_API_KEY="sk-..."；bash scripts/setup.sh；python <skill-dir>/scripts/generate.py --prompt "..." --model gemini-3-pro-image-preview --output ./out.jpeg。密钥仅通过 Authorization: Bearer 头传输，不回显、不写日志。
适用场景：product-shots 生态内其他技能通过 shell 或 Python 导入调用，用于商品图等图像生成与编辑。
限制：需自备网关密钥，缺失时停止并提示配置；参考图超限需缩放；Gemini 忽略 --n/--size；小文字渲染应路由到 gpt-image-2；本地代理可能因 SOCKS 依赖报错，脚本已用 Session.trust_env = False 规避。具体价格与平台支持以资料所述为准，其余细节暂未提供。