KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #react #mcp #rust

NexusAPI

★ 27 Open GitHub ↗

将多个 AI 服务（Gemini Business、Dreamina、Kiro 等）转换为 OpenAI 兼容接口，支持多账号自动注册、负载均衡、图像生成、视频生成、多模态能力与内置管理面板。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="docs/logo.svg" width="120" alt="NexusAPI logo" />
</p>
<h1 align="center">NexusAPI</h1>
<p align="center">赋予硅基生物以灵魂</p>
<p align="center">当时明月在 · 曾照彩云归</p>
<p align="center">
  <strong>简体中文</strong> | <a href="docs/README_EN.md">English</a>
</p>
<p align="center"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" /> <img src="https://img.shields.io/badge/Python-3.11-3776AB?logo=python&logoColor=white" /> <img src="https://img.shields.io/badge/FastAPI-0.110-009688?logo=fastapi&logoColor=white" /> <img src="https://img.shields.io/badge/Vue-3-4FC08D?logo=vue.js&logoColor=white" /> <img src="https://img.shields.io/badge/Vite-7-646CFF?logo=vite&logoColor=white" /> <img src="https://img.shields.io/badge/Docker-ready-2496ED?logo=docker&logoColor=white" /></p>

<p align="center">将多个 AI 服务（Gemini Business、Dreamina、Kiro 等）转换为 OpenAI 兼容接口，支持多账号自动注册、负载均衡、图像生成、视频生成、多模态能力与内置管理面板。</p>

---

## 📜 开源协议与声明

**开源协议**: 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/starsvictor/NexusAPI/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/starsvictor/NexusAPI/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/starsvictor/NexusAPI.git
cd NexusAPI
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/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 环境）

### 方式三：手动部署

```bash
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
```

### 方式四：Docker Compose（推荐用于生产环境）

**支持 ARM64 和 AMD64 架构**

```bash
# 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](docs/SUPPORTED_FILE_TYPES.md)

## 📸 功能展示

### 管理系统

### 图片效果

## ⭐ Star History

[![Star History Chart](https://api.star-history.com/svg?repos=starsvictor/NexusAPI&type=date&legend=top-left)](https://www.star-history.com/#starsvictor/NexusAPI&type=date&legend=top-left)

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

NexusAPI

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README