24GB Mac 也能免费生成音视频ltx-2.5-mlx-q8 新手入门教程附环境要求清单ltx-2.5-mlx-q8是 LTX-2.5 音视频生成模型的 MLX 量化版本专为 Apple Silicon 优化只需将 Gemma 文本编码器从 bf16 量化到 int8整套模型在 24GB 统一内存的 Mac 上就能完整跑通本地免费生成带声音的视频。本文将带你从零理清环境要求、看懂每个权重文件的用途并给出一套可落地的运行方案。一、它是什么为什么 24GB Mac 也能跑 LTX-2.5 是 Lightricks 发布的文生视频Text-to-Video大模型原生支持音视频同步生成Text-to-Video Audio。它的组件很多文本编码器、DiT 扩散主干、VAE 编解码器、vocoder 音频合成器、上采样器等。问题在于bf16 精度的 Gemma 文本编码器会撑出约24.8GB 的显存下限直接超预算。而本项目 README.md 给出的解法非常克制——只把文本编码器量化到 int8组件bf16 原版本项目int8Gemma 文本编码器体积23.8 GB13.6 GB整段生成峰值内存~24.8 GB超预算14.6 ~ 15.4 GB✅量化参数为int8、分组大小 64且刻意保留了embed_tokens层为 bf16以保住条件信号的质量。README 中给出的保真度指标有效 token 位置的 connector 输出与 bf16 基线相比达到0.999820在盲测 A/B 对比中被判定为可接受。⚠️ 注意量化后输出与 bf16 版本不是逐位一致——这是另一条同样有效的生成轨迹不要拿 SSIM/PSNR 这类指标去对比两版输出。二、环境要求清单对照检查开始之前先对照下面这张表确认自己的机器项目要求说明硬件Apple SiliconM 系列芯片本模型基于 MLX 框架仅适配 Mac统一内存24 GB最低峰值约 14.6~15.4GB24GB 可留足余量32GB 机器同样适用峰值约 15.4GB系统较新版本的 macOS保证 MLX 与驱动正常磁盘空间建议预留 40GB含完整组件树与下载的 DiT使用许可个人/非商业免费年收入 ≥ 1000 万美元的公司商用需付费授权一个关键认知本仓库只包含int8 编码器 配套组件不包含量化版 DiT。DiT 是独立的另一条技术路线托管在mlx-community/ltx-2.5-mlx-ditq8你可以把 int8 编码器与 bf16 或 int8 的 DiT 自由组合int8 编码器 bf16 DiT 也是合法搭配。三、文件结构速览每个权重是干什么的 这个仓库是一棵自洽的完整组件树主要文件及职责如下gemma4-12b-ltx-v1/⭐核心主角Gemma-4 12B 文本编码器int8 量化分片为model-00001-of-00003.safetensors等 3 个分片另有 config.json 可看到bits: 8, group_size: 64的量化配置connector.safetensors文本特征连接器负责把编码器 49 个隐藏状态中的有效 token 传给 DiTvae_encoder.safetensors/ vae_decoder.safetensors视频 VAE 的编码/解码vae_diffusion_decoder.safetensors扩散式解码器vae_decoder_pruna.safetensorsPrunaAI 的精简版视频解码器可选加速件见下文audio_vae.safetensors / vocoder.safetensors音频 VAE 与音频合成器声音就是从这里长出来的spatial_upscaler_x2_v1_1.safetensors空间 2 倍上采样器提升分辨率配置见 spatial_upscaler_x2_v1_1_config.jsontemporal_upscaler_x2_v1_0.safetensors时间 2 倍上采样器增加帧数配置见 temporal_upscaler_x2_v1_0_config.jsonduration_head.safetensors时长预测头config.jsonDiT 主干AVTransformer3DModel架构配置48 层、音视频双向交叉注意力embedded_config.json内嵌的 transformer 与调度器RectifiedFlowScheduler完整配置LICENSE.mdLTX-2 社区许可协议四、Pruna 解码器让 24GB 机器更从容的隐藏大招 ⚡README.md 用了一整节介绍 vae_decoder_pruna.safetensors它来自 PrunaAI 的 PrunaVAED是经过剪枝 蒸馏微调的即插即用版视频 VAE 解码器。收益很实在解码速度约快 2 倍实测整段生成墙钟时间−15.9%解码激活峰值大幅下降704×512×121 场景下从21.1GB 降到 14.5GB把原本超预算的运行拉回预算内画质几乎一致但非逐位精确在 Swift 推理端口中通过LTX2Configuration.vaeDecoderPath或环境变量LTX_VAE_DECODERpruna即可选用在 low 档位compact24、balanced32上已被设为默认解码器。文件附有 SHA-256 校验值下载后可自行校验完整性。五、新手上手四步走 确认机器达标对照上文环境清单重点确认 24GB 统一内存 Apple Silicon获取模型文件直接下载本仓库全部组件自洽的完整组件树git clone https://gitcode.com/hf_mirrors/mlx-community/ltx-2.5-mlx-q8同时按需获取 DiT 权重int8 版在mlx-community/ltx-2.5-mlx-ditq8bf16 版在mlx-community/ltx-2.5-mlx选择推理方案推荐使用支持本组件树的 MLX 推理端口如ltx-2-mlx-swift它会自动从本仓库读取 int8 编码器及配套文件并支持启用 Pruna 解码器小尺寸先跑通先用较小的分辨率和帧数验证全流程能出带声音的视频再逐步放大。记住峰值内存主要由编码器 DiT 流式化决定与视频几何尺寸关系不大README 实测256×256×9 与 512×288×121 的峰值几乎相同。六、许可协议免费但要看清边界 ⚖️本项目遵循LTX-2 Community License详见 LICENSE.md 与附带的使用政策快照 ltx-acceptable-use-policy-snapshot-2026-08-12.pdf。给新手划三个重点✅个人使用完全免费学习、实验、娱乐、个人创作均属非商业用途无需付费⚠️商业公司有门槛年收入 ≥ 1000 万美元的实体用于生产/营收场景必须购买商业授权再分发须传播条款二次分发或发布衍生权重时必须附带原许可与使用限制。七、常见问题 FAQ ❓Q124GB Mac 跑的时候风扇狂转、内存告警怎么办优先启用 Pruna 解码器LTX_VAE_DECODERpruna并确认 DiT 走流式加载路径——README 明确提示编码器量化与 DiT 流式化两个杠杆必须同时生效单独只开一个不解决问题。Q2为什么生成结果和 bf16 版看着像又不一样这是预期行为。换掉编码器会改变条件信号从而改变整条采样轨迹输出本来就是另一条合法轨迹。Q3能直接用来做商用产品吗不能开箱即用。个人非商业用途免费商业场景需按许可协议判断收入门槛 付费许可建议先阅读 LICENSE.md。Q4这个仓库里有 DiT 吗没有。README 特别强调本仓库不含量化 DiTDiT 在mlx-community/ltx-2.5-mlx-ditq8单独维护两轴独立、可自由混搭。总结ltx-2.5-mlx-q8 用只量化文本编码器这一最小改动把 LTX-2.5 的峰值内存从 ~24.8GB 压到14.6~15.4GB让 24GB 统一内存的 Mac 第一次真正免费跑起了音视频生成再配合 Pruna 解码器速度和内存还能再下一城。如果你正在用 Mac 做本地 AIGC这套小内存友好的组件树值得放进你的工具箱 ️。创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
