Gemini Business2API

赋予硅基生物以灵魂

当时明月在 · 曾照彩云归

简体中文 | English

将 Gemini Business 转换为 OpenAI 兼容接口，支持多账号负载均衡、图像生成、视频生成、多模态能力与内置管理面板。

---

📜 开源协议与声明

开源协议: MIT License - 查看 LICENSE 文件了解详情

⚠️ 严禁滥用：禁止将本工具用于商业用途或任何形式的滥用（无论规模大小）

本工具严禁用于以下行为：

• 商业用途或盈利性使用
• 任何形式的批量操作或自动化滥用（无论规模大小）
• 破坏市场秩序或恶意竞争
• 违反 Google 服务条款的任何行为
• 违反 Microsoft 服务条款的任何行为

违规后果：滥用行为可能导致账号永久封禁、法律追责，一切后果由使用者自行承担。

合法用途：本项目仅限个人学习、技术研究与非商业性技术交流。

📖 完整声明与免责条款：DISCLAIMER.md

---

✨ 功能特性

• ✅ OpenAI API 完全兼容 - 无缝对接现有工具
• ✅ 多账号负载均衡 - 轮询与故障自动切换
• ✅ 自动化账号管理 - 支持自动注册与登录，集成 DuckMail 和 Microsoft 邮箱，支持无头浏览器模式
• ✅ 流式输出 - 实时响应
• ✅ 多模态输入 - 100+ 文件类型（图片、PDF、Office 文档、音频、视频、代码等）
• ✅ 图片生成 & 图生图 - 模型可配置，Base64 或 URL 返回
• ✅ 视频生成 - 专用模型，支持 HTML/URL/Markdown 输出格式
• ✅ 智能文件处理 - 自动识别文件类型，支持 URL 与 Base64
• ✅ 日志与监控 - 实时状态与统计信息
• ✅ 代理支持 - 通过设置面板配置
• ✅ 内置管理面板 - 在线配置与账号管理
• ✅ 可选 PostgreSQL 后端 - 支持账户/设置/统计持久化 感谢PR

🤖 模型功能

模型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），需要运行迁移脚本：

# 直接运行迁移脚本
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

第一步：Fork 仓库

点击本页面右上角的 Fork 按钮，将项目复制到你的 GitHub 账号。

第二步：部署到 Zeabur

1. 登录 Zeabur 并创建新项目
2. 点击 创建项目 → 共享集群 / Silicon Valley, United States（腾讯云） → 创建项目 → 部署新服务 → 连接Github（没有授权一路授权即可） → 选择你刚刚 Fork 的仓库 → 部署即可
3. 点击服务卡片 → 变量 标签，添加环境变量：

变量名	必填	说明
ADMIN_KEY	✅	管理面板登录密钥，自己设置一个
DATABASE_URL	推荐	PostgreSQL 连接串（见下方"数据库持久化"说明）

💡 强烈建议配置 DATABASE_URL，否则 Zeabur 重启后数据会丢失。免费数据库获取：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):

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:

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 环境）

方式三：手动部署

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 架构

# 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

📸 功能展示

管理系统

图片效果

⭐ Star History

如果这个项目对你有帮助，请给个 ⭐ Star!