- 使用 Gradio 提供网页界面
- 页面采用左右布局：左侧输入，右侧输出
- 支持输入文本（prompt）
- 支持上传多张参考图（urls，文件多选上传）
- 文本与参考图至少提供一个
- 下拉菜单包含：模型名、宽高比、分辨率
- 使用 Gradio 内置登录页鉴权（账号密码在配置文件中设置）
- 服务监听端口
45001，并使用root_path=/tools
- 复制示例文件：
cp config_example.yaml config.yaml- 编辑
config.yaml：
api.endpoint: 代理接口地址api.key: 接口密钥auth.username: Gradio 登录账号auth.password: Gradio 登录密码request_fields: 代理接口字段名映射（和文档不一致时改这里）defaults: 下拉选项默认值与候选值
应用启动时实际读取的是
config.yaml，config_example.yaml仅作为模板。
pip install -r requirements.txt
python app.py本地直连访问：
http://localhost:45001
Nginx 子路径访问（推荐生产）：
https://your-domain/tools/
- 启动时通过
launch(auth=(username, password))启用 Gradio 原生登录页。 - 用户必须先通过登录页鉴权，才能进入工具页面并调用接口。
默认按以下字段组装请求体（可在 request_fields 自定义）：
model:nano-banana-fast/nano-banana/nano-banana-proprompt（可选）urls（可选，来自多图上传，发送为 data URL 数组）aspectRatio:auto/1:1/16:9/9:16/4:3/3:4/3:2/2:3/5:4/4:5/21:9imageSize:1K/2K/4K
- 可使用“清空参考图”按钮一次清空已上传内容。
- 接口响应控件会同时展示请求参数与接口返回，方便对照调试。
- 支持拖拽/点击上传参考图；每次新增会自动追加到已上传列表（可分批连续上传），并显示固定宽度缩略图预览。
- 参考图组件支持多图上传。
- 提交时会校验：
prompt与urls不能同时为空。 - 右侧会展示输出图片预览，并额外提供“查看/下载原图（高清）”链接或下载按钮，避免误存压缩预览图。
- 接口响应面板仅用于调试，已缩小高度并把空间更多让给输出图片。