> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Higgsfield Genjutsu：在 ComfyUI 中进行视频动作迁移

> 在 ComfyUI 中使用 Higgsfield Genjutsu 为视频重新选角：1 到 8 张参考图像重建角色，来源片段保留其动作、相机和音频。

**Higgsfield Genjutsu Motion Transfer** 是对现有视频进行重建，而不是生成新视频。来源片段会保留其运动、相机运动、时序和音频，而演员、场景、服装和风格则根据 1 到 8 张参考图像重建。你只需描述需要改变的部分，镜头的其余内容保持拍摄时的原样。

Higgsfield 将 Genjutsu 分为两种模式：Motion Transfer 和 Object Swap。ComfyUI 通过 `partner/video/Higgsfield` 类别中的 `HiggsfieldMotionTransferNode` 提供 Motion Transfer。它是一个云端 API 节点：需要带有积分的 Comfy 账户，不下载任何模型，并按输出秒数计费，因为结果的时长取决于来源片段。

当表演已经存在、只需改变外观时，该节点非常有用。用不同的角色替换手机片段中的人物，把拍摄移到从未可用的地点，为另一个市场重新调整素材风格，或者在不逐个拍摄的情况下为一个镜头制作多个变体。

<Tip>
  使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](/zh/tutorials/partner-nodes/overview)部分文档来了解使用 API 节点的具体使用要求。
</Tip>

<Tip>
  <Tabs>
    <Tab title="本地用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新版（每夜版）。
      2. 启动时有些节点导入失败。
    </Tab>

    <Tab title="云端用户">
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新。

      所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。
    </Tab>
  </Tabs>
</Tip>

<h2 id="api_higgsfield_genjutsu_motion_transfer">
  Higgsfield Genjutsu：动作迁移
</h2>

根据参考图像对视频进行角色替换，同时源片段保留其动作、相机运动、时间节奏和音频。

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_higgsfield_genjutsu_motion_transfer.mp4" />

<CardGroup cols={2}>
  <Card title="Run on Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=api_higgsfield_genjutsu_motion_transfer&utm_source=docs&utm_medium=referral&utm_campaign=higgsfield-genjutsu">
    Open in Comfy Cloud
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_higgsfield_genjutsu_motion_transfer.json">
    下载 JSON，或在模板库中搜索 "Higgsfield Genjutsu: Motion Transfer"
  </Card>
</CardGroup>

**输入素材**

将这些文件上传到对应的 `LoadVideo` 和 `LoadImage` 节点：

<CardGroup cols={3}>
  <Card title="rooftop_dancer.mp4" icon="video" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/rooftop_dancer.mp4">
    `LoadVideo` · 来源动作片段
  </Card>

  <Card title="snow_queen_ref.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/snow_queen_ref.png">
    `LoadImage` · 角色参考 · `image_1`
  </Card>

  <Card title="ice_palace_ref.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/ice_palace_ref.png">
    `LoadImage` · 场景参考 · `image_2`
  </Card>
</CardGroup>

## 节点控件

| 控件 | 取值 | 作用 |
| - | - | - |
| `model` | `genjutsu-v1.0` | Genjutsu 模型。选择后会显示下方的输入 |
| `video` | 4 至 30 秒 | 来源片段，其运动、相机移动、时序和音频都会被保留。过短的片段会被拒绝，过长的片段会被裁剪为前 30 秒 |
| `reference_images` | 1 至 8 张图像 | 要使用的角色、场景或风格。每个槽位连接一张图像（`image_1`、`image_2` 等）；批量输入会按每张图像计数一次，所有槽位的总数不能超过 8 |
| `prompt` | 文本，可选 | 描述结果，例如哪张参考图像替换哪个人物，或新的场景设定 |
| `resolution` | `480p`、`720p`、`1080p` | 输出分辨率，默认 `720p` |
| `seed` | 整数 | 仅控制节点是否重新运行。使用相同种子时，多次运行的结果仍可能不同 |

输出长度与准备好的来源片段一致，因此 12 秒的片段会返回 12 秒的视频。

## 提示技巧

* **明确每张参考图像替换的内容。** 提示词是可选的，但它是唯一可以说明哪张图像对应哪个人或物体的地方。请将其写成简短的指令，例如把舞者重塑为第一张参考图像中的角色，并用第二张参考图像来设置新的场景。
* **保持参考集精简。** 每个元素通常一张图像就够了：一个角色、一个地点、一次服装更换或一种风格。添加更多图像会让模型需要融合的内容更多，从而使结果更难预测。
* **让构图与你想要的一致。** 输出会保留源视频片段的动作和相机，因此请选择构图已经适合最终结果的来源视频。特写表演仍会保持特写。
* **描述变化，而不是整个场景。** 提示词中未提及的一切都会根据参考图像重建，因此无需重复描述动作、节奏或音频。
* **预期每次运行之间会有差异。** 种子不会锁定结果；相同的设置也可能产生不同的效果。

## 开始使用

1. 将 ComfyUI 更新到 0.40.0 或更高版本
2. 前往 **Template Library**，搜索 `Higgsfield Genjutsu`
3. 在 `LoadVideo` 节点中加载来源片段，在 `LoadImage` 节点中加载参考图像
4. 编写提示词，选择 `resolution`，然后运行工作流


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.