10分钟上手Ascend-SACT/LTX-2：T2V与I2V推理完整流程

【免费下载链接】LTX-2项目地址: https://ai.gitcode.com/Ascend-SACT/LTX-2

Ascend-SACT/LTX-2是一款强大的文本到视频（T2V）和图像到视频（I2V）推理工具，能够帮助用户快速将文本描述或初始图像转换为高质量视频。本文将详细介绍如何在10分钟内完成环境配置并运行推理流程，让你轻松体验AI视频生成的魅力。

准备工作：环境配置与项目克隆

克隆项目仓库

首先，需要将项目代码克隆到本地。打开终端，执行以下命令：

git clone https://gitcode.com/Ascend-SACT/LTX-2 cd LTX-2

配置NPU环境

项目依赖Ascend NPU环境，通过运行环境配置脚本来自动设置所需环境变量：

source setup_env.sh

脚本会自动检测CANN工具包路径并配置动态库，成功后将显示NPU设备数量等信息。

核心功能体验：T2V文本到视频推理

快速运行默认推理

无需复杂配置，直接执行文本到视频推理脚本即可生成示例视频：

bash run_t2v.sh

脚本将使用默认参数（"A cat walking on a sunny beach, cinematic, golden hour"）生成一段25帧、25fps的视频，输出路径为./output/t2v_output.mp4。

自定义推理参数

通过环境变量自定义视频生成参数，例如修改提示词和输出分辨率：

PROMPT="A robot dancing in the rain, neon lights, cyberpunk style" HEIGHT=720 WIDTH=1280 bash run_t2v.sh

常用可配置参数包括：

• PROMPT：视频内容描述文本
• HEIGHT/WIDTH：输出视频分辨率（默认480×832）
• NUM_FRAMES：视频总帧数（默认25）
• FRAME_RATE：帧率（默认25）
• SEED：随机种子（默认42，固定种子可复现结果）

进阶应用：I2V图像到视频推理

使用默认首帧图像

I2V功能允许以图像作为首帧条件生成视频，执行以下命令体验：

bash run_i2v.sh

脚本默认使用./test/assets/single_person.jpg作为首帧，结合文本描述生成视频，输出路径为./output/i2v_output.mp4。

指定自定义首帧图像

通过IMAGE环境变量指定本地图像作为首帧：

IMAGE="/path/to/your/image.jpg" bash run_i2v.sh

首帧参数格式为PATH FRAME_IDX STRENGTH，其中：

• FRAME_IDX=0：将图像作为第0帧条件
• STRENGTH=1.0：完全保留首帧特征（值越小首帧影响越弱）

性能优化：应用性能补丁

项目提供了性能优化补丁，可提升NPU推理效率：

bash apply_perf_patches.sh

当前性能补丁包含RMSNorm算子NPU融合优化，位于perf_patches/perf-001-rmsnorm-npu-fusion.patch。

故障排除：常见问题解决

环境变量配置问题

若运行脚本时提示NPU设备未找到，检查CANN环境是否正确加载：

echo $CANN_HOME # 应显示CANN工具包路径 python3 -c "import torch_npu; print(torch_npu.npu.is_available())" # 应返回True

模型路径配置

默认模型路径为./models/，若需使用自定义模型路径，通过环境变量指定：

CKPT="/path/to/model.safetensors" GEMMA="/path/to/gemma-3-12b-it" bash run_t2v.sh

总结与下一步

通过本文介绍的步骤，你已成功完成Ascend-SACT/LTX-2的T2V和I2V推理流程。接下来可以尝试：

• 调整--num-inference-steps参数（默认10）提升视频质量（建议15-20步）
• 探索LoRA适配器功能（通过LORA环境变量加载微调权重）
• 查看test/run_i2v_verify.sh脚本了解验证流程

Ascend-SACT/LTX-2提供了简单易用的视频生成能力，无论是创意设计还是内容创作，都能帮助你快速将想法转化为生动的视频内容。

【免费下载链接】LTX-2项目地址: https://ai.gitcode.com/Ascend-SACT/LTX-2