Kdenlive 如何用 Whisper 从时间线生成字幕？

教程目标

用 Kdenlive 的 Whisper 语音识别为剪辑中的对白生成字幕，再检查字幕内容与时间轴。适合访谈、课程或演示视频的初稿字幕；识别结果仍需人工校对。

适用环境

本文按 Kdenlive 26.08 官方手册整理。RJ.tools 当前 Kdenlive 条目标注版本 26.08.1，手册页面属于 26.08 系列，未说明每个步骤均对应 26.08.1 的精确补丁构建。以下以 Windows 桌面版为例；Kdenlive 的菜单可能因平台或界面语言不同而略有差异。本教程未在 26.08.1 或 Windows 上实机测试。

准备工作

• 安装 Kdenlive，并准备已导入项目、含清晰对白的音频或视频片段。
• 语音转文字配置需要 Python 3。Kdenlive 手册的 Windows 说明要求从 Python 官方下载页安装，并勾选 Add python.exe to PATH。
• 首次切换到 Whisper 时，Kdenlive 需要安装缺失依赖；官方手册提到下载约 2 GB。还需下载语音模型，手册推荐可下载约 1.4 GB 的 Turbo 模型。预留网络流量、磁盘空间和等待时间。
• 先保存项目。生成字幕会在项目时间线中新增字幕内容。

配置 Whisper 和模型

1. 打开 Kdenlive 设置中的 Configure Kdenlive（配置 Kdenlive）> Speech To Text（语音转文字）。也可从 Speech Editor 小组件的菜单进入该设置。
2. 在语音识别引擎中选择 Whisper。按界面提示安装缺失依赖；首次安装会下载文件，等待配置流程完成。
3. 在模型管理区域下载一个适合音轨语言的 Whisper 模型。模型大小与识别能力不同；如果选择 Turbo，请确认磁盘空间和下载量可接受。
4. 查看模型状态，确认所选模型已安装。遇到配置问题时使用页面提供的 Check configuration（检查配置），按显示的缺失项处理。

从时间线生成字幕

1. 在项目中确认要识别的片段已放到时间线，并检查音轨包含目标对白。
2. 如果还没有字幕轨，在时间线工具栏点击 Edit Subtitle Tool（编辑字幕工具） 图标以打开字幕轨。
3. 点击时间线的 Speech recognition（语音识别） 按钮，打开自动字幕对话框。
4. 选择处理范围：使用时间线区域，或选择只处理选中的片段。若需要限制时间线区域，可用 I 和 O 标记入点与出点；开始前核对范围，避免识别整个项目。
5. 选择 Whisper 模型。语言默认可为 Autodetect；如果自动识别语言不准确，改选音轨的实际语言。按需设置每行最大字符数。
6. 点击 Process（处理） 开始识别。按项目长度、设备性能和模型大小等待处理完成。
7. 检查字幕轨是否出现字幕条目，并逐段核对文字、断句与时间位置。修正专有名词、数字和识别错误后保存项目。

预期结果

自动字幕处理完成后，Kdenlive 会把识别生成的字幕插入字幕轨。生成的文字是待校对结果，不等于准确转写；是否达到发布质量取决于音质、语言、专有词和人工检查。

常见问题与处理

Whisper 依赖或模型还在下载

首次安装依赖或模型可能需要较长时间。保持 Kdenlive 配置或处理窗口打开，等待进度结束；不要在仍显示下载或初始化时强制关闭。确认网络和剩余磁盘空间后，再查看模型状态。

识别出的语言不对

在自动字幕对话框中把 Autodetect 改成音轨实际语言，再检查模型是否适用于该语言。重新生成前先确认选择的时间线区域或片段。

只想识别选中的片段

在自动字幕对话框选择仅处理所选片段；若要处理连续片段范围，则设置时间线区域并复核入点、出点。两种范围不要混用。

处理完成却没看到字幕

确认字幕轨已通过 Edit Subtitle Tool 打开，检查项目中是否有可识别的音轨，并再次核对自动字幕的处理范围。官方手册没有承诺静音片段会生成字幕；保留当前项目并查看 Kdenlive 的配置检查结果。

来源与核验范围

• Kdenlive 官方《Speech to Text》26.08 手册：https://docs.kdenlive.org/en/effects_and_filters/speech_to_text.html
• Kdenlive 官方《Plugins / Speech To Text》26.08 手册：https://docs.kdenlive.org/en/getting_started/configure_kdenlive/configuration_plugins.html
• RJ.tools Kdenlive 软件页（当前条目版本和软件关联）：https://www.rj.tools/resources/kdenlive
• 核验日期：2026-10-17（Asia/Shanghai）。步骤、配置要求和下载量依据官方手册整理；未安装依赖、下载模型、运行 Whisper 或实测字幕生成。