用途:借助 Google Gemini 生成与编辑图像,通过 scripts/ 下的 Python 脚本调用。模型按提示词复杂度自动选择:Nano Banana Pro(gemini-3-pro-image-preview)用于复杂或高质量请求,Nano Banana 2(gemini-3.1-flash-image-preview)用于简单轻量请求。当指定 --pro、提示词含质量关键词(如 professional、photorealistic)、提示词超过 100 字符、输入图 2 张及以上、要求 4K 分辨率或启用 Google 搜索接地时,自动选用 Pro。
主要能力:文生图与图像编辑(最多 14 张参考图),支持宽高比(1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9)与分辨率(1K、2K、4K),可用 Google 搜索接地提升真实场景准确性,支持 JSON 输出与批量生成。
使用方式:先安装依赖 pip install google-genai Pillow。凭证二选一:设置 GEMINI_API_KEY(密钥在 https://aistudio.google.com/apikey 获取),或使用 Vertex AI 设置 GOOGLE_CLOUD_PROJECT 与可选 GOOGLE_CLOUD_LOCATION,需启用 Vertex AI API 并配置应用默认凭证(gcloud auth application-default login)。两者同时设置时优先 Vertex AI。可选变量:NANOBANANA_MODEL、IMAGE_OUTPUT_DIR(默认 ./nanobanana-images)、NANOBANANA_NO_SSL_VERIFY。
生成示例:python scripts/generate.py "a cute robot mascot, pixel art style" -o robot.png;编辑示例:python scripts/generate.py "make the sky purple and add stars" -i photo.jpg -o edited.png;多参考图可重复 -i。批量:python scripts/batch_generate.py "pixel art logo" -n 20 -d ./logos -p logo。
适用场景:图标、头像、产品图、横幅、壁纸、书籍封面等图像生成与编辑需求。
限制:需自备 Google Gemini 或 Vertex AI 凭证,可能受 API 速率限制;内容会被安全过滤拦截;SSL 验证失败可用 --no-ssl-verify 或 NANOBANANA_NO_SSL_VERIFY=1 关闭。其他细节暂未提供。