赋予硅基生物以灵魂
当时明月在 · 曾照彩云归
简体中文 | English
将多个 AI 服务（Gemini Business、Dreamina、Kiro 等）转换为 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
大佬对Linux和Docker的部署优化 感谢PR
点击本页面右上角的 Fork 按钮，将项目复制到你的 GitHub 账号。
- 登录 Zeabur 并创建新项目
- 点击 创建项目 → 共享集群 / Silicon Valley, United States（腾讯云） → 创建项目 → 部署新服务 → 连接Github（没有授权一路授权即可） → 选择你刚刚 Fork 的仓库 → 部署即可
- 点击服务卡片 → 变量 标签，添加环境变量：
| 变量名 | 必填 | 说明 |
|---|---|---|
ADMIN_KEY | ✅ | 管理面板登录密钥，自己设置一个 |
DATABASE_URL | 推荐 | PostgreSQL 连接串（见下方"数据库持久化"说明） |
💡 强烈建议配置 DATABASE_URL，否则 Zeabur 重启后数据会丢失。免费数据库获取：neon.tech
- 点击 重新部署 使环境变量生效
- 等待构建完成（约 1-2 分钟）
当本项目有更新时：
- 打开你 Fork 的 GitHub 仓库页面
- 点击 Sync fork → Update branch
- 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/starsvictor/NexusAPI.git
cd NexusAPI
bash setup.sh
# 编辑 .env 设置 ADMIN_KEYsource .venv/bin/activate # Linux/macOS# .venv\Scripts\activate.bat # Windows
python main.py
# pm2后台运行
pm2 start main.py --name gemini-api --interpreter ./.venv/bin/python3Windows:
git clone https://github.com/starsvictor/NexusAPI.git
cd NexusAPI
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/starsvictor/NexusAPI.git
cd NexusAPI
# 安装 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支持 ARM64 和 AMD64 架构
# 1. 克隆仓库
git clone https://github.com/starsvictor/NexusAPI.git
cd NexusAPI
# 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!