Viggle AI 的 Custom Multi Swap 技术，核心优势在于支持多个角色同步进行动作驱动。实际使用时，首先要确认当前账号已开通 Multi Swap 权限；随后分别上传角色图片，并导入提前处理好的视频素材；接着在高级设置中启用 Multi-Swap Mode，手动完成角色与人物 ID 的对应映射；最后导出生成结果，并检查多人同框画面的整体一致性是否符合预期。

如果你想在一段视频中同时替换或驱动多个角色，让不同人物在同一画面里自然互动，那么 Viggle AI 的 Custom Multi Swap 技术就是实现多人视频生成的重要方案。它并非依赖传统后期拼接，而是基于帧级骨骼追踪能力，同步识别并重映射多个目标的动作细节与物理表现，因此更适合制作多角色同框视频。

确认是否启用Multi Swap功能

打开 viggle.ai → 登录后进入 create 页面 → 查看左下角工具栏中是否出现 “Multi” 标签 或 “+ Add Character” 按钮。若没有该选项，说明当前账户尚未开通 Multi Swap 功能，需要升级到 Pro 或 Enterprise 计划；免费版通常只支持单角色替换。

这一步一定要先确认，否则后续的素材上传与多人角色识别流程都无法正常启动。

准备多角色素材与原始视频

方法一：统一规范上传角色图
每个角色都需要提供一张正面清晰、无遮挡、背景干净的 PNG/JPG 图片，建议尺寸≥1024×1024。多个角色不能合并在同一张图片中，必须分别单独上传——【Viggle 会按照上传顺序自动编号为 Char-1、Char-2…，如果顺序出错，就可能造成动作绑定错误】。

方法二：提前处理原始视频
建议选择人物间距适中、遮挡较少、动作节奏清晰的短视频（时长≤8秒，MP4 格式，分辨率≥720p）。尽量避免镜头大幅晃动或快速变焦，否则 Multi Swap 在进行多目标追踪时容易出现轨迹丢失。

注意：如果视频中原本有 3 人同框，但你只打算替换其中 2 个角色，那么第 3 个人物必须保留在原视频里作为“锚点参考”，不能使用空白图替代——否则物理引擎将无法准确校准人物之间的空间关系。

执行多角色混合生成

第一步，进入左侧“Character”区域，将全部角色图片按顺序拖入，例如 Char-1.jpg、Char-2.png。上传完成后，请留意右上角提示，只有看到“✅ 2 characters loaded”时，才表示角色素材已正确加载。
第二步，点击“Motion”，然后选择“Upload Video”，把已经预处理好的原始视频上传。
第三步，这一步是多人视频生成的关键设置：打开底部“Advanced Options”，勾选 “Enable Multi-Swap Mode”，随后在“Swap Mapping”面板中手动匹配角色关系：例如 Char-1 对应视频中的第 1 号人物（系统通常会自动框选出来），Char-2 对应第 2 号人物。
第四步，点击“Generate”，然后等待进度条完成即可。通常生成时间在 90–180 秒之间，具体取决于显存配置和角色数量。

生成过程中不要刷新页面，否则任务会被中断，且积分不会退回。Viggle 后台会实时渲染每一帧的骨骼对齐状态；如果生成失败，通常会在第 3 秒左右提示“Tracking loss on ID#2”，这时建议更换视频片段后重新尝试。

导出与验证多角色一致性

生成完成后，先播放预览视频，重点检查以下三项：
• 所有替换角色是否始终保持在画面中（没有突然消失、错位或漂移）；
• 肢体动作是否保持同步（例如两人击掌时，手部接触位置是否准确匹配）；
• 衣物褶皱与光影变化是否会随动作自然变化（如果某个角色的衣袖僵硬不动，通常说明物理引擎未正常激活，需要重新开启 Multi-Swap Mode）。

确认结果无误后，点击右上角“Download HD”按钮，即可将视频以 MP4 格式下载，文件中会保留完整音频轨道与时间码信息。