313 lines
7.5 KiB
Markdown
313 lines
7.5 KiB
Markdown
# Nano Banana API 中转平台
|
||
|
||
一个完整的大模型 API 中转购买平台，支持用户注册、充值、API 调用等功能。
|
||
|
||
## 项目简介
|
||
|
||
本项目是一个前后端分离的 API 中转服务平台，用户可以通过注册账户、充值余额来使用 Nano Banana 文生图 API 服务。
|
||
|
||
### 主要功能
|
||
|
||
- 📧 邮箱注册登录系统（支持邮箱验证）
|
||
- 💰 用户余额管理和充值系统
|
||
- 💳 支付接口（支持支付宝/微信支付）
|
||
- 🎨 Nano Banana 文生图 API 中转
|
||
- 🔑 API 密钥管理
|
||
- 📊 用户统计和订单管理
|
||
- 👨💼 管理员后台
|
||
- 📱 响应式设计（支持手机端和电脑端）
|
||
|
||
## 技术栈
|
||
|
||
### 后端 (NBATransfer-backend)
|
||
- **框架**: Flask 3.0
|
||
- **数据库**: SQLite
|
||
- **ORM**: Flask-SQLAlchemy
|
||
- **认证**: Flask-JWT-Extended
|
||
- **跨域**: Flask-CORS
|
||
- **邮件**: Flask-Mail
|
||
|
||
### 前端 (NBATransfer-frontend)
|
||
- **框架**: React 19 + TypeScript
|
||
- **构建工具**: Vite
|
||
- **UI 组件库**: Ant Design
|
||
- **状态管理**: Zustand
|
||
- **路由**: React Router
|
||
- **HTTP 客户端**: Axios
|
||
- **图表**: Recharts
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
.
|
||
├── NBATransfer-backend/ # 后端项目
|
||
│ ├── app.py # Flask 应用入口
|
||
│ ├── config.py # 配置文件
|
||
│ ├── models.py # 数据库模型
|
||
│ ├── routes/ # 路由模块
|
||
│ │ ├── auth.py # 认证相关
|
||
│ │ ├── user.py # 用户相关
|
||
│ │ ├── order.py # 订单相关
|
||
│ │ ├── api_service.py # API 服务
|
||
│ │ ├── admin.py # 管理员
|
||
│ │ ├── apikey.py # API 密钥
|
||
│ │ └── v1_api.py # V1 API 接口
|
||
│ ├── services/ # 业务逻辑层
|
||
│ ├── modelapiservice/ # 模型 API 服务
|
||
│ │ ├── DeepSeek/ # DeepSeek 服务
|
||
│ │ └── NanoBanana/ # NanoBanana 服务
|
||
│ └── requirements.txt # Python 依赖
|
||
│
|
||
├── NBATransfer-frontend/ # 前端项目
|
||
│ ├── src/
|
||
│ │ ├── api/ # API 接口定义
|
||
│ │ ├── components/ # 公共组件
|
||
│ │ ├── pages/ # 页面组件
|
||
│ │ ├── store/ # 状态管理
|
||
│ │ ├── types/ # TypeScript 类型
|
||
│ │ └── utils/ # 工具函数
|
||
│ └── package.json # Node.js 依赖
|
||
│
|
||
└── README.md # 项目说明文档
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
### 环境要求
|
||
|
||
- Python 3.9+
|
||
- Node.js 18+
|
||
- npm 或 yarn
|
||
|
||
### 后端启动
|
||
|
||
1. 进入后端目录：
|
||
```bash
|
||
cd NBATransfer-backend
|
||
```
|
||
|
||
2. 安装依赖：
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
3. 配置环境变量（可选）：
|
||
创建 `.env` 文件并配置以下变量：
|
||
```env
|
||
SECRET_KEY=your-secret-key
|
||
JWT_SECRET_KEY=your-jwt-secret-key
|
||
DATABASE_URI=sqlite:///nba_transfer.db
|
||
MAIL_SERVER=smtp.qq.com
|
||
MAIL_PORT=465
|
||
MAIL_USE_SSL=True
|
||
MAIL_USERNAME=your-email@qq.com
|
||
MAIL_PASSWORD=your-email-password
|
||
```
|
||
|
||
4. 运行后端：
|
||
```bash
|
||
python app.py
|
||
```
|
||
|
||
或者使用批处理文件（Windows）：
|
||
```bash
|
||
启动后端.bat
|
||
```
|
||
|
||
后端服务将在 `http://localhost:5000` 启动
|
||
|
||
### 前端启动
|
||
|
||
1. 进入前端目录：
|
||
```bash
|
||
cd NBATransfer-frontend
|
||
```
|
||
|
||
2. 安装依赖：
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
3. 配置环境变量（可选）：
|
||
创建 `.env` 文件：
|
||
```env
|
||
VITE_API_URL=http://localhost:5000/api
|
||
```
|
||
|
||
4. 运行前端：
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
或者使用批处理文件（Windows）：
|
||
```bash
|
||
启动前端.bat
|
||
```
|
||
|
||
前端服务将在 `http://localhost:5173` 启动（Vite 默认端口）
|
||
|
||
## 默认账户
|
||
|
||
### 管理员账户
|
||
- **邮箱**: admin@nba.com
|
||
- **密码**: admin123
|
||
|
||
⚠️ **首次登录后请立即修改密码！**
|
||
|
||
## API 文档
|
||
|
||
### 认证相关 `/api/auth`
|
||
- `POST /register` - 用户注册
|
||
- `POST /login` - 用户登录
|
||
- `POST /refresh` - 刷新令牌
|
||
- `GET /me` - 获取当前用户信息
|
||
- `POST /change-password` - 修改密码
|
||
|
||
### 用户相关 `/api/user`
|
||
- `GET /profile` - 获取用户资料
|
||
- `PUT /profile` - 更新用户资料
|
||
- `GET /balance` - 获取账户余额
|
||
- `GET /transactions` - 获取交易记录
|
||
- `GET /api-calls` - 获取 API 调用记录
|
||
- `GET /stats` - 获取统计信息
|
||
|
||
### 订单相关 `/api/order`
|
||
- `POST /create` - 创建充值订单
|
||
- `GET /list` - 获取订单列表
|
||
- `GET /<order_id>` - 获取订单详情
|
||
- `POST /notify/<order_no>` - 支付通知（测试用）
|
||
|
||
### API 服务 `/api/service`
|
||
- `POST /text-to-image` - 文生图 API
|
||
- `GET /models` - 获取可用模型
|
||
- `GET /pricing` - 获取价格信息
|
||
- `GET /call/<call_id>` - 获取 API 调用详情
|
||
|
||
### API 密钥 `/api/apikey`
|
||
- `GET /list` - 获取 API 密钥列表
|
||
- `POST /create` - 创建 API 密钥
|
||
- `PUT /<key_id>/toggle` - 启用/禁用密钥
|
||
- `DELETE /<key_id>` - 删除密钥
|
||
|
||
### V1 API `/v1`
|
||
- `POST /chat/completions` - 聊天完成接口
|
||
- `POST /images/generations` - 图片生成接口
|
||
|
||
### 管理员 `/api/admin`
|
||
- `GET /users` - 获取用户列表
|
||
- `GET /users/<user_id>` - 获取用户详情
|
||
- `POST /users/<user_id>/toggle-status` - 启用/禁用用户
|
||
- `POST /users/<user_id>/adjust-balance` - 调整用户余额
|
||
- `GET /orders` - 获取所有订单
|
||
- `GET /api-calls` - 获取所有 API 调用
|
||
- `GET /stats/overview` - 获取总览统计
|
||
- `GET /stats/chart` - 获取图表数据
|
||
|
||
## 数据库结构
|
||
|
||
### 用户表 (users)
|
||
- 邮箱、密码、用户名
|
||
- 余额、激活状态、管理员标识
|
||
- 邮箱验证状态
|
||
- 创建时间、更新时间
|
||
|
||
### 订单表 (orders)
|
||
- 订单号、用户ID、金额
|
||
- 支付方式、订单状态
|
||
- 第三方交易ID、支付时间
|
||
|
||
### 交易记录表 (transactions)
|
||
- 用户ID、交易类型（充值/消费/退款）
|
||
- 金额、前后余额
|
||
- 关联订单、关联API调用
|
||
|
||
### API调用表 (api_calls)
|
||
- 用户ID、API类型
|
||
- 提示词、参数、状态
|
||
- 结果URL、费用、错误信息
|
||
|
||
### API密钥表 (api_keys)
|
||
- 用户ID、密钥名称
|
||
- API密钥、激活状态
|
||
- 最后使用时间
|
||
|
||
### 验证码表 (verification_codes)
|
||
- 用户ID、邮箱
|
||
- 验证码、用途、使用状态
|
||
- 过期时间
|
||
|
||
## 价格策略
|
||
|
||
- **文生图 API**: 0.15 元/张
|
||
|
||
## 开发说明
|
||
|
||
### 添加新的路由
|
||
|
||
**后端**：
|
||
1. 在 `routes/` 目录下创建新的蓝图文件
|
||
2. 在 `app.py` 中注册蓝图
|
||
|
||
**前端**：
|
||
1. 在 `src/api/modules/` 下创建 API 模块
|
||
2. 在 `src/pages/` 下创建页面组件
|
||
3. 在 `src/router/` 中配置路由
|
||
|
||
### 数据库迁移
|
||
|
||
```bash
|
||
# 进入 Python shell
|
||
python
|
||
>>> from app import create_app
|
||
>>> from models import db
|
||
>>> app = create_app()
|
||
>>> with app.app_context():
|
||
... db.create_all()
|
||
```
|
||
|
||
## 部署建议
|
||
|
||
### 后端部署
|
||
|
||
#### 使用 Gunicorn (生产环境)
|
||
```bash
|
||
pip install gunicorn
|
||
gunicorn -w 4 -b 0.0.0.0:5000 app:app
|
||
```
|
||
|
||
#### 使用 Docker
|
||
```dockerfile
|
||
FROM python:3.9
|
||
WORKDIR /app
|
||
COPY requirements.txt .
|
||
RUN pip install -r requirements.txt
|
||
COPY . .
|
||
CMD ["gunicorn", "-w", "4", "-b", "0.0.0.0:5000", "app:app"]
|
||
```
|
||
|
||
### 前端部署
|
||
|
||
```bash
|
||
npm run build
|
||
```
|
||
|
||
构建产物在 `dist/` 目录，可以部署到 Nginx、Vercel、Netlify 等平台。
|
||
|
||
## 注意事项
|
||
|
||
1. ⚠️ 生产环境请修改所有默认密钥
|
||
2. ⚠️ 配置实际的邮件服务器
|
||
3. ⚠️ 接入真实的支付接口
|
||
4. ⚠️ 配置 HTTPS
|
||
5. ⚠️ 定期备份数据库
|
||
6. ⚠️ 设置合适的 CORS 策略
|
||
|
||
## 许可证
|
||
|
||
MIT License
|
||
|
||
## 贡献
|
||
|
||
欢迎提交 Issue 和 Pull Request！
|
||
|