> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Moonvalley 合作伙伴节点 ComfyUI 官方示例

> 本文将介绍如何在 ComfyUI 中使用 Moonvalley 合作伙伴节点的文生视频、图生视频、视频转绘等能力

<Warning>
  **服务不可用**：Moonvalley API 服务已不再提供，这些节点已弃用，可能无法按预期运行。
</Warning>

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/8Z8X9fFKapQ?si=lK_KFSzDcT0Mepk9" title="ComfyUI Selection Toolbox New Features" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

Moonvalley Marey Realism v1.5 是专为影视级创作打造的 AI 视频生成模型，该模型**完全使用商业授权内容训练**，确保**版权合规，商用安全**。

## Moonvalley 的优势

* 卓越的提示词理解能力：能够准确解析复杂的提示词指令。
* 原生 1080p 高清画质：训练数据集基于 **1080P** 视频，从而生成精细且细节丰富的输出。
* 逼真的物理与动态表现：精确模拟物理运动模型和自然动态，呈现专业级的真实感。
* 复杂场景分层与高级光照效果：支持复杂场景中的前景、中景和背景分层，具备智能的空间关系理解能力。
* 生产级控制功能，例如运动与姿态迁移：自动为合成场景生成逼真的光照。

目前，ComfyUI 原生支持与 Moonvalley 相关的合作节点。您可以直接在 ComfyUI 中使用相应的文生视频、图生视频和视频转视频功能。

<Warning>
  **服务不可用**：Moonvalley API 服务已不再可用。这些节点已被弃用，可能无法按预期运行。
</Warning>

<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>

## Moonvalley 文生视频工作流

### 1. 下载工作流文件

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/moonvalley/api_moonvalley_text_to_video.mp4" />

<a className="prose" target="_blank" href="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/moonvalley/api_moonvalley_text_to_video.json" style={{ display: 'inline-block', backgroundColor: '#0078D6', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>下载 JSON 格式的工作流文件</p>
</a>

### 2. 按照步骤运行工作流

<img src="https://mintcdn.com/dripart-docs-custom-nodes-sdk-v2-frontend/eIcaTwArXXbGzGMg/images/tutorial/api_nodes/moonvalley/api_moonvalley_text_to_video.jpg?fit=max&auto=format&n=eIcaTwArXXbGzGMg&q=85&s=c29b8b7bb91b559139782c06c2b3f80d" alt="文生视频工作流" width="3160" height="2434" data-path="images/tutorial/api_nodes/moonvalley/api_moonvalley_text_to_video.jpg" />

1. 输入正面提示词（你希望出现在视频中的内容）
2. 输入负面提示词（你不希望出现在视频中的内容）
3. 修改视频输出分辨率
4. 点击 `Run` 按钮，或使用快捷键 `Ctrl(cmd) + Enter` 开始生成视频
5. 在 API 返回结果之后，你可以在 `Save Video` 节点中查看已生成的视频。该视频也会被保存在 `ComfyUI/output/` 目录下

## Moonvalley 图生视频工作流

### 1. 工作流文件下载

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/moonvalley/api_moonvalley_image_to_video.mp4" />

<a className="prose" target="_blank" href="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/moonvalley/api_moonvalley_image_to_video.json" style={{ display: 'inline-block', backgroundColor: '#0078D6', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>下载 Json 格式工作流文件</p>
</a>

下载下面的图片作为输入图片

![输入图片](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/moonvalley/api_moonvalley_image_to_video_input.webp)

### 2. 按步骤完成工作流的运行

<img src="https://mintcdn.com/dripart-docs-custom-nodes-sdk-v2-frontend/eIcaTwArXXbGzGMg/images/tutorial/api_nodes/moonvalley/api_moonvalley_image_to_video.jpg?fit=max&auto=format&n=eIcaTwArXXbGzGMg&q=85&s=5ca1b50fff360b3716bf0ec69aca12d5" alt="图生视频工作流" width="3966" height="1350" data-path="images/tutorial/api_nodes/moonvalley/api_moonvalley_image_to_video.jpg" />

1. 在 `Load Image` 节点中加载输入图像
2. 输入正向提示词（想要出现在画面中的内容）
3. 输入负向提示词（不想要出现在画面中的内容）
4. 修改视频输出分辨率
5. 点击 `Run` 按钮，或者使用快捷键 `Ctrl(cmd) + Enter(回车)` 来执行视频的生成
6. 等待 API 返回结果后，你可在 `Save Video` 节点中查看生成的视频，对应的视频也会被保存至 `ComfyUI/output/` 目录下

## Moonvalley 视频转视频工作流

`Moonvalley Marey Video to Video` 节点允许你输入一段参考视频来进行视频重绘。你可以使用参考视频的运动或角色姿态来生成视频。

### 1. 下载工作流文件

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/moonvalley/api_moonvalley_video_to_video.mp4" />

<a className="prose" target="_blank" href="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/moonvalley/api_moonvalley_video_to_video.json" style={{ display: 'inline-block', backgroundColor: '#0078D6', color: '#ffffff', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>下载 JSON 格式工作流文件</p>
</a>

下载下面的视频作为输入视频：

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/api_nodes/moonvalley/api_moonvalley_video_to_video_input.mp4" />

### 2. 按步骤运行工作流

<img src="https://mintcdn.com/dripart-docs-custom-nodes-sdk-v2-frontend/eIcaTwArXXbGzGMg/images/tutorial/api_nodes/moonvalley/api_moonvalley_video_to_video.jpg?fit=max&auto=format&n=eIcaTwArXXbGzGMg&q=85&s=f0450717f6bb3ddc9b8897883d45ba4d" alt="视频转视频工作流" width="3966" height="1350" data-path="images/tutorial/api_nodes/moonvalley/api_moonvalley_video_to_video.jpg" />

1. 在 `Load Video` 节点中加载参考视频（或你自己的素材）
   * 如果最终视频时长为 5s，输入视频必须大于 5s
   * 如果最终视频时长为 10s，输入视频必须大于 10s
2. 输入正向提示词（想要出现在视频中的内容）
3. 输入负面提示词（不想要出现在视频中的内容）
4. 设置 `control_type` 参数，选择视频重绘的参考类型
   * `Motion Transfer`: 根据参考视频的运动进行生成
   * `Pose Transfer`: 根据参考视频的角色姿态进行生成
5. 点击 `Run` 按钮，或使用快捷键 `Ctrl(cmd) + Enter` 开始生成视频
6. API 返回结果后，你可以在 `Save Video` 节点中查看已生成的视频。视频也会被保存至 `ComfyUI/output/` 目录下