---
title: h3-character-swap-sam-vdn8-323
canonical_url: "https://www.modelscope.cn/models/Sunjian520/h3-character-swap-sam-vdn8-323"
md_url: "https://www.modelscope.cn/models/Sunjian520/h3-character-swap-sam-vdn8-323.md"
repository: Sunjian520/h3-character-swap-sam-vdn8-323
last_updated: 2026-11-01
downloads: 0
stars: 0
---

# h3-character-swap-sam-vdn8-323

> h3-character-swap-sam-vdn8-323 - Sunjian520 在 ModelScope 开源的模型。AI-KSK 视频323：ComfyUI 工作流合集及配套教程封面，不含模型权重。

- **Repository**: Sunjian520/h3-character-swap-sam-vdn8-323
- **Downloads**: 0
- **Stars**: 0
- **Last updated**: 2026-11-01

Source: https://www.modelscope.cn/models/Sunjian520/h3-character-swap-sam-vdn8-323

---

# H3角色替换1.5：SAM 3.1追踪与VDN8局部回填工作流

换角之前，先确认遮罩选中了正确的人。这个流程把“原视频里替换谁”和“替换成什么角色”拆成两套输入，再通过动态裁剪、潜空间遮罩和人物回填连接起来。多人场景中，提示词再详细，也不能替代对追踪结果的检查。

本合集只有**一个工作流**，不是六个流程，也不附带模型权重。以下说明依据提供的JSON与作者字幕整理；未新增GPU运行、性能测试或效果验证。工作流内的说明也明确标注：VDN8改造后的组合尚未完成GPU兼容性实测。

## 文件导航

| 文件 | 用途 | 需要另备的素材 |
|---|---|---|
| [H3角色替换工作流](<workflows/H3+Character+Swap+1.5｜SAM+3.1+精准角色替换·VDN8+加速版.json>) | SAM追踪、局部生成与回填；47个节点、68条连接，含两处说明节点 | 源视频、新角色参考图、匹配的模型与节点环境 |
| [宣传封面](<covers/b7e4fc8b-5743-4381-bdb5-6fd5f5edd97f.png>) | 教程宣传用途 | 不把封面当作已验证输出或默认参考图 |

本地分发副本只清除了节点42、43中的历史视频预览缓存，节点、连接和其它保存值未改变。清理缓存不等于验证流程能运行，也不会补齐文件名里提到的视频或人物图。

## 先核对模型，不要照抄过时说明

| 位置 | 当前加载器选择 |
|---|---|
| 30：主模型 | `MiniMax-H3-Ref2VA-int8-convrot.safetensors` |
| 121：角色替换LoRA | `h3_character_swap_v1.5.safetensors`，`strength_model=1` |
| 15：文本编码器 | `qwen3vl_32b_minimax_h3_int8_convrot.safetensors` |
| 3：视频VAE | `minimax_h3_lynnreal_light_vae_int8_convrot.safetensors` |
| 4：音频VAE | `minimax_h3_audio_vae_fp32.safetensors` |
| 48：SAM模型 | `sam3.1_multiplex_fp16.safetensors` |

预览配置还出现了`taeh3.safetensors`。VDN节点保存的根标识为`OpenVDN/vdn-minimax-h3`，阶段为`stage_dmd_8nfe`。

图内说明提到了`T8mars/comfyui-minimax-h3-audio-T8`、SAM、MaskVidExperiments与VideoHelperSuite，但没有提供经过验证的完整版本组合。请按对应节点维护者说明确认依赖和权重来源，不要因为名字相近就换成另一套编码器或VAE。

注意：说明节点28写的是另一份带`Raw2`后缀的Ref2VA文件名，与当前加载器不一致。本文表格报告的是加载器实际保存的名称，不把两个名称视为同一个已验证模型。

## 两段提示词分别负责什么

**节点2：换角要求。** 写清楚原视频中要替换的人物，以及新角色由哪张参考图提供外观。不要保留与自己素材不符的示例人物、衣服和动作。

**节点50：SAM选人描述。** 描述的是源视频里的目标，不是新角色。作者字幕建议结合位置、服装和动作，而不是只写一个宽泛的“woman”。例如多人镜头中，应让追踪描述与换角要求指向同一人。

节点9是人物参考图输入。另一个图像加载器126保存为`mode=4`，虽然存在连接，也应先在界面确认它的旁路状态，不能默认两张参考图都已启用。选中的哈希文件名不代表包内带有对应素材。

## 当前配置中容易忽略的差异

- SAM追踪节点53保存：`detection_threshold=0.5`、`max_objects=1`、`detect_interval=1`。这些是配置值，不是跟踪成功率。
- 两个分辨率选择器共享16:9的比例输入，但节点45为1百万像素，节点20为约0.6百万像素（原值`0.6000000000000001`）。图内“保持一致”的建议不代表当前已经一致。
- 节点11的宽、高、长度有外部连线，不能只拿它内部保存的1344、768、124当作当前有效输入；视频加载器保存的帧数上限0也有外部连接。
- 节点17保存10秒，节点19按`max(5, round(a * 24)) + (5 - (max(5, round(a * 24)) % 17)) % 17`计算帧数。代入10得到243，并非240。这是计算结果，不是实际已生成的视频帧数。
- VDN保存了`verify_hashes=false`、`allow_structural_base=true`。不能因此宣称权重完整性或组合兼容性已经验证。

## 建议操作顺序

1. 导入[工作流JSON](<workflows/H3+Character+Swap+1.5｜SAM+3.1+精准角色替换·VDN8+加速版.json>)，先处理缺失节点和不匹配的资产，不急着排队生成。
2. 在节点43选择真实源视频，在节点9选择有权使用的角色参考图。检查音轨是否存在。
3. 分别修改换角提示词与SAM选人描述，确保它们指向同一个目标。
4. 作者建议先用连续的3—5秒镜头试验；当前保存值是10秒。修改后检查帧数表达式、24fps设置及两个分辨率选择器。
5. 查看SAM追踪、裁剪和遮罩预览。选错人、裁剪框丢人或遮罩异常时，先处理这些问题，不要靠追加外观描述掩盖它们。
6. 确认环境与输入后再运行生成，最后检查人物连续性、边界、背景、声音和时序。是否通过，要看真实结果，而不是旧预览缓存。

## 理解局部回填与音频路径

视频先经过节点46预处理，再送入SAM、H3视频参考和回填画布。SAM追踪结果变成逐帧遮罩，经清理后进入`MVEx_SubjectCrop`。裁剪图像与遮罩分别进入视频VAE编码和潜空间遮罩处理；边界框则保留给最终`MVEx_SubjectUncrop`使用。

主模型经角色替换LoRA、sigma shift、VDN composer与execution plan连接到采样器；plan提供sampler和sigmas。图内说明把它定位为单阶段VDN8换角流程，明确区分另一套8+4双阶段放大方案，并提醒不要叠加旧Turbo LoRA。这里不据此推导实测速度倍数。

最终回填使用的是**预处理后的帧**，不能承诺与原视频背景逐像素完全一致。音频也经过VAE编码、latent mask、联合采样和解码，不是直接把原音轨原样复制到成片。作者字幕提示，无音轨视频可能需要额外处理；这个导出没有给出已验证的无音轨回退方案。

输出节点配置为24fps、H.264 MP4、`yuv420p`、CRF 19，文件名前缀`minimaxh3`。它们是导出设置，不代表文件已经生成。显存、运行耗时、效果稳定性和整套兼容性仍需实际验证。

## 教程与来源

以下链接由本期素材说明提供：

- [哔哩哔哩完整教程](https://www.bilibili.com/video/BV1GLnH6NEPC)
- [YouTube完整教程](https://www.youtube.com/watch?v=iuEmeHgHGIg)
- [RunningHub国内工作流入口](https://www.runninghub.cn/post/2113162325590102018/?inviteCode=rh-v1111)

入口内容和运行环境可能变化，请在使用时确认当前页面及依赖；不把国内域名替换成未经确认的国际域名。

图内说明注明基于AI老腊肉的SAM遮罩流程改造，并记录了AI-KSK的VDN8调整。署名不等于授权证明。工作流、模型、节点、封面、人物肖像、视频与音频的权利需要分别确认；本包不声明统一的开源或商用许可。使用合成换角内容时，应取得必要授权并清楚标识其合成性质。

## Episode resources

- RunningHub AI workflow: https://www.runninghub.ai/zh-cn/post/2113278202089521154?inviteCode=rh-v1111
- Existing Civitai workflow: https://civitai.com/models/3018150
- Full YouTube lesson: https://youtu.be/iuEmeHgHGIg
- Bilibili lesson: https://www.bilibili.com/video/BV1GLnH6NEPC/
- Hugging Face collection: https://huggingface.co/AI-KSK/h3-character-swap-sam-vdn8-323
- ModelScope collection: https://modelscope.cn/models/Sunjian520/h3-character-swap-sam-vdn8-323
