# 视频分析API

**Repository Path**: Martinkeep/video-analysis-api

## Basic Information

- **Project Name**: 视频分析API
- **Description**: 视频分析器，分析视频的内容
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-30
- **Last Updated**: 2025-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LLaVA-Video-Insight

LLaVA-Video-Insight 是一个基于 LLaVA 模型的视频内容分析 API 服务，提供多种视频分析功能，包括视频内容预测、关键帧分析、视频分段分析等。

## 功能特性

- **视频上传与分析**：支持视频上传并进行内容分析。
- **关键帧重构分析**：通过关键帧重构技术分析视频内容。
- **多模式分析**：支持直接分析、关键帧分析等多种分析模式。
- **分析结果管理**：支持获取分析结果、分析历史，以及删除分析结果。
- **模型管理**：支持模型初始化、重新初始化，以及获取模型状态。
- **结果总结**：通过 Ollama 提供视频分析结果的总结功能。

## 快速开始

### 环境要求

- Python 3.11
- FastAPI
- NVIDIA CUDA 支持（用于 GPU 加速）
- Docker（可选）

### 安装依赖

```bash
pip install -r requirements.txt
```

### 启动服务

```bash
python main.py
```

### 使用 Docker 启动

```bash
docker build -t llava-video-insight .
docker run -p 8000:8000 llava-video-insight
```

## API 接口

### 视频分析

- **POST /analyze-direct**：直接分析视频内容（推荐）
- **POST /analyze-keyframe**：使用关键帧重构分析视频内容
- **POST /analyze**：分析视频内容（支持后台任务）
- **GET /analysis/{analysis_id}**：获取指定 ID 的分析结果
- **GET /analyses**：获取分析历史记录
- **DELETE /analysis/{analysis_id}**：删除指定 ID 的分析结果
- **POST /clear-cache**：清空分析缓存

### 模型管理

- **POST /model/initialize**：初始化模型
- **POST /model/reinitialize**：强制重新初始化模型
- **GET /model/status**：获取模型状态
- **GET /model/info**：获取模型信息

### 其他功能

- **POST /summarize**：使用 Ollama 总结视频分析结果
- **GET /health**：服务健康检查

## 使用示例

### 直接分析视频

```bash
curl -X POST "http://localhost:8000/analyze-direct" \
     -H "Content-Type: application/json" \
     -d '{"video_url": "https://example.com/video.mp4", "prompt": "描述视频内容"}'
```

### 获取分析结果

```bash
curl "http://localhost:8000/analysis/123456"
```

### 初始化模型

```bash
curl -X POST "http://localhost:8000/model/initialize"
```

## 贡献指南

欢迎贡献代码和改进文档。请提交 Pull Request 或 Issue 到 [GitHub 仓库](https://gitee.com/Martinkeep/video-analysis-api)。

## 许可证

本项目使用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。