# auto2srt

**Repository Path**: initchu/auto2srt

## Basic Information

- **Project Name**: auto2srt
- **Description**: 视频自动生成字幕
- **Primary Language**: HTML
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-28
- **Last Updated**: 2026-01-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视频自动生成字幕工具

## 功能
根据输入的视频文件，自动提取音频并通过火山引擎大模型录音文件识别API生成对应的字幕文件，支持两种输出格式：
- **SRT格式**：包含序号、时间戳和文本内容（默认格式）
- **TXT格式**：只包含纯文本内容，不包含时间点

## 部署步骤

### 1. 配置API密钥
1. 复制 `.env.example` 文件为 `.env`
2. 在 `.env` 文件中填入你的火山引擎APP ID和Access Token
```
APP_ID=your_app_id_here
ACCESS_TOKEN=your_access_token_here
```

### 2. 部署后端到Vercel
1. 注册或登录 Vercel 账号
2. 连接你的 GitHub 仓库
3. 点击 "Import Project" 导入本项目
4. 在部署设置中：
   - 选择 "Python" 作为运行时
   - 添加环境变量（APP_ID 和 ACCESS_TOKEN）
5. 点击 "Deploy" 完成部署
6. 记录部署后的 URL（例如：`https://your-project.vercel.app`）

### 3. 部署前端到GitHub Pages
1. 推送代码到 GitHub 仓库
2. 在仓库设置中启用 GitHub Pages：
   - 选择 "Deploy from a branch"
   - 选择 `main` 分支
   - 点击 "Save"
3. 等待部署完成，记录 GitHub Pages URL

### 4. 更新前端API地址
1. 编辑 `index.html` 文件
2. 修改 `API_BASE_URL` 为你的 Vercel 部署地址：
```javascript
const API_BASE_URL = 'https://your-project.vercel.app/api';
```
3. 推送更新到 GitHub 仓库

## 使用方法

1. 打开 GitHub Pages 网站
2. 点击或拖拽视频文件到上传区域
3. 选择输出格式（SRT 或 TXT）
4. 点击 "上传并生成字幕" 按钮
5. 等待字幕生成完成（过程中会显示实时进度）
6. 查看生成的字幕内容
7. 点击 "下载字幕文件" 保存到本地

## 注意事项

1. **文件大小限制**：最大支持 100MB 的视频文件
2. **视频格式**：仅支持 MP4 格式视频
3. **API 密钥**：需要有效的火山引擎 APP ID 和 Access Token
4. **处理时间**：根据视频长度和网络状况，处理时间可能会有所不同
5. **部署环境**：
   - 前端：GitHub Pages（静态网站）
   - 后端：Vercel Serverless Functions（无服务器函数）

## 本地开发

### 安装依赖
```bash
# 前端无需依赖

# 后端依赖
pip install -r api/requirements.txt
```

### 本地运行
1. 启动本地 Flask 服务器：
```bash
python api/upload.py
```

2. 访问 `http://localhost:5000` 查看前端页面

### 测试 API
运行测试脚本：
```bash
python test_api.py
```