LTX Desktop 是一款开源桌面应用程序,用于使用 LTX 模型生成视频——在受支持的 Windows英伟达显卡上本地运行,并为不受支持的硬件和 macOS 提供 API 模式。
作为一个开源的桌面应用程序,它巧妙地平衡了极致隐私的本地运行与低门槛的云端 API两种模式,让不同硬件配置的用户都能参与到这场视频生成革命中。

目前项目处于 Beta 测试阶段,前端架构正在积极重构中,但这正是社区贡献和早期采用的最佳时机。
核心功能全景
LTX Desktop 提供了一个完整的视频创作工作流,远超简单的“文生视频”工具:
- 🎬 全模态生成:
- 文本到视频 (Text-to-Video):从创意描述直接生成动态影像。
- 图像到视频 (Image-to-Video):让静态图片动起来,支持更自然的运动控制。
- 音频到视频 (Audio-to-Video):根据声音节奏和氛围生成匹配画面。
- 视频重拍 (Video Re-shot/Editing):基于现有视频进行局部重绘或风格化修改。
- 🛠️ 专业编辑界面:内置时间轴、项目管理和预览窗口,支持多片段编辑与导出。
- 🔄 双模运行引擎:智能切换 本地生成模式 与 API 调用模式,最大化利用现有硬件。

硬件兼容性矩阵:你的电脑能跑吗?
LTX Desktop 对硬件有着明确的分级策略,请根据您的设备选择对应的运行模式:
| 平台 / 硬件配置 | 运行模式 | 核心说明 | 成本 |
|---|---|---|---|
| Windows + 英伟达显卡 (显存 ≥ 32GB, 支持 CUDA) | 🟢 本地生成模式 | 完全本地运行。下载模型权重,所有计算在本地 GPU 完成,无需联网生成。 | 免费 (仅需电费) |
| Windows (无 CUDA / 显存 < 32GB) | 🔵 仅 API 模式 | 本地仅作为客户端,计算在云端完成。需配置 LTX API Key。 | 付费 (按生成量计费) |
| macOS (Apple Silicon M1/M2/M3) | 🔵 仅 API 模式 | 受限于架构差异,目前仅支持通过 API 调用云端算力。需配置 LTX API Key。 | 付费 (按生成量计费) |
| Linux | ❌ 暂不支持 | 暂无官方构建版本。 | - |
⚠️ 注意:在 API 模式下,可生成的分辨率和时长可能受限于当前 API 服务的配额限制。

⚙️ 系统要求详解
🏆 本地生成模式 (Windows Only)
这是体验 LTX 全部潜力的“顶配”方案:
- 操作系统:Windows 10/11 (x64)
- 显卡:英伟达显卡,支持 CUDA,显存 ≥ 32GB (如 RTX 3090/4090 双卡或 A6000 等,显存越大越稳定)
- 内存:16GB+ (强烈推荐 32GB 以避免溢出)
- 存储:预留充足空间下载模型权重 (数十 GB) 及存储输出视频。
☁️ API 模式 (Windows & macOS)
适合大多数用户的“轻量”方案:
- Mac:Apple Silicon (arm64),macOS 13+ (Ventura)
- Windows:任意配置
- 网络:稳定的互联网连接
- 必需:LTX API 密钥
🔑 关键配置:API 密钥与成本解析
LTX Desktop 的灵活性体现在其分层的 API 使用策略上。理解这一点能帮您省钱甚至完全免费使用部分功能。
1. LTX API Key (必需/推荐)
您可以在 LTX 控制台免费生成一个 API Key。它的用途分为两类:
- ✅ 免费功能:云端文本编码 (Cloud Text Encoding)
- 作用:将您的自然语言提示词转换为模型能理解的 Embedding,并提供提示词增强。
- 优势:完全免费。即使您是本地运行用户,也强烈建议开启此功能。它能显著加速推理过程并节省本地显存。
- 隐私:提示词会发送至云端处理,但不会用于训练。
- 💰 付费功能:云端视频生成 (Cloud Video Generation)
- 适用场景:当您的硬件不支持本地运行时(如 Mac 用户或低显存 Windows 用户),必须使用此功能进行实际的视频渲染。
- 计费:按生成时长/分辨率计费。
2. 其他可选 API
- fal.ai Key:用于启用 Z Image Turbo 进行高质量的文本到图像生成(作为视频首帧)。
- Gemini Key:用于 AI 提示词建议功能,帮助优化您的创作灵感。
🔒 隐私提示:所有 API Key 均加密存储在本地应用数据文件夹中。使用云端功能时,您的提示词和媒体输入会被传输至服务器处理,请妥善管理敏感信息。
📂 安装与数据管理
安装步骤
- 前往 GitHub Releases 页面下载最新安装包。
- 安装并启动 LTX Desktop。
- 按照向导完成首次设置(接受模型许可条款)。
数据存储位置
应用的所有配置、日志及模型文件均存储在本地:
- Windows:
%LOCALAPPDATA%\LTXDesktop\ - macOS:
~/Library/Application Support/LTXDesktop/
⚠️ 空间预警:若选择本地模式,
models/文件夹将下载巨大的模型权重文件,请确保磁盘空间充足。
🏗️ 技术架构揭秘
对于开发者而言,LTX Desktop 是一个现代化的 Electron 应用典范:
- 渲染层 (Frontend):
- 基于 TypeScript + React 构建 UI。
- 通过
http://localhost:8000与本地后端通信。 - 利用 Electron Preload (
window.electronAPI) 安全地调用系统能力。
- 核心层 (Electron Main):
- 管理应用生命周期、原生文件对话框、FFmpeg 视频导出。
- 负责启动和管理 Python 后端进程。
- 安全沙盒:开启
contextIsolation,关闭nodeIntegration,确保渲染进程安全。
- 计算层 (Backend):
- 基于 Python + FastAPI 的本地服务器。
- 编排模型下载、GPU 调度及生成任务。
- 仅在必要时调用外部 API,实现混合云架构。
🔮 本地与云端的完美平衡
LTX Desktop 的出现,标志着开源视频生成工具链的成熟。它没有强迫所有用户购买昂贵的硬件,也没有将所有用户锁定在云端付费墙内。
- 对于拥有顶级显卡的极客,它提供完全免费、隐私安全的本地生产力工具。
- 对于Mac 用户和普通 PC 用户,它提供了低门槛接入顶级模型的 API 通道,且聪明的将“文本编码”这一高频操作免费化。















