⚙️ VideoNote 模型与语音转写配置教程

本文默认你已经安装好 VideoNote 并进入了主界面。如果你是第一次使用，请按下面方式启动：

• 安装版：从开始菜单或桌面快捷方式启动 VideoNote。

在主界面右上角，点击齿轮图标即可进入「设置」页面。

1. 找到页面右上角 ⚙️ 设置 图标（鼠标悬停会显示“设置”）。
2. 点击进入后，会看到一排标签页：AI 模型配置、语音转文字、模型下载、环境检测、文件清理、导出记录、关于。

2.1 认识模型列表

进入「设置 → AI 模型配置」，你会看到已经添加好的模型卡片。卡片上显示：

• 自定义名称：方便你识别，例如「DeepSeek V3」。
• 模型 ID：实际调用时使用的模型名，例如 deepseek-chat。
• 当前使用：绿色标签，表示这是当前生效的模型。
• 测试：点击后立即验证 API Key 和 Base URL 是否可用。

2.2 添加新模型

点击「+ 添加模型供应商」，会展开表单。系统已内置 6 家主流供应商的预设，你只需要填 API Key，其它字段会自动带出来：

填写步骤：

1. 点击上方预设按钮选择供应商（如 DeepSeek）。
2. 在「API Key」处粘贴你从官网申请的密钥。
3. 检查「API Base URL」是否正确，一般不用改。
4. 「选择模型」默认已填好，如果你想换其它模型，可以手动输入或点击「获取模型」让系统自动拉取可用列表。
5. 「自定义名称」可选，建议填一个好记的名字，例如「DeepSeek V3」。
6. 点击右下角 保存。

2.3 测试模型连通性

保存后模型会出现在列表里。先点击卡片右侧的 测试 按钮：

• 显示 ✓ 连接成功：说明 Key 有效，可以开始使用。
• 显示 ✗ API Key 无效 (401)：Key 复制错了，或余额不足。
• 显示 ✗ 无法连接服务器：Base URL 填错，或网络不通。

2.4 多模型切换

你可以同时添加多个供应商。想换哪个用，就在对应卡片上点击 启用。同一时间只有 一个 模型处于「当前使用」状态，系统会按这个模型生成笔记。

VideoNote 需要先把视频里的声音转成文字，再交给 AI 总结。进入「设置 → 语音转文字」，选择一种引擎即可。

3.1 已有引擎列表

3.2 添加在线引擎（Groq 示例）

如果你选择 Groq：

1. 点击「+ 添加转写引擎」。
2. 选择 Groq (在线)。
3. 填入 Groq API Key（形如 gsk_xxxxxxxx...）。
4. 点击 保存，然后点击 启用 使其生效。

3.3 添加本地引擎 Fast-Whisper

如果你选择本地转写，不需要 Key，但需要选一个模型大小。首次使用时会自动从国内镜像下载模型文件。

1. 点击「+ 添加转写引擎」。
2. 选择 Fast-Whisper (本地)。
3. 在「模型大小」下拉框里选择档位：

• tiny：约 75MB，速度最快，准确率一般，适合快速体验。
• base：约 145MB，速度较快，准确率较好，推荐日常使用。
• small：约 486MB，准确率进一步提升。
• medium：约 1.5GB，更准但更慢。
• large-v3：约 3GB，最准也最慢，适合对质量要求高的场景。

如果你选了 Fast-Whisper 本地引擎，除了默认已内置的 tiny，还可以在「设置 → 模型下载」里下载其它档位。下载源是 HuggingFace 国内镜像，速度通常很快。

1. 切换到「模型下载」标签。
2. 看到「语音转文字模型」列表，选择需要的档位。
3. 点击右侧 下载 按钮，等待进度条走到 100% 并显示「已安装」。

配置完成后，点击左上角「返回」箭头回到主界面：

1. 在「视频链接」输入框粘贴 B站 / YouTube / 抖音 / 快手 / 小红书 等链接。
2. 选择想要的「笔记格式」（结构化、大纲、思维导图、时间线）。
3. 选择「AI 摘要风格」（均衡、学术、口语等）。
4. 勾选「插入截图」「原片跳转链接」等需要的选项。
5. 点击「开始生成」，等待进度条跑完。

Q1：点击「测试」提示 401 Unauthorized？

说明 API Key 无效或已被吊销。请重新到对应平台官网复制 Key，注意不要把空格、换行也复制进去。

Q2：点击「测试」提示“无法连接服务器”？

检查 Base URL 是否完整，必须包含 /v1 结尾。另外确认你的电脑能访问该域名（部分公司网络会拦截海外 API）。

Q3：可以只配一个模型、不配转写引擎吗？

可以。如果视频本身带平台字幕，VideoNote 会优先使用字幕，跳过语音转写。但没有转写引擎的话，无字幕视频会报错。

Q4：Groq 和 OpenAI Whisper 哪个更好？

Groq 免费额度大、速度快，推荐作为首选；OpenAI Whisper 适合已经有 OpenAI Key 的用户。两者都能自动返回带时间戳的文本。

Q5：Fast-Whisper 模型下载到哪个文件夹？

默认在 VideoNote/backend/models/ 下，形如 faster-whisper-base 的目录。模型文件下载一次即可永久离线使用。

Q6：切换模型后需要重启软件吗？

不需要。点击「启用」后立即生效，下一条笔记就会用新模型生成。

Q7：生成笔记时还是报错“未配置 AI 模型”？

请确认：①模型已添加；②已点击「启用」；③测试显示「连接成功」。三个条件缺一不可。