Gemini Image Simple

🎨 零依赖 Gemini 图像生成,即开即用

零依赖 Gemini 图像生成工具,纯 Python 标准库实现,无需 pip/uv 即可在受限环境中运行。

收藏
15.1k
安装
7.1k
版本
1.1.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

核心用法

Gemini Image Simple 是一个极简的图像生成与编辑工具,通过 Google Nano Banana Pro(Gemini 3 Pro Image)模型实现高质量 AI 绘图。使用方式极为直接:

生成图像python3 {baseDir}/scripts/generate.py "prompt" output.png
编辑图像python3 {baseDir}/scripts/generate.py "edit instructions" output.png --input source.png

支持 PNG、JPG、JPEG、GIF、WEBP 格式输入,仅需设置 GEMINI_API_KEY 环境变量即可运行。

显著优点

1. 真正的零依赖:仅使用 Python 标准库(urllib.requestjsonbase64),无需安装任何第三方包
2. 环境适应性极强:可在 Fly.io 免费实例、锁定的容器、无 pip/uv 权限的系统中直接运行

3. 完整的模型能力:支持 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,可能存在变更或下线风险

安全解读

核心用法

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-pro-preview,支持商用级图像生成

4. 安全合规:API 密钥环境变量读取、HTTPS 加密传输、无敏感数据硬编码

潜在局限

  • 来源可信度 T3:个人开发者维护,无公开 GitHub 仓库可供社区验证历史
  • 功能相对基础:不支持批量生成、风格预设库、高级参数调优等企业级功能
  • 网络依赖单一:仅支持 Google API,无本地模型或备选服务商
  • 错误处理简单:缺少指数退避重试、详细错误码分类等生产级健壮性设计

适合人群

  • 无法安装 pip/conda 的企业内网/安全沙箱用户
  • Serverless 平台(Fly.io/Cloudflare Workers)开发者
  • 追求最小攻击面的隐私敏感型用户
  • 需要快速验证 Gemini Image API 的原型开发者

常规风险

  • API 密钥泄露风险(需自行保管环境变量)
  • Google API 服务可用性依赖
  • 图像生成内容的版权与合规责任由用户承担
  • T3 来源建议人工审查代码后再投入生产

Gemini Image Simple 内容

scripts文件夹
手动下载zip · 3.3 kB
generate.pytext/plain
请选择文件