news 2026/10/17 6:39:48

LTX-2新手必读:模型目录结构逐文件详解,避开90%的放置错误

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
LTX-2新手必读:模型目录结构逐文件详解,避开90%的放置错误

【免费下载链接】ltx-2

项目地址:https://ai.gitcode.com/hf_mirrors/Comfy-Org/ltx-2
点击查看免费下载

LTX-2 是 Comfy-Org 为 ComfyUI 重新打包的模型仓库,包含 Gemma 3 12B 文本编码器(4 种精度)和 3 个 LoRA 文件。本文逐文件详解模型目录结构,告诉你每个文件应该放到 ComfyUI 的哪个文件夹,避开最常见的放置错误。

📦 项目速览:LTX-2 仓库里有什么

项目说明
用途为 ComfyUI 提供 LTX-2 工作流所需的文本编码器与 LoRA
基础模型google/gemma-3-12b-it、mlabonne/gemma-3-12b-it-abliterated
许可协议ltx-2-community-license-agreement(非 Apache/MIT,商用前请自行确认)
文件数量7 个.safetensors文件,分属 2 个目录

详细说明见 README.md。

🗂️ 模型目录结构一图看懂

整个仓库所有模型都放在split_files/下,按用途分为两个子目录:

📂 ltx-2/ ├── 📂 split_files/ │ ├── 📂 loras/ ← 对应 ComfyUI 的 models/loras │ │ ├── gemma-3-12b-it-abliterated_heretic_lora_rank64_bf16.safetensors │ │ ├── gemma-3-12b-it-abliterated_lora_rank64_bf16.safetensors │ │ └── ltx2-squish.safetensors │ └── 📂 text_encoders/ ← 对应 ComfyUI 的 models/text_encoders │ ├── gemma_3_12B_it.safetensors │ ├── gemma_3_12B_it_fp4_mixed.safetensors │ ├── gemma_3_12B_it_fp8_scaled.safetensors │ └── gemma_3_12B_it_fpmixed.safetensors

核心规则只有一条:loras/下的文件全部去models/loras,text_encoders/下的文件全部去models/text_encoders,文件夹名和文件名都不能动。

🔤 text_encoders/ 目录详解:4 种 Gemma 3 文本编码器

这 4 个文件是同一个 Gemma 3 12B 模型的不同量化版本,只需按显存大小挑一个,不需要全部下载。

1️⃣ 全精度版:gemma_3_12B_it.safetensors

  • 大小:约22.7 GB
  • 精度:bf16 全精度
  • 适用:24 GB 及以上显存的"旗舰级"显卡
  • 效果最好,但也是最吃显存和硬盘的选择

2️⃣ FP8 缩放版:gemma_3_12B_it_fp8_scaled.safetensors

  • 大小:约12.3 GB
  • 精度:fp8 缩放量化
  • 适用:16 GB 显存的常见选择,容量与显存平衡最佳

3️⃣ 混合精度版:gemma_3_12B_it_fpmixed.safetensors

  • 大小:约12.8 GB
  • 精度:fp 混合量化
  • 适用:16 GB 显存,是 fp8_scaled 的另一种量化方案

4️⃣ FP4 混合版:gemma_3_12B_it_fp4_mixed.safetensors

  • 大小:约8.8 GB
  • 精度:fp4 混合量化
  • 适用:12 GB 甚至更低显存的小显存救星,体积最省

💡一句话选型:显存 ≥24G 选全精度;16G 选 fp8_scaled 或 fpmixed;显存紧张选 fp4_mixed。

🧲 loras/ 目录详解:3 个 LoRA 文件分别做什么

LoRA 是训练好的小型权重附加模块,配合主模型使用,体积都很小。

1️⃣ gemma-3-12b-it-abliterated_lora_rank64_bf16.safetensors

  • 大小:约599 MB,rank 64,bf16 精度
  • 来源:mlabonne 的 Gemma 3 12B abliterated("去审查")微调版本
  • 作用:让文本编码器在更不受限的语义空间里工作

2️⃣ gemma-3-12b-it-abliterated_heretic_lora_rank64_bf16.safetensors

  • 大小:约599 MB,rank 64,bf16 精度
  • 作用:abliterated 版本的 heretic 变体 LoRA,与前一个互为替代方案

3️⃣ ltx2-squish.safetensors

  • 大小:约408 MB
  • 来源:ovi054 的 LTX-2-19b-Squish-LoRA
  • 触发词:squish it(写提示词时带上,效果才会生效)

⚠️ 两个 abliterated LoRA 是二选一的关系,不需要同时加载;ltx2-squish 则与它们用途不同,按需搭配。

📁 ComfyUI 正确放置路径(官方对照表)

官方指定放置位置如下,直接照抄即可:

源文件(仓库内路径)目标位置(ComfyUI 内)
split_files/text_encoders/ 全部 4 个文件ComfyUI/models/text_encoders/
split_files/loras/ 全部 3 个文件ComfyUI/models/loras/
📂 ComfyUI/ └── 📂 models/ ├── 📂 loras/ ← 3 个 LoRA 放这里 └── 📂 text_encoders/ ← 4 个文本编码器放这里

放好后在 ComfyUI 里刷新模型列表,即可在"加载文本编码器"和"加载 LoRA"节点中按文件名找到它们。

❌ 常见放置错误清单:这 5 个坑最多人踩

  1. 文本编码器丢进models/checkpoints—— Gemma 3 不是大模型 checkpoint,放那里 ComfyUI 根本不会识别,请放models/text_encoders。
  2. LoRA 和文本编码器放反—— 看名字里的lora字样就懂了:带lora的进models/loras,带gemma_3_12B_it前缀的进models/text_encoders。
  3. 4 个量化版本全下、全放—— 同一模型的不同精度版本只保留一个即可,放多份只占 30GB+ 硬盘,节点里选哪个加载哪个。
  4. 改了文件名再放入—— 工作流中按原始文件名引用模型,改名后工作流会报"模型未找到"错误,保持 README.md 中的原始命名。
  5. 忘了 squish LoRA 的触发词—— 加载了ltx2-squish.safetensors却在提示词中不写squish it,等于白挂。

🚀 快速开始:一键下载 LTX-2 模型

git lfs install git clone https://gitcode.com/hf_mirrors/Comfy-Org/ltx-2

提示:仓库中的.safetensors通过 Git LFS 存储,如果 clone 下来只有几百字节的文件,说明 LFS 没有生效,执行git lfs pull补全即可。

clone 完成后,把split_files/loras/里的 3 个文件复制到 ComfyUI 的models/loras/,split_files/text_encoders/里按显存挑一个文件复制到models/text_encoders/,整个 LTX-2 的模型放置就完成了。🎉

【免费下载链接】ltx-2

项目地址:https://ai.gitcode.com/hf_mirrors/Comfy-Org/ltx-2
点击查看免费下载

相关推荐

上一篇:WorkshopDL:打破平台壁垒,一键下载Steam创意工坊模组
下一篇:AlgoNote 题解精讲:LeetCode 0688 骑士在棋盘上的概率 —— 概率动态规划(概率 DP)实战解析

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/10/17 6:39:44

接口自测四维体系:人、数据、环境、行为的工程化实践

1. 为什么“接口自测”不是测试工程师的专属动作,而是每个写接口的人必须亲手按下的确认键“接口自测”这四个字,在很多团队里被默认划归到测试同学的待办清单里——开发写完代码,提个PR,等测试用Postman点几下、看几个状态码&…

作者头像 李华
网站建设 2026/10/17 6:39:21

从实验室预研到高端装备现场:工业操作系统的进阶逻辑

问题的起点:让机器"精确听话" 工业操作系统最初要回答的问题其实很朴素——机器人、轨道列车、高端装备等设备,能不能在极其严苛的时间窗口内,不差分毫地执行每一条指令。 它与消费级操作系统走的是完全不同的路。手机系统偶尔卡顿…

作者头像 李华
网站建设 2026/10/17 6:39:03

自动驾驶路径跟踪中的模型预测控制:从原理到仿真实践

作为常年跟自动驾驶控制算法打交道的人,我最早接触模型预测控制(MPC,Model Predictive Control)时,第一反应其实是有点抗拒的。这玩意儿理论门槛不低,矩阵求逆、约束优化、实时性调优,每一项都够…

作者头像 李华
网站建设 2026/10/17 6:36:56

sudo-rs sudoers 配置实践指南:从写规则到安全护栏

sudo-rs sudoers 配置实践指南:从写规则到安全护栏 【免费下载链接】sudo-rs A memory safe implementation of sudo and su. 项目地址: https://gitcode.com/GitHub_Trending/su/sudo-rs 你给运维同事开 sudo 权限时,是只开一条命令,…

作者头像 李华
网站建设 2026/10/17 6:35:49

Claude Code模板实战:用CLAUDE.md与斜杠命令打造高效AI编程助手

在终端里折腾 Claude Code 的这大半年,我慢慢意识到一个事儿:真正决定 AI 编程助手是“玩具”还是“同事”的,往往不是模型本身,而是你怎么给它交代工作。Claude Code 提供了一套非常灵活的环境控制机制,比如项目级的 …

作者头像 李华