赋予硅基生物以灵魂
当时明月在 · 曾照彩云归
简体中文 | English
将 Gemini Business 转换为 OpenAI 兼容接口，支持多账号负载均衡、图像生成、视频生成、多模态能力与内置管理面板。
--- ## 📜 开源协议与声明 **开源协议**: MIT License - 查看 [LICENSE](LICENSE) 文件了解详情 ### ⚠️ 严禁滥用：禁止将本工具用于商业用途或任何形式的滥用（无论规模大小） **本工具严禁用于以下行为：** - 商业用途或盈利性使用 - 任何形式的批量操作或自动化滥用（无论规模大小） - 破坏市场秩序或恶意竞争 - 违反 Google 服务条款的任何行为 - 违反 Microsoft 服务条款的任何行为 **违规后果**：滥用行为可能导致账号永久封禁、法律追责，一切后果由使用者自行承担。 **合法用途**：本项目仅限个人学习、技术研究与非商业性技术交流。 📖 **完整声明与免责条款**：[DISCLAIMER.md](docs/DISCLAIMER.md) --- ## ✨ 功能特性 - ✅ OpenAI API 完全兼容 - 无缝对接现有工具 - ✅ 多账号负载均衡 - 轮询与故障自动切换 - ✅ 自动化账号管理 - 支持自动注册与登录，集成 DuckMail 和 Microsoft 邮箱，支持无头浏览器模式 - ✅ 流式输出 - 实时响应 - ✅ 多模态输入 - 100+ 文件类型（图片、PDF、Office 文档、音频、视频、代码等） - ✅ 图片生成 & 图生图 - 模型可配置，Base64 或 URL 返回 - ✅ 视频生成 - 专用模型，支持 HTML/URL/Markdown 输出格式 - ✅ 智能文件处理 - 自动识别文件类型，支持 URL 与 Base64 - ✅ 日志与监控 - 实时状态与统计信息 - ✅ 代理支持 - 通过设置面板配置 - ✅ 内置管理面板 - 在线配置与账号管理 - ✅ 可选 PostgreSQL 后端 - 支持账户/设置/统计持久化 [感谢PR](https://github.com/Dreamy-rain/gemini-business2api/pull/4) ## 🤖 模型功能 | 模型ID | 识图 | 原生联网 | 文件多模态 | 图片生成 | 视频生成 | | ------------------------ | ---- | -------- | ---------- | -------- | -------- | | `gemini-auto` | ✅ | ✅ | ✅ | 可选 | - | | `gemini-2.5-flash` | ✅ | ✅ | ✅ | 可选 | - | | `gemini-2.5-pro` | ✅ | ✅ | ✅ | 可选 | - | | `gemini-3-flash-preview` | ✅ | ✅ | ✅ | 可选 | - | | `gemini-3-pro-preview` | ✅ | ✅ | ✅ | 可选 | - | | `gemini-imagen` | ✅ | ✅ | ✅ | ✅ | - | | `gemini-veo` | ✅ | ✅ | ✅ | - | ✅ | **虚拟模型说明**： - `gemini-imagen`：专用图片生成模型，强制启用图片生成功能 - `gemini-veo`：专用视频生成模型，强制启用视频生成功能 #### 数据库迁移（首次使用或升级） 如果你有旧的本地文件（accounts.json/settings.yaml/stats.json），需要运行迁移脚本： ```bash # 直接运行迁移脚本 python scripts/migrate_to_database.py # Zeabur 环境：点击服务 → 指令 → 输入以下命令 python scripts/migrate_to_database.py ``` **迁移脚本会自动检测**： - ✅ 配置了 `DATABASE_URL` → 迁移到 PostgreSQL（远程数据库） - ✅ 未配置 `DATABASE_URL` → 迁移到 SQLite（本地 data.db） **迁移内容**： - ✅ 从 kv_store（旧表结构）迁移到新表（仅 PostgreSQL） - ✅ 从本地文件（accounts.json/settings.yaml/stats.json）迁移到数据库 - ✅ 迁移后自动重命名本地文件（防止重复） - ✅ 保留 kv_store 作为备份（仅 PostgreSQL） > **注意**：SQLite 和 PostgreSQL 表结构完全兼容，以后可以从 SQLite 迁移到 PostgreSQL ## 🚀 快速开始 ### 方式一：Zeabur 部署（推荐，支持自动更新） 大佬对Linux和Docker的部署优化 [感谢PR](https://github.com/Dreamy-rain/gemini-business2api/pull/37) #### 第一步：Fork 仓库 点击本页面右上角的 **Fork** 按钮，将项目复制到你的 GitHub 账号。 #### 第二步：部署到 Zeabur 1. 登录 [Zeabur](https://zeabur.com) 并创建新项目 2. 点击 **创建项目** → **共享集群 / Silicon Valley, United States（腾讯云）** → **创建项目** → **部署新服务** → **连接Github（没有授权一路授权即可）** → **选择你刚刚 Fork 的仓库** → **部署即可** 3. 点击服务卡片 → **变量** 标签，添加环境变量： | 变量名 | 必填 | 说明 | | -------------- | ---- | --------------------------------------------- | | `ADMIN_KEY` | ✅ | 管理面板登录密钥，自己设置一个 | | `DATABASE_URL` | 推荐 | PostgreSQL 连接串（见下方"数据库持久化"说明） | > 💡 **强烈建议配置 DATABASE_URL**，否则 Zeabur 重启后数据会丢失。免费数据库获取：[neon.tech](https://neon.tech) 4. 点击 **重新部署** 使环境变量生效 5. 等待构建完成（约 1-2 分钟） #### 如何更新？ 当本项目有更新时： 1. 打开你 Fork 的 GitHub 仓库页面 2. 点击 **Sync fork** → **Update branch** 3. Zeabur 会自动检测变更并重新部署，无需手动操作 --- ### 方式二：使用安装脚本（本地部署） #### 前置要求 - **Python 3.11**（必需，项目使用 uv 自动管理 Python 版本） - **Git** - **Node.js & npm**（用于构建前端） - **uv**（安装脚本会自动安装） > **⚠️ 注意**：Python 3.12 不支持，因为部分依赖使用 `distutils`（Python 3.12 已移除）。安装脚本会自动下载并安装 Python 3.11，无需手动安装。 ### 方式一：使用安装脚本（推荐） **Linux/macOS (WSL):** ```bash git clone https://github.com/Dreamy-rain/gemini-business2api.git cd gemini-business2api bash setup.sh # 编辑 .env 设置 ADMIN_KEY source .venv/bin/activate # Linux/macOS # .venv\Scripts\activate.bat # Windows python main.py # pm2后台运行 pm2 start main.py --name gemini-api --interpreter ./.venv/bin/python3 ``` **Windows:** ```cmd git clone https://github.com/Dreamy-rain/gemini-business2api.git cd gemini-business2api setup.bat # 编辑 .env 设置 ADMIN_KEY source .venv/bin/activate # Linux/macOS # .venv\Scripts\activate.bat # Windows python main.py # pm2后台运行 pm2 start main.py --name gemini-api --interpreter ./.venv/Scripts/python.exe ``` **安装脚本功能：** - ✅ 自动安装/更新 uv（现代 Python 包管理器） - ✅ 自动下载并安装 Python 3.11（如果系统中没有） - ✅ 自动同步最新代码 - ✅ 更新前端到最新版本 - ✅ 创建/更新 Python 虚拟环境 - ✅ 安装/更新依赖 - ✅ 自动创建 `.env` 配置文件（如不存在） **首次安装：** 完成后编辑 `.env` 设置 `ADMIN_KEY`，然后运行 `python main.py` **更新项目：** 直接运行相同命令即可，脚本会自动更新所有组件（代码、依赖、前端、Python 环境） ### 方式三：手动部署 ```bash git clone https://github.com/Dreamy-rain/gemini-business2api.git cd gemini-business2api # 安装 uv（必需） curl -LsSf https://astral.sh/uv/install.sh | sh # 安装 Python 3.11（必需） uv python install 3.11 # 构建前端 cd frontend npm install npm run build cd .. # 创建虚拟环境 uv venv --python 3.11 .venv source .venv/bin/activate # Linux/macOS # .venv\Scripts\activate.bat # Windows # 安装 Python 依赖 uv pip install -r requirements.txt cp .env.example .env # win: copy .env.example .env # 编辑 .env 设置 ADMIN_KEY python main.py # pm2后台运行 pm2 start main.py --name gemini-api --interpreter ./.venv/bin/python3 ``` ### 方式四：Docker Compose（推荐用于生产环境） **支持 ARM64 和 AMD64 架构** ```bash # 1. 克隆仓库 git clone https://github.com/Dreamy-rain/gemini-business2api.git cd gemini-business2api # 2. 配置环境变量 cp .env.example .env # 编辑 .env 设置 ADMIN_KEY # 3. 启动服务 docker-compose up -d # 4. 查看日志 docker-compose logs -f # 5. 更新到最新版本 docker-compose pull && docker-compose up -d ``` ### 数据库持久化（可选）（强烈推荐） 💡 提示：远程环境(Hugging Face/Linux)和本地环境可共用同一数据库，账户数据将自动保持同步 - HF Spaces 环境建议开启，否则重启会丢数据 - 设置 `DATABASE_URL=postgresql://user:password@host/dbname?sslmode=require` - 本地：写入 `.env` - HF Spaces：Settings -> Variables/Secrets - 启用后账户/设置/统计写入数据库（HF Spaces 重启不丢） - 注意：连接串包含密码，请勿公开 ``` # Neon 获取 DATABASE_URL（推荐） 1. 打开 https://neon.tech 并登录 2. Create project -> 选择区域 3. 进入项目页，找到 Connection string 并复制 4. 形如： postgresql://user:password@ep-xxx.neon.tech/dbname?sslmode=require ``` ### 访问方式 - 管理面板：`http://localhost:7860/`（使用 `ADMIN_KEY` 登录） - OpenAI 兼容接口：`http://localhost:7860/v1/chat/completions` ### 配置提示 - 账号配置优先读取 `ACCOUNTS_CONFIG`，也可在管理面板中录入并保存至 `data/accounts.json`。 - 如需鉴权，可在管理面板设置中配置 `API_KEY` 保护 `/v1/chat/completions`。 ### 更多文档 - 支持的文件类型：[docs/SUPPORTED_FILE_TYPES.md](docs/SUPPORTED_FILE_TYPES.md) ## 📸 功能展示 ### 管理系统 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
