# ai_video_tool

**Repository Path**: weyee/ai_video_tool

## Basic Information

- **Project Name**: ai_video_tool
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-12
- **Last Updated**: 2025-11-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI视频自动生成与剪辑工具

一款基于AI技术的视频生成与剪辑工具，支持通过简单参数配置，从文本描述生成高质量图片/视频，自动完成剪辑并添加背景音乐，输出完整视频作品。

![版本](https://img.shields.io/badge/版本-1.0.0-blue)
![平台](https://img.shields.io/badge/平台-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
![开发状态](https://img.shields.io/badge/状态-已发布-success)

## 功能特点

- **文本生成图片**: 使用DeepSeek-Chat模型生成专业图片提示词，通过LibLib AI Star-3 Alpha模型生成高质量图片
- **图片生成视频**: 调用智谱AI的CogVideoX-Flash模型将图片转为动态视频
- **智能剪辑**: 自动处理视频片段分割、音频同步，添加背景音乐
- **可视化界面**: 基于PyQt6实现的简洁易用界面，支持参数配置和任务管理
- **批量处理**: 支持批量创建和处理任务，并支持CSV和JSON导入导出
- **完整工作流**: 从文本描述到最终视频的全流程自动化处理
- **断点续传**: 支持任务断点续传和恢复功能，提高容错性

## 预览展示

![主界面预览](docs/images/main_interface.png)
![视频生成流程](docs/images/workflow.png)

## 安装说明

### 系统要求
- Python 3.9+
- Windows, macOS 或 Linux
- 4GB以上内存，建议8GB

### 安装步骤

#### 方法1：下载预编译版本

1. 从[发布页面](https://github.com/yourusername/ai_video_tool/releases)下载适合您系统的安装包
2. 解压缩文件
3. 运行主程序"AI视频自动生成与剪辑工具"

#### 方法2：从源码安装

1. 克隆或下载仓库到本地
```bash
git clone [repository-url]
cd ai_video_tool
```

2. 创建并激活虚拟环境
```bash
# Windows
python -m venv venv
.\venv\Scripts\activate

# macOS/Linux
python -m venv venv
source venv/bin/activate
```

3. 安装依赖包
```bash
pip install -r requirements.txt
```

4. 启动应用
```bash
python main.py
```

### 视频剪辑功能注意事项

视频剪辑功能依赖于MoviePy和ffmpeg:

1. 确保MoviePy和imageio-ffmpeg已安装:
```bash
pip install moviepy imageio-ffmpeg
```

2. 如果遇到"ffmpeg未安装或不在系统路径中"的警告:
   - 系统会自动使用imageio-ffmpeg提供的ffmpeg
   - 无需手动安装ffmpeg

3. 如果仍然遇到问题，可以手动安装ffmpeg:
   - Windows: 从[ffmpeg官网](https://ffmpeg.org/download.html#build-windows)下载，将bin目录添加到系统PATH
   - macOS: `brew install ffmpeg`
   - Linux: `apt-get install ffmpeg` 或 `yum install ffmpeg`

## 使用指南

详细的使用说明请参阅[使用指南](docs/使用指南.md)文档。

1. 启动应用程序
2. 配置API密钥（设置界面）
3. 创建视频任务：
   - 输入视频主题和生成要求
   - 设置图片和视频参数
   - 选择背景音乐
   - 点击"开始任务"按钮
4. 查看任务进度和结果

## 常见问题解答

详细的常见问题解答请参阅[FAQ](docs/常见问题解答.md)文档。

## 开发进度

- [x] 第一阶段：环境配置与API接入
  - [x] 完成项目结构搭建
  - [x] 实现API接口封装和测试

- [x] 第二阶段：核心功能模块开发
  - [x] 文本到提示词模块
  - [x] 图片生成模块
  - [x] 视频生成模块
  - [x] 视频剪辑模块

- [x] 第三阶段：用户界面开发
  - [x] 完成PyQt6界面开发
  - [x] 实现界面与后端逻辑的连接
  - [x] 添加交互响应和反馈机制

- [x] 第四阶段：系统集成与测试
  - [x] 各模块集成测试
  - [x] 功能完整性测试
  - [x] 用户体验优化
  - [x] 增强错误处理机制

- [x] 第五阶段：发布与维护
  - [x] 完善文档
  - [x] 打包发布
  - [x] 持续优化与更新

## 项目团队

- 开发者: AI视频自动生成与剪辑工具开发团队
- 联系方式: dev@example.com

## 版本更新日志

### v1.0.0 (2024-07-18)
- 首次正式发布
- 实现所有核心功能
- 优化用户界面和交互体验
- 增强错误处理和恢复机制
- 完善文档和帮助系统

## 许可证

[MIT License](LICENSE)