# LTX-2.5（视频模型）

> LTX-2.5，本地运行：根据文本或起始图像生成带同步声音（语音、音效、环境声）的短视频片段，适用于预告镜头、过场动画草稿和动态关键美术。最长 5 秒，1280x704，24 fps。需要显存 16 GB 及以上的 NVIDIA GPU 和 48 GB 内存。LTX-2.x 社区许可证：年收入低于 1000 万美元可免费使用。

- ID: `aigd.video-ltx25`
- 来源: 官方 (第一方 `aigd.*`)
- 分类: 视频
- 发布者: AI Game Dev (`aigd`), 已验证
- 最新版本: 1.0.6 (发布于 2026-11-22)
- 许可证: SEE LICENSE IN README.md
- 需要 AI Game Dev 应用: `>=0.25.11`
- 原生代码: 否
- 评分: 暂无评分
- HTML 页面: https://ai-game.dev/zh-hans/packages/aigd.video-ltx25

## 安装

使用 gamedev CLI，在项目文件夹中运行：

```bash
gamedev pkg add aigd.video-ltx25
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.video-ltx25`，然后点击 **Add to Project**。更多：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 发布时间 | 需要应用 | 备注 |
|---|---|---|---|
| 1.0.6 | 2026-11-22 | `>=0.25.11` | 最新 |
| 1.0.5 | 2026-11-06 | `>=0.25.11` | - |
| 1.0.4 | 2026-11-01 | `>=0.25.11` | - |
| 1.0.2 | 2026-10-13 | `>=0.25.0` | - |
| 1.0.1 | 2026-10-12 | `>=0.25.0` | - |

## 描述

````markdown
# LTX-2.5 (`aigd.video-ltx25`)

**LTX-2.5** 是 Lightricks 推出的视频模型，可根据文本提示或起始图像（图生视频）生成带**同步声音**的短片——语音、音效和环境声。在 AI Game Dev 中，它通过**本地图像与视频生成**（[`aigd.sdcpp`](https://ai-game.dev/packages/aigd.sdcpp) 1.1 或更新版本）在你自己的 NVIDIA GPU 上本地运行，因此生成片段不花分文，也绝不会离开你的电脑。在能满足其配置要求的电脑上，它是默认的视频模型。它适合希望为预告片、先导片、过场动画草稿和社交媒体内容制作带声音的影视感、写实或风格化片段的游戏开发者。

## 可以做什么

- 带镜头运动和声音的预告片与先导片镜头。
- 过场动画和分镜草稿，包括会说话的角色。
- 让静态关键美术图或截图动起来（图生视频）。
- 用于菜单或商店页面的短氛围片段，带音效和背景声。

## 示例请求

- “制作一段 5 秒片段：黎明时分缓慢推轨穿过雾气弥漫的森林，鸟鸣与远处的风声。”
- “让这张关键美术图动起来：主角转向镜头说‘大门已开。’”（来自你的图像）
- “一段 2 秒的镜头：飞船跃入超空间，伴随低沉的引擎轰鸣。”
- “电影感的特写：铁匠锤打发光的剑刃，火星四溅，金属铿锵。”

## 亮点

|  |  |
|---|---|
| 模型 | LTX-2.5 22B，蒸馏版（8 步），GGUF Q4_K_M |
| 操作 | 文生视频、图生视频（起始图像） |
| 声音 | 同步音频：语音、音效、环境声 |
| 默认片段 | 1280×704，49 帧（约 2 秒），24 帧每秒 |
| 限制 | 最长 5 秒（121 帧），每边 256–1280 像素（32 的倍数） |
| 输出 | WebM（VP8 视频，带 16 kHz 音轨）；可按需输出无声的动态 WebP |
| 文本编码器 | Lightricks 对 Gemma 4（12B）的微调版 |
| 许可证 | LTX-2.x 社区许可证：年收入低于 10,000,000 美元可免费使用 |

## 适用电脑

| 电脑 | 一段 1280×704 的片段（2 秒 / 5 秒；5 秒为图生视频） |
|---|---|
| 显存 16 GB 及以上的 NVIDIA GPU **以及** 48 GB 内存（CUDA） | 约 2 分钟 / 3 分钟；5 分钟 |

在配备 64 GB 内存的 RTX 4090 上测得。仅为估算，并非保证。模型权重常驻内存，按需移至 GPU：一段 2 秒片段在 13.5 GiB 的 GPU 预算内完成（GPU 上约占用 14.3 GB，内存约占用 38 GB）。当 GPU 显存不足时，应用会以更小的预算重试该片段。

无法满足这些要求的电脑会改用 [Wan 2.2 TI2V 5B](https://ai-game.dev/packages/aigd.video-wan22-ti2v-5b)：它需要更少的内存（12 GB 显存、16 GB 内存），且采用 Apache-2.0 许可证，但它生成的片段没有声音，而且慢好几倍。

## 如何使用

在会话的 Tools 中开启 **Video**，智能体就能生成片段。图像和片段与图像模型共用同一个 GPU 队列（见 [本地图像与视频生成](https://ai-game.dev/packages/aigd.sdcpp)）。

## 下载

此包只包含数据。它指明模型文件；应用会在你确认后下载它们，用 sha256 逐一校验，并在你的电脑上用 stable-diffusion.cpp 运行。

43.8 GB，四个文件，每个都固定到某个 Hugging Face 提交：

| 文件 | 来源 | 大小 |
|---|---|---:|
| `ltx-2.5-22b-distilled-transformer-Q4_K_M.gguf`（视频模型，蒸馏版，8 步） | [`vantagewithai/LTX-2.5-GGUF`](https://huggingface.co/vantagewithai/LTX-2.5-GGUF) | 15.7 GB |
| `gemma4-12b-with-proj-ltx-2.5-bf16.safetensors`（文本编码器） | [`comfyicu/LTX-2.5`](https://huggingface.co/comfyicu/LTX-2.5) | 26.3 GB |
| `ltx-2.5-video-vae-conv-bf16.safetensors`（视频自编码器） | [`comfyicu/LTX-2.5`](https://huggingface.co/comfyicu/LTX-2.5) | 1.45 GB |
| `ltx-2.5-audio-vae-bf16.safetensors`（音频自编码器） | [`comfyicu/LTX-2.5`](https://huggingface.co/comfyicu/LTX-2.5) | 365 MB |

官方仓库（`Lightricks/LTX-2.5`）要求每位用户登录并接受其条款，因此这些文件来自同一模型的公开镜像。

## 许可证

**LTX-2.x 社区许可证**（[全文](https://github.com/Lightricks/LTX-2/blob/main/LICENSE-2_x)）。

- 个人以及**年收入低于 10,000,000 美元**的组织可免费使用。达到或超过该数额时，商业使用需向 Lightricks 购买付费许可证（ltxv-licensing@lightricks.com）。
- Lightricks 不对你制作的片段主张任何权利；你对它们的使用方式负责。
- 许可证的使用限制（其附件 A）适用于所有使用情形。

组件：

- LTX-2.5 © Lightricks —— GGUF 来自 [`vantagewithai/LTX-2.5-GGUF`](https://huggingface.co/vantagewithai/LTX-2.5-GGUF)，自编码器和文本编码器来自 [`comfyicu/LTX-2.5`](https://huggingface.co/comfyicu/LTX-2.5) —— 全部遵循 LTX-2.x 社区许可证。
- 文本编码器是 Lightricks 对 Gemma 4 的微调版（© Google，Apache-2.0）。

所有文件均从 Hugging Face 下载。AI Game Dev 不托管也不重新分发这些文件。
````
