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. 修改 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 文件中，与配置文件在同一目录

版本历史

• v1.0 (2024-12-25): 网页端口 v1.0 - 移除余额查询功能，重构为轻量级架构
• v1.1 (2024-12-27): 界面优化版本 - 提示词管理 + API 配置管理

许可证

MIT License

联系方式

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