Google Colab 免费 T4 · ComfyUI · 双 GGUF 低内存方案

在免费 T4 上运行 LTX-2.5 22B

主模型使用 unsloth/LTX-2.5-GGUF(distilled 8 步版),文本编码器使用 elix3r/gemma4-12b-with-proj-ltx-2.5-GGUF,视频解码默认使用轻量卷积 Conv VAE。页面下方已内置 文生视频 / 图生视频 / 首尾帧 三套已改好的 T4 专用工作流,下载后直接拖进 ComfyUI 即可运行,无需手动改节点。

开始前必做(2 分钟)

  1. Colab 菜单:代码执行程序 → 更改运行时类型 → T4 GPU。
  2. 登录 Hugging Face,分别打开下面两个仓库点击 Agree / 同意条款(均需授权,否则会报 401):
  3. 到 Hugging Face Token 页面 创建一个 Read 权限的 Token。
  4. 在 Colab 左侧 🔑「密钥」里新建 HF_TOKEN,填入 Token 并打开「笔记本访问权限」(也可在运行单元格 1 时直接粘贴)。
免费 T4 硬件边界与优化说明:
  • 免费 T4 只有 15GB 显存 / 12.7GB 系统内存。主模型必须用 distilled 8 步版(不要跑 dev 30 步)。
  • 官方工作流原本自带“4.8GB 提示词增强模型”和“两阶段 2 倍潜空间放大器”,在 T4 12.7GB 内存下极易崩溃。下方提供的 3 套 T4 专用工作流已自动移除这两部分,改用单阶段直出 + 分块 VAE 解码。
  • 默认参数为 608×352、2 秒(49 帧),跑通后可视内存情况微调至 736×416 或 3 秒。

1. 选择量化档位与 VAE(自动同步下方代码与工作流)

默认组合专为免费 Colab T4(12.7GB RAM)调优,兼顾稳定出片与清晰度。

预计下载总量
-
内存风险(12.7GB RAM)
-
搭配说明
-

2. 下载已适配 T4 的三种官方工作流

已基于 ComfyUI 官方 LTX-2.5 模板完成 T4 专项改造:替换为 UnetLoaderGGUF + CLIPLoaderGGUF、移除 4.8GB 提示词增强模型端口(彻底消除红框报错)、关闭高耗内存的两阶段放大器、保持官方高清 VAEDecodeTiled (512/64) 参数、将默认分辨率设为 608×352 / 2秒(49帧),并自动匹配你上方选择的模型文件名。

TEXT TO VIDEO

文生视频(T2V)

纯文字提示词生成带同步音效的视频。已内置防畸形反向提示词与 608×352 分辨率选择器。

IMAGE TO VIDEO

图生视频(I2V)

上传首帧图片让画面动起来。已将预处理限制边长从 1536 降为 768,避免大图爆显存。

FIRST & LAST FRAME

首尾帧生成视频(FLF2V)

上传首帧与尾帧两张图片,自动平滑过渡转场。已统一适配 GGUF 与 608×352 / 49 帧。

3. Colab 运行单元格

点击每个代码块右上角「复制」,在 Colab 新建代码单元格依次粘贴运行(纯 Python 编写,无需魔法命令)。

启动后使用流程

  1. 单元格 5 运行输出 https://xxxx.trycloudflare.com 后点击打开 ComfyUI 网页。
  2. 将上面下载的任意一个 .json 工作流文件直接拖入 ComfyUI 网页画布(如果运行了单元格 4 里的 Drive 导入,也可按 W 在列表中选择)。
  3. 若运行 I2V(图生视频) 或 FLF2V(首尾帧),记得在左侧的 Load First Frame / Load Last Frame 节点点击上传你自己的图片。
  4. 直接点击右上角 Run / Queue 即可开始生成(distilled 默认 8 步、CFG = 1)。
  5. 如需微调分辨率,宽高需为 32 的倍数;帧数需满足 帧数 = 秒数 × 帧率 + 1(或 帧数 % 8 == 1)。

常见问题排查

生成完一个视频后,系统内存(RAM)仍占 7~8GB 没释放,再生成第二个容易崩溃+
单元格 2 已自带 GGMLTensor.to("cpu") 零内存映射补丁;如果你要连续生成多个不同提示词的视频并防止内存累加,请在单元格 5 的 EXTRA_ARGS 中取消 "--cache-none" 的注释后重启单元格 5。
运行中途崩溃 / 控制台出现 ^C(RAM 12.7GB 耗尽)+
请在上方配置器将 DiT 降为 UD-Q2_K_XL 或 Q2_K,文本编码器降为 Q2_K,视频 VAE 选择 Conv VAE,然后点 Colab 菜单「代码执行程序 → 重启会话」重新运行。
输出视频全黑或出现 NaN 报错+
Tesla T4 原生不支持 bf16,部分 VAE 算子可能会溢出。将单元格 5 的 EXTRA_ARGS 中 "--fp32-vae" 取消注释后重新启动即可解决。
报错 Unexpected text model architecture type: 'gemma4'+
说明 Gemma4 GGUF 补丁未生效。请重新运行单元格 2,切勿在 ComfyUI Manager 中手动更新 ComfyUI-GGUF,否则会覆盖兼容补丁。
下载模型时报错 401 / 403+
请确保你已在浏览器登录 Hugging Face 并同意了 Lightricks/LTX-2.5 和 elix3r/gemma4-12b-with-proj-ltx-2.5-GGUF 两个仓库的许可协议,且 Token 拥有 Read 权限。