用途:使用 Google Gemini API(Nano Banana Pro)生成和编辑图像,适用于由文本提示创建图像以及对已有图像进行编辑。运行前必须设置环境变量 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。支持传入现有图像进行编辑、通过聊天进行多轮细化迭代、最多 14 张参考图合成、以及结合 Google 搜索进行实时数据可视化。
使用方式:通过 Python 的 google-genai 客户端调用 client.models.generate_content,配置 response_modalities 为 ['TEXT', 'IMAGE'],并使用 types.ImageConfig 设置 aspect_ratio 与 image_size。编辑图像时在 contents 中同时传入提示与 PIL 打开的图片;多轮编辑可用 client.chats.create 创建会话后逐条 send_message。
限制与注意:Gemini 默认返回 JPEG 格式,保存时务必使用 .jpg 扩展名,否则会出现媒体类型不匹配错误;若需 PNG,需在保存时显式指定 format="PNG"。仅图像模式不能与 Google 搜索结合使用。所有生成图像包含 SynthID 水印。追求速度时用 1K,质量关键时用 2K/4K。
适用场景:照片级写实场景、风格化插画、图像内文字(如 logo)、产品效果图、基于实时数据的信息图,以及多参考图合成与对话式图像编辑。