用途：使用 Google Gemini API 生成与编辑图像，适用于文生图、基于已有图片的编辑，以及多轮迭代精修。使用前必须设置环境变量 GEMINI_API_KEY。
主要能力：默认模型为 gemini-3-pro-image-preview，分辨率可选 1K（默认）、2K、4K；宽高比支持 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。支持传入文字提示与图片进行编辑，可通过 chat 实现多轮迭代修改。支持 Google Search 接地（基于实时数据生成图像），以及最多 14 张参考图合成。
使用方式：通过 google-genai 客户端调用 generate_content，设置 response_modalities 为 ['TEXT','IMAGE']；可用 types.ImageConfig 指定 aspect_ratio 与 image_size；编辑时在 contents 中同时传入提示和 PIL 图片；多轮精修使用 client.chats.create 并连续 send_message。
限制与注意：API 默认返回 JPEG 格式，保存时务必使用 .jpg 扩展名，否则会出现 media type 不匹配错误；如需 PNG 需额外转换；所有生成图像包含 SynthID 水印；仅图片模式（responseModalities: ["IMAGE"]）无法与 Google Search 接地同时使用；默认建议使用 1K 分辨率以提升速度，2K/4K 用于高质量场景。除明确要求外，应始终使用 Pro 模型。