用途：通过 Google Gemini API 生成和编辑图像，支持文生图、图像编辑、多轮细化，以及由多张参考图合成画面。使用前需设置 GEMINI_API_KEY 环境变量。
主要能力：默认模型为 gemini-3-pro-image-preview；分辨率可选 1K、2K、4K，默认 1K；宽高比支持 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9，默认 1:1。支持 Google 搜索接地（生成信息图等），以及最多 14 张参考图合成。
使用方式：提供 CLI 脚本，例如 python scripts/generate_image.py "A cat in space" output.jpg，可用 --aspect 16:9 --size 2K 指定比例与分辨率；编辑用 python scripts/edit_image.py input.jpg "Add a rainbow" output.jpg。也可直接调用 API：client.models.generate_content，配置 response_modalities=['TEXT','IMAGE']，通过 types.ImageConfig 设置 aspect_ratio 与 image_size。多轮细化用 client.chats.create 后连续 send_message。
适用场景：照片写实、风格化插画、含文字 Logo、产品效果图，以及需要保持同一场景一致性的多图系列（如房间改造、产品变体、前后对比）。
限制与注意：Gemini 默认返回 JPEG，保存时务必使用 .jpg 扩展名，否则会报 "Image does not match media type" 错误；如需 PNG 须显式指定 format="PNG" 转换。所有生成图像包含 SynthID 水印。纯图像模式不支持 Google 搜索接地。多图一致性需锁定建筑结构描述、仅改变风格部分。默认 1K 以提升速度，质量关键时再用 2K/4K。