原题:Viggle/Viggle-Remake
Viggle 在 MiniMax-H3 基础 transformer 上训练的两套 LoRA(rank 256):swap 模式替换人物和角色,可一次换多个;edit 模式负责其余改动,包括替换、删除、插入物体,换背景、天气或光线。输入是原视频、1–4 张画好的关键帧(可钉在原片对应的某一帧上)和按 MiniMax-H3 六段格式写的提示词,输出保留原片的动作、镜头、节奏和原声。官方称它就是 Viggle-Animate 卡片上预告的 v2:Animate 只换角色,Remake 还能改物体和场景。仓库另带 MCP 服务,Claude Code、codex 等智能体拿到视频和一句话后会自己切分镜头、画关键帧、逐窗口渲染、自查结果,再和原声拼成完整影片。
为什么重要 不只换角色:增删物体、换场景和光线也行,还附 MCP 服务,编程智能体能自己切镜头、画关键帧、拼成整部片子
上升分 208 · 点赞 374 · 下载量 183188
理由
- 官方示例包括把《爱乐之城》一个镜头改出 22 个版本,以及 116 秒、69 个剪辑点的整支 MV 换角色;更长的视频按剪辑点切成窗口分别渲染
- 按显卡给了路线:没有显卡用 Viggle 应用;12–24GB 用 ComfyUI 的 int8 / GGUF 文件手动跑工作流;32GB(RTX 5090)可跑智能体加 ComfyUI 渲染端,官方称 1280×736、345 帧一个窗口约 28 分钟;80GB 以上用参考脚本 sample.py
- 另有 rank 128 / 64 的小 LoRA(1.34 / 0.67GB),官方称输出几乎一样;examples/demo.sh 可检查 LoRA 是否真正加载
用法
- 先下载 MiniMaxAI/MiniMax-H3 基础模型(约 144GB 文件)和本仓库的 lora/、inference/ 等目录(约 5.5GB),不要 git clone 整个仓库(连同全部权重约 210GB)
- 手动:python inference/sample.py --mode swap(或 edit)--video 原视频 --prompt 提示词 --ref 关键帧 --pin 帧号 --frames 124 --short-edge 480;帧数取 17n+5,官方建议不超过 294
- 智能体:只下载 mcp/ 目录,pip install -e . 装服务端,GPU 机器再装 worker,提示词写法见 PROMPTING.md
风险
- 可以把真人的样貌放进对方没同意出现的视频,模型本身不做身份或授权核验;官方要求只用于有权修改的素材、标注 AI 生成
- 权重是 MiniMax H3 的衍生模型,商用须在界面显著标注“MiniMax H3”,年营收超过 2000 万美元要先取得 MiniMax 书面授权;示例里的影视片段版权归原方
- 单次渲染约 12 秒;必须用六段格式提示词;非人形角色的长镜头、细节小瑕疵和不钉帧的多镜头漂移是官方列出的已知问题;本条未运行