# SubVivid

**Repository Path**: yiqi-software/SubVivid

## Basic Information

- **Project Name**: SubVivid
- **Description**: 一个支持自动字幕生成、文案矫正、字幕压制和首帧标题生成的视频处理工具。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-31
- **Last Updated**: 2026-01-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 影绘 (SubVivid)

一个支持自动字幕生成、文案矫正、字幕压制和首帧标题生成的视频处理工具。

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Python](https://img.shields.io/badge/python-3.8+-green.svg)

## 功能特性

- **语音识别字幕生成**：基于腾讯云 MPS API，将视频音频转换为字幕
- **字幕智能矫正**：使用参考文案矫正识别结果，提高准确性
- **标点符号过滤**：自动过滤字幕中的标点符号
- **字幕视频压制**：将字幕嵌入到视频中
- **首帧标题生成**：基于 AI 自动生成标题并添加到视频首帧
- **COS 存储**：自动上传处理结果到腾讯云 COS

## 快速开始

### 环境要求

- Python 3.8+
- FFmpeg（用于视频处理）

### 安装

```bash
# 克隆仓库
git clone https://github.com/majingzhen/SubVivid.git
cd SubVivid

# 安装依赖
pip install -r requirements.txt
```

### 配置

复制配置模板并填写你的 API 密钥：

```bash
cp .env.example .env
```

编辑 `.env` 文件，配置以下必要信息：

```env
# 腾讯云配置
TENCENT_SECRET_ID=你的SecretId
TENCENT_SECRET_KEY=你的SecretKey

# COS配置
COS_SECRET_ID=你的SecretId
COS_SECRET_KEY=你的SecretKey
COS_BUCKET_NAME=你的存储桶名称

# AI配置（可选）
GEMINI_API_KEY=你的API密钥
```

### 使用方法

```bash
# 控制台执行
python test_processor.py --video_url "视频URL" --words_content "文案内容"

# 从文件读取文案
python test_processor.py --video_url "视频URL" --words_file "words.txt"

# 使用配置文件
python test_processor.py --config task_config.json

# 生成示例配置
python test_processor.py --create_sample
```

## 项目结构

```
SubVivid/
├── config.py                 # 配置管理
├── subtitle_processor.py     # 字幕处理核心逻辑
├── subtitle_integration.py   # 字幕处理集成模块
├── mps_api.py               # 腾讯云 MPS API 封装
├── cos_client.py            # 腾讯云 COS 客户端
├── video_processor.py       # 视频处理工具
├── main.py                  # 主程序入口
├── test_processor.py        # 控制台测试工具
├── workflow.py              # 工作流编排
├── .env.example             # 配置模板
├── .gitignore               # Git忽略规则
├── requirements.txt         # Python依赖
└── README.md                # 项目说明
```

## 处理流程

1. 下载视频文件
2. 提取音频
3. 上传音频到 COS
4. 调用腾讯云 MPS 生成字幕
5. 使用参考文案矫正字幕
6. 过滤字幕标点符号
7. 调用腾讯云 MPS 压制字幕
8. 生成并添加首帧标题
9. 上传最终视频到 COS

## 依赖项

- `python-dotenv` - 环境变量管理
- `tencentcloud-sdk-python` - 腾讯云 SDK
- `pysrt` - 字幕文件处理
- `requests` - HTTP 请求

## 安全说明

本项目使用环境变量存储敏感配置信息。请勿将 `.env` 文件提交到版本控制系统。

## 贡献

欢迎提交 Issue 和 Pull Request！

## 许可证

[MIT License](LICENSE)

## Star 历史

[![Star History Chart](https://api.star-history.com/svg?repos=yourusername/SubVivid&type=Date)](https://star-history.com/#yourusername/SubVivid&Date)