目录

Banana Lite - 轻量级 Banana API 图像生成器

一个简洁的 Python GUI 工具,用于与 Banana API 交互生成图像。

特性

  • 🎨 简洁的 Web 界面 - 基于 Gradio 构建
  • 快速生成 - 一键生成高质量图像
  • 🔧 配置管理 - 保存多个 API 配置,快速切换
  • 📝 提示词分类管理 - 保存、分类和管理常用提示词
  • 🏷️ 分类系统 - 按分类组织提示词,支持筛选和搜索
  • 📦 轻量级 - 无需 ComfyUI,安装简单

系统要求

  • Python 3.10 或更高版本
  • Windows / macOS / Linux

安装

方法 1:从源码安装

# 克隆仓库
git clone https://github.com/your-username/comfyui-Banana-API-2.git
cd comfyui-Banana-API-2/banana-lite

方法 2:使用 pip 安装

pip install -e .

这会安装 Gradio 和所有必需的依赖。

配置

首次运行

  1. 安装完成后,运行:

    banana-ui
  2. 浏览器会自动打开应用界面

  3. 在”设置”标签页中配置:

    • API Key:输入你的 Banana API Key
    • API 地址:选择或输入 API 地址
    • 点击「测试连接」验证配置
    • 点击「保存配置」

使用方法

图像生成

  1. 在「提示词」输入框中输入图像描述
  2. 选择参数:
    • 宽高比:1:1, 16:9, 9:16 等
    • 数量:1-8 张
    • 分辨率:1K, 2K, 4K
  3. 高级选项(可选):
    • 模型:gemini-3-pro-image-preview-2k
    • 随机种子:留空表示随机
    • 绕过系统代理:勾选以绕过代理
  4. 点击「生成图像」

提示词管理

提示词管理功能位于独立的「提示词管理」标签页,支持分类管理和快速搜索。

保存提示词

  1. 切换到「提示词管理」标签页
  2. 在右侧面板输入提示词名称和内容
  3. 选择或创建分类
  4. 点击「保存提示词」

使用提示词

  1. 在左侧列表中点击选择提示词
  2. 点击「应用到生成」将内容填入生成页面的输入框

分类筛选

  • 使用顶部下拉框按分类筛选提示词
  • 选择「全部」查看所有提示词
  • 使用搜索框按名称或内容搜索

分类管理

  • 点击「+ 新建分类」创建新分类
  • 在分类管理面板中重命名或删除分类
  • 删除分类时,其中的提示词会自动移至「未分类」

移动提示词

  1. 选择要移动的提示词
  2. 在「移动到分类」下拉框中选择目标分类
  3. 点击「移动到该分类」确认

配置管理

保存配置:在设置页修改配置后点击「保存配置」

切换配置:在下拉框中选择已保存的配置

新建配置

  1. 输入新配置名称
  2. 修改 API Key 或 API 地址
  3. 点击「保存配置」

删除配置:选择配置后点击「删除」

目录结构

banana-lite/
├── banana_lite/               # 核心代码
│   ├── core/                  # 核心功能模块
│   │   ├── api_client.py       # Banana API 客户端
│   │   ├── generator.py        # 图像生成逻辑
│   │   ├── config_manager.py   # 配置管理
│   │   ├── image_codec_lite.py # 图像编解码
│   │   └── cli.py             # CLI 入口
│   ├── ui/                     # Gradio 界面
│   │   └── gradio_app.py       # 主应用
│   ├── tests/                  # 测试代码
│   ├── pyproject.toml          # 项目配置
│   └── run_banana_lite.py      # 启动脚本

命令

  • banana-ui - 启动 Web 界面

开发

安装开发依赖

pip install -e ".[dev]"

运行测试

pytest tests/

配置文件位置

  • Windows: C:\Users\<用户名>\AppData\Roaming\BananaLite\config.ini
  • macOS/Linux: ~/.banana-lite/config.ini

常见问题

Q: 如何更改 API 地址?

A: 在「设置」标签页的「API 地址」下拉框中选择或输入新地址,然后点击「保存配置」

Q: 如何保存多个 API Key?

A: 在「设置」标签页修改配置后,输入新配置名称,点击「保存配置」

Q: 提示词保存在哪里?

A: 提示词保存在 prompts.json 文件中,与配置文件在同一目录。新版本支持分类管理,数据格式会自动升级。

Q: 如何管理提示词分类?

A: 在「提示词管理」标签页中:

  • 点击「+ 新建分类」创建分类
  • 展开「分类管理」面板进行重命名或删除
  • 保存提示词时可选择分类
  • 使用顶部下拉框按分类筛选

Q: 旧版本的提示词会丢失吗?

A: 不会。系统会自动将旧格式的提示词迁移到新格式,所有提示词会被归入「未分类」分类。

版本历史

  • v1.0 (2024-12-25): 网页端口 v1.0 - 移除余额查询功能,重构为轻量级架构
  • v1.1 (2024-12-27): 界面优化版本 - 提示词管理 + API 配置管理
  • v1.2 (2026-01-06): UI 优化与提示词分类管理
    • 新增提示词分类功能,支持创建、重命名、删除分类
    • 提示词管理移至独立标签页,支持分类筛选和搜索
    • 采用 Swiss Style 设计规范优化界面
    • 支持设置记忆(宽高比、分辨率、模型等)
    • 增强无障碍支持(WCAG AA 标准)
    • 数据格式自动迁移,兼容旧版本

许可证

MIT License

联系方式

如有问题或建议,请提交 Issue。

关于
380.0 KB
邀请码
    Gitlink(确实开源)
  • 加入我们
  • 官网邮箱:gitlink@ccf.org.cn
  • QQ群
  • QQ群
  • 公众号
  • 公众号

版权所有:中国计算机学会技术支持:开源发展技术委员会
京ICP备13000930号-9 京公网安备 11010802032778号