# VideoTranslator

**Repository Path**: crazyants/video-translator

## Basic Information

- **Project Name**: VideoTranslator
- **Description**: 音视频翻译,这个效果不怎么好,就这么放着吧
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视频实时翻译 - Video Translator

一个基于 Vue 3 + Vite 的在线视频翻译工具，支持上传视频后自动识别语音并翻译生成双语字幕。

## 功能特性

- 视频上传预览（支持拖拽上传）
- 使用 FFmpeg.wasm 在浏览器端提取音频
- **本地 ASR**：使用 Transformers.js 在浏览器运行 Whisper（完全离线）
- **API ASR**：支持任何兼容 OpenAI 格式的语音识别 API
- 翻译服务：支持任何兼容 OpenAI 格式的翻译 API
- 实时双语字幕显示
- 字幕导出（VTT、SRT 格式）
- 本地存储 API 设置

## 快速开始

### 1. 安装依赖

```bash
npm install
```

### 2. 启动开发服务器

```bash
npm run dev
```

### 3. 访问应用

打开终端显示的地址，通常是 `http://localhost:5173`

## 语音识别 (ASR) 说明

### 方式一：本地运行（推荐）

使用 Transformers.js 在浏览器运行 Whisper，**完全免费、离线**。

#### 模型存放位置

```
public/models/
├── whisper-tiny/     # 下载模型文件放这里
│   ├── model.onnx
│   ├── config.json
│   └── ...
├── whisper-base/
└── whisper-small/
```

#### 模型下载

**详细说明请查看 [MODELS.md](./MODELS.md)**

| 模型 | 大小 | 下载地址 |
|------|------|----------|
| whisper-tiny | ~40MB | [Xenova/whisper-tiny](https://huggingface.co/Xenova/whisper-tiny) |
| whisper-base | ~70MB | [Xenova/whisper-base](https://huggingface.co/Xenova/whisper-base) |
| whisper-small | ~240MB | [Xenova/whisper-small](https://huggingface.co/Xenova/whisper-small) |

**注意**：Hugging Face 在国内可能需要科学上网才能访问。

### 方式二：API 调用

使用第三方语音识别 API，需要配置 API URL 和 Key。

## API 配置

### 语音识别 API (ASR)

| 字段 | 说明 | 示例 |
|------|------|------|
| API URL | 接口地址 | `https://api.example.com/v1/audio/transcriptions` |
| API Key | 密钥 | `sk-xxx...` |
| 模型 | 模型名称 | `whisper-1` |

### 翻译 API

| 字段 | 说明 | 示例 |
|------|------|------|
| API URL | 接口地址 | `https://api.siliconflow.cn/v1/chat/completions` |
| API Key | 密钥 | `sk-xxx...` |
| 模型 | 模型名称 | `Qwen/Qwen2.5-7B-Instruct` |

## 项目结构

```
videoTranslator-online-z/
├── src/
│   ├── App.vue          # 主组件
│   ├── main.js          # 入口文件
│   └── style.css        # 全局样式
├── public/
│   └── models/          # 本地 ASR 模型存放目录
├── index.html
├── vite.config.js       # Vite 配置
├── package.json
├── README.md            # 项目说明
└── MODELS.md            # 模型下载详细说明
```

## 支持的视频格式

- MP4、WebM、MOV、AVI 等浏览器支持的视频格式

## 技术栈

- Vue 3 - 前端框架
- Vite - 构建工具
- FFmpeg.wasm - 音频提取
- Transformers.js - 本地 ASR
- WebVTT - 字幕格式

## 注意事项

1. **本地 ASR**：需要先下载模型文件到 `public/models/` 目录
2. **API 模式**：需要配置对应服务的 API Key
3. **视频大小**：建议使用较小的视频文件（< 100MB）

## 许可

MIT License