ARTICLE · 1016330
ModelScope魔搭:手动下载模型本地GUI文本转视频
ModelScope魔搭:手动下载模型本地GUI文本转视频

ModelScope魔搭:手动下载模型本地GUI文本转视频
完全可以实现:模型手动下载到本地磁盘,不联网拉取权重,用Gradio/NiceGUI做Web‑GUI,输入提示词本地GPU推理生成视频。

硬件底线:NVIDIA显卡,显存≥10GB;16G显存运行更稳;CPU速度极慢不建议。

一、可选文生视频模型(ModelScope)
damo/text-to-video-synthesis | ||
Wan‑AI/Wan2.1‑T2V‑1.3B | ||
ZhipuAI/CogVideoX‑2B |
二、手动下载模型2种方式(离线可用)
方式1:modelscope SDK下载(推荐,断点续传)
pip install modelscope# 下载Wan2.1‑T2V‑1.3B到本地文件夹 ./wan21‑t2vmodelscope download --model Wan-AI/Wan2.1-T2V-1.3B --local-dir ./wan21-t2v下载完成后整个文件夹拷贝到离线机器,不再需要联网下载权重,加载时直接填本地路径
./wan21‑t2v。
方式2:网页手动浏览器下载
打开魔搭模型页面,点击文件,逐个下载全部文件,全部解压放入同一个本地文件夹。
⚠️必须完整下载全部文件,缺一个就推理报错。
三、最小可运行代码:本地模型 + Gradio GUI
关键点:
model="./wan21‑t2v"传入本地文件夹路径,不会联网请求魔搭服务器。
import gradio as grimport torchfrom modelscope.pipelines import pipelinefrom modelscope.utils.constant import Tasks# ==========重点:加载本地手动下载的模型,无网络下载==========pipe = pipeline( task=Tasks.text_to_video_synthesis, model="./wan21-t2v", # 本地模型文件夹路径 torch_dtype=torch.float16, device="cuda:0")defgenerate_video(prompt, height=480, width=832, steps=25): res = pipe({"text": prompt,"height": height,"width": width,"num_inference_steps": steps }) video_path = res[0]return video_path# 简易GUI界面demo = gr.Interface( fn=generate_video, inputs=[ gr.Textbox(label="输入提示词", placeholder="一只小猫在草地上奔跑"), gr.Slider(256,720,value=480,label="视频高度"), gr.Slider(256,1280,value=832,label="视频宽度"), gr.Slider(10,50,value=25,label="推理步数") ], outputs=gr.Video(label="生成视频"), title="ModelScope本地文生视频")if __name__ == "__main__": demo.launch(server_name="0.0.0.0", server_port=7860)运行后浏览器打开 http://127.0.0.1:7860,输入文字直接本地出视频。
四、如果你想用NiceGUI(你之前偏好)
逻辑完全一致,pipeline加载本地模型不变,把UI替换成NiceGUI组件即可。
五、现成完整WebUI项目(开箱即用)
modelscope‑text2video‑webui:Gradio封装damo/text‑to‑video‑synthesis,支持本地模型,Windows直接bat启动。
git clone https://github.com/mcmonkeyprojects/modelscope-text2video-webui.gitWan2.1官方自带gradio示例,模型目录指向手动下载的本地文件夹即可。 ComfyUI:导入魔搭下载好的模型权重,节点式GUI,适合调参,生态最强。
六、常见坑
不要填模型ID字符串,离线环境必须传本地文件夹路径。 模型文件必须完整,不要漏 .bin/.safetensors权重。显存不足:降低分辨率,使用 float16,开启模型cpu offload。ffmpeg缺失会无法合成mp4视频,Windows需要安装ffmpeg并且加到环境变量。
七、离线部署完整流程总结
有网机器用 modelscope download完整下载全部模型文件;拷贝整个模型文件夹到离线电脑; 安装依赖pytorch‑cuda、modelscope、gradio、ffmpeg; 代码中 model="本地模型文件夹路径",启动GUI;浏览器访问本地端口,输入文本,GPU本地生成视频,全程不访问魔搭网络。