夜雨聆风学习资料网

ARTICLE · 1016330

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

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

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

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

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

一、可选文生视频模型(ModelScope)

模型ID
模型大小
特点
damo/text-to-video-synthesis
~17GB
初代文生视频,国内最早开源,短2‑4s视频
Wan‑AI/Wan2.1‑T2V‑1.3B
~7GB
通义万相,中文提示词友好,效果好,推荐首选
ZhipuAI/CogVideoX‑2B
~13GB
智谱CogVideoX,长一点视频

二、手动下载模型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项目(开箱即用)

  1. modelscope‑text2video‑webui:Gradio封装damo/text‑to‑video‑synthesis,支持本地模型,Windows直接bat启动。
git clone https://github.com/mcmonkeyprojects/modelscope-text2video-webui.git
  1. Wan2.1官方自带gradio示例,模型目录指向手动下载的本地文件夹即可。
  2. ComfyUI:导入魔搭下载好的模型权重,节点式GUI,适合调参,生态最强。

六、常见坑

  1. 不要填模型ID字符串,离线环境必须传本地文件夹路径。
  2. 模型文件必须完整,不要漏.bin/.safetensors权重。
  3. 显存不足:降低分辨率,使用float16,开启模型cpu offload。
  4. ffmpeg缺失会无法合成mp4视频,Windows需要安装ffmpeg并且加到环境变量。

七、离线部署完整流程总结

  1. 有网机器用modelscope download完整下载全部模型文件;
  2. 拷贝整个模型文件夹到离线电脑;
  3. 安装依赖pytorch‑cuda、modelscope、gradio、ffmpeg;
  4. 代码中model="本地模型文件夹路径",启动GUI;
  5. 浏览器访问本地端口,输入文本,GPU本地生成视频,全程不访问魔搭网络。

相关学习资料