用途：通过 Google Gemini API 生成和编辑图像，适用于文生图、图片编辑、风格化创作、产品效果图等场景。使用前必须设置环境变量 GEMINI_API_KEY。
主要能力：默认模型为 gemini-3-pro-image-preview，除非明确要求否则始终使用该 Pro 模型。默认分辨率 1K（可选 1K、2K、4K），默认宽高比 1:1，可选 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。支持传入现有图片进行编辑，支持通过 chat 多轮迭代修改，支持 Google 搜索接地生成实时数据图像，支持最多 14 张参考图合成。
使用方式：用 google.genai 客户端调用 client.models.generate_content，配置 response_modalities=['TEXT','IMAGE']；分辨率与宽高比通过 types.ImageConfig 的 image_size 和 aspect_ratio 设置。编辑时在 contents 中同时传入提示词与 PIL 图片对象。多轮优化使用 client.chats.create 并逐条 send_message。
限制与注意：Gemini 默认返回 JPEG 格式，保存时务必使用 .jpg 扩展名，否则会出现媒体类型不匹配错误；如需 PNG 需显式指定 format="PNG"。所有生成图像包含 SynthID 水印。仅图像模式（responseModalities: ["IMAGE"]）无法与 Google 搜索接地同时使用。默认 1K 以提升速度，质量关键时再用 2K/4K。编辑时用对话式描述修改即可，模型理解语义遮罩。提示词建议：写实场景注明镜头、光线、角度与氛围；风格化艺术明确风格；图中文字说明字体与位置；产品图描述布光与表面。