nanobanana-pro-fallback

🍌 Gemini 高清生图与智能降级

🥥31总安装量 12评分人数 9
100% 的用户推荐

基于 Gemini API 的高清图像生成工具,支持文生图/图生图及多模型自动降级,可输出 1K-4K 分辨率并合成多达 14 张图像。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码安全规范,无 eval/exec/system 等危险函数,使用 Google 官方 SDK
  • ✅ API Key 通过环境变量安全获取,无硬编码风险
  • ⚠️ 需上传本地图片至 Gemini API 处理,存在数据跨境传输风险
  • ⚠️ 依赖版本未完全锁定(>= 而非 ==),建议关注版本兼容性
  • ✅ 严格的输入边界控制,最多支持 14 张图,分辨率限定 1K/2K/4K

使用说明

Nano Banana Pro Fallback 是一款基于 Google Gemini Image API 的图像生成与编辑工具,专为需要稳定、高质量 AI 绘图能力的用户设计。该技能通过 Python 脚本封装了 Gemini 的多模态能力,支持从文本生成图像、基于现有图像进行编辑,以及多图合成等高级功能。

核心用法

该技能通过命令行方式调用,必须使用 uv run 执行以确保依赖环境正确加载。基础用法包括文生图(text-to-image)和图生图(image-to-image)两种模式。用户可通过 --prompt 参数描述生成需求,使用 --filename 指定输出路径,并通过 --resolution 选择 1K、2K 或 4K 三种输出分辨率。对于图像编辑场景,支持通过 -i 参数传入最多 14 张参考图片进行多图合成或风格迁移。特别值得一提的是其智能降级机制:当首选模型 gemini-2.5-flash-image 不可用时,系统会自动回退至 gemini-2.0-flash-exp,确保服务连续性。

显著优点

首先,自动模型降级(Fallback)机制显著提升了可用性,避免因单一模型限流或下线导致任务中断。其次,采用 Google 官方 google-genai SDK,代码规范且安全可靠,无动态代码执行风险。功能层面支持高达 4K 的超高清分辨率输出,满足印刷级品质需求;多图合成能力(最多 14 张)为复杂场景构建和批量处理提供了可能。此外,使用 uv 作为运行时管理工具,免去了用户手动配置 Python 环境的麻烦。

潜在局限

作为 T3 来源的个人开源项目,缺乏大型组织背书,长期维护存在不确定性。功能上严格依赖 Google Gemini API 的可用性和网络连接,无法离线使用。依赖版本采用宽松约束(>= 而非 ==),可能在依赖库重大更新时引入兼容性问题。另外,虽然支持多图输入,但所有图像数据均需上传至 Google 服务器处理,对敏感内容存在隐私顾虑。

适用人群

适合开发者、设计师、内容创作者及需要批量生成营销素材的运营人员。特别是那些需要稳定 API 服务(通过自动降级保障)、追求高分辨率输出(2K/4K)或经常进行图像合成(多图参考)的专业用户。对于已通过 OpenClaw 或 CTOS 平台配置好 Gemini API Key 的技术用户尤为便捷。

使用风险

主要风险包括 API 调用成本(Gemini API 按量计费)、数据隐私(原图上传至 Google 云端处理)、网络依赖性(需稳定连接 Google 服务)以及工具链依赖(必须安装 uv 运行时)。建议用户妥善保管 GEMINI_API_KEY,避免在共享环境中硬编码密钥;处理敏感图像前需评估隐私合规要求;同时关注 uv 和 Python 依赖的兼容性状态。

nanobanana-pro-fallback 内容

文件夹图标scripts文件夹
手动下载zip · 5.4 kB
generate_image.pytext/plain
请选择文件