用途:通过 Google Gemini API 生成和编辑图像,适用于文生图、基于现有图片的编辑与多轮迭代修图。使用前必须设置环境变量 GEMINI_API_KEY。
主要能力:默认模型为 gemini-3-pro-image-preview,默认分辨率 1K、默认宽高比 1:1;分辨率可选 1K、2K、4K,宽高比支持 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。支持传入已有图像进行编辑、通过 chat 多轮细化、最多 14 张参考图合成,以及结合 Google Search 接地生成基于实时数据的图像。除显式要求外应始终使用该 Pro 模型。
使用方式:安装依赖后用 Python 调用,核心为 client.models.generate_content,并在 config 中设置 response_modalities=['TEXT', 'IMAGE'];分辨率与宽高比通过 types.ImageConfig(aspect_ratio=..., image_size=...) 配置。生成结果遍历 response.parts,文本部分输出文本,图像部分用 part.as_image().save(...) 保存。编辑图片时将 PIL 打开的图像与文本 prompt 一同传入 contents。
限制与注意:Gemini API 默认返回 JPEG 格式,保存时务必使用 .jpg 扩展名,否则会出现“Image does not match media type”错误;如确需 PNG,需显式以 format="PNG" 保存。所有生成图像包含 SynthID 水印。仅输出图像(responseModalities 为 ["IMAGE"])的模式无法与 Google Search 接地配合使用。默认 1K 以提升速度,质量关键时再用 2K/4K。文中未提供该技能的具体收费、价格或平台支持信息。