用途:通过 Google Gemini API 生成和编辑图像,默认使用 gemini-3-pro-image-preview(Pro)模型。使用前必须设置环境变量 GEMINI_API_KEY。默认参数为 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 grounding 基于实时数据生成图像(图像仅输出模式不能与搜索接地同用);输出模态通过 response_modalities=['TEXT','IMAGE'] 设置。
使用方式:用 genai.Client 初始化客户端,调用 client.models.generate_content,在 config 中通过 types.ImageConfig 设置 aspect_ratio 与 image_size;编辑时把 PIL 图像与文本提示一起传入 contents。
限制与注意:Gemini 默认返回 JPEG 格式,保存时务必使用 .jpg 扩展名,否则会出现图像与媒体类型不匹配的错误;如需 PNG 应显式指定 format="PNG",并可用 file 命令核对实际格式。所有生成图像均含 SynthID 水印。仅在明确要求时才使用其他模型,默认为 1K 分辨率以提升速度,质量关键时再用 2K/4K。编辑时用对话式描述修改,模型支持语义遮罩。其余收费、价格等信息暂未提供。