104 lines
2.4 KiB
Markdown
104 lines
2.4 KiB
Markdown
# AI VideoAssistant Backend
|
||
|
||
Python 后端 API，配合前端 `ai-videoassistant-frontend` 使用。
|
||
|
||
## 快速开始
|
||
|
||
### 1. 安装依赖
|
||
|
||
```bash
|
||
cd ~/Code/ai-videoassistant-backend
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 2. 初始化数据库
|
||
|
||
```bash
|
||
python init_db.py
|
||
```
|
||
|
||
这会：
|
||
- 创建 `data/app.db` SQLite 数据库
|
||
- 初始化默认声音数据
|
||
|
||
### 3. 启动服务
|
||
|
||
```bash
|
||
# 开发模式 (热重载)
|
||
python -m uvicorn main:app --reload --host 0.0.0.0 --port 8000
|
||
```
|
||
|
||
### 4. 测试 API
|
||
|
||
```bash
|
||
# 健康检查
|
||
curl http://localhost:8000/health
|
||
|
||
# 获取助手列表
|
||
curl http://localhost:8000/api/assistants
|
||
|
||
# 获取声音列表
|
||
curl http://localhost:8000/api/voices
|
||
|
||
# 获取通话历史
|
||
curl http://localhost:8000/api/history
|
||
```
|
||
|
||
## API 文档
|
||
|
||
| 端点 | 方法 | 说明 |
|
||
|------|------|------|
|
||
| `/api/assistants` | GET | 助手列表 |
|
||
| `/api/assistants` | POST | 创建助手 |
|
||
| `/api/assistants/{id}` | GET | 助手详情 |
|
||
| `/api/assistants/{id}` | PUT | 更新助手 |
|
||
| `/api/assistants/{id}` | DELETE | 删除助手 |
|
||
| `/api/voices` | GET | 声音库列表 |
|
||
| `/api/history` | GET | 通话历史列表 |
|
||
| `/api/history/{id}` | GET | 通话详情 |
|
||
| `/api/history/{id}/transcripts` | POST | 添加转写 |
|
||
| `/api/history/{id}/audio/{turn}` | GET | 获取音频 |
|
||
|
||
## 使用 Docker 启动
|
||
|
||
```bash
|
||
cd ~/Code/ai-videoassistant-backend
|
||
|
||
# 启动所有服务
|
||
docker-compose up -d
|
||
|
||
# 查看日志
|
||
docker-compose logs -f backend
|
||
```
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
backend/
|
||
├── app/
|
||
│ ├── __init__.py
|
||
│ ├── main.py # FastAPI 入口
|
||
│ ├── db.py # SQLite 连接
|
||
│ ├── models.py # 数据模型
|
||
│ ├── schemas.py # Pydantic 模型
|
||
│ ├── storage.py # MinIO 存储
|
||
│ └── routers/
|
||
│ ├── __init__.py
|
||
│ ├── assistants.py # 助手 API
|
||
│ └── history.py # 通话记录 API
|
||
├── data/ # 数据库文件
|
||
├── requirements.txt
|
||
├── .env
|
||
└── docker-compose.yml
|
||
```
|
||
|
||
## 环境变量
|
||
|
||
| 变量 | 默认值 | 说明 |
|
||
|------|--------|------|
|
||
| `DATABASE_URL` | `sqlite:///./data/app.db` | 数据库连接 |
|
||
| `MINIO_ENDPOINT` | `localhost:9000` | MinIO 地址 |
|
||
| `MINIO_ACCESS_KEY` | `admin` | MinIO 密钥 |
|
||
| `MINIO_SECRET_KEY` | `password123` | MinIO 密码 |
|
||
| `MINIO_BUCKET` | `ai-audio` | 存储桶名称 |
|