零依赖 Gemini 图像生成工具,纯 Python 标准库实现,无需 pip/uv 即可在受限环境中运行。
说明:
:支持 Nano Banana Pro 全功能,包括图像生成与图像编辑
4. **多模型可选**:内置 Imagen 4.0 Ultra、Gemini 2.5 Flash Image 等模型切换选项
## 潜在局限
– 功能接口较为底层,缺乏高级参数控制(如分辨率、采样步数等精细调节)
– 错误处理相对简单,API 限流或网络异常时容错能力有限
– 不支持批量生成或异步队列,单任务串行执行
– 无内置图像后处理(压缩、格式转换、水印等)
## 适合人群
– 在受限环境(企业内网、安全容器、无 root 权限服务器)中需要图像生成的开发者
– 追求极简部署、拒绝依赖地狱的运维/全栈工程师
– 快速原型验证场景,不愿花时间配置 Python 虚拟环境
## 常规风险
– **API 密钥安全**:需妥善保管 `GEMINI_API_KEY`,避免硬编码或日志泄露
– **内容合规**:Google 的图像生成模型有内置安全过滤,可能拒绝特定提示词
– **成本可控**:按图像生成量计费,高频调用需关注用量配额与费用
– **模型预览稳定性**:`nano-banana-pro-preview` 为预览版 API,可能存在变更或下线风险1c:T76d,## 核心用法
Gemini Image Simple 是一个极简的图像生成与编辑工具,通过命令行调用 Google 最高质量的图像模型 **Nano Banana Pro**(Gemini 3 Pro Image)。支持文生图和图生图两种模式:
– **生成新图**:`python3 {baseDir}/scripts/generate.py “prompt” output.png`
– **编辑现有图**:`python3 {baseDir}/scripts/generate.py “edit instructions” output.png –input source.png`
输入支持 PNG/JPG/GIF/WEBP,仅需设置 `GEMINI_API_KEY` 环境变量即可运行。
## 显著优点
1. **零依赖架构**:纯 Python 3.10+ 标准库实现(urllib/json/base64),无需 pip/uv,彻底规避供应链攻击风险
2. **极致可移植性**:可在 Fly.io 免费容器、企业沙箱、离线环境等”锁死”环境中直接运行
3. **顶级模型质量**:调用 Google 官方最高规格图像模型 nano-banana-pr









