# HappyHorse 参考转视频

此节点使用 HappyHorse 模型，根据参考图像生成包含人物或物体的视频。它支持单角色表演和多角色互动。参考图像被上传并用于表示生成视频中的角色。

## 输入

### 通用输入

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|-----------|-------------|-----------|----------|-------|
| `model` | 用于生成的 HappyHorse 参考转视频模型。 | DYNAMIC_COMBO | 是 | `"happyhorse-1.1-r2v"`<br>`"happyhorse-1.0-r2v"` |
| `seed` | 用于生成的种子（默认值：0）。可设置为每次生成后自动更改。 | INT | 是 | 0 到 2147483647 |
| `watermark` | 是否在结果中添加 AI 生成的水印（默认值：False）。 | BOOLEAN | 是 | True 或 False |

### HappyHorse 1.1 输入 (happyhorse-1.1-r2v)

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|-----------|-------------|-----------|----------|-------|
| `prompt` | 描述视频的提示词。使用诸如 'character1' 和 'character2' 等标识符来指代参考角色。 | STRING | 是 | N/A |
| `resolution` | 生成视频的分辨率。 | COMBO | 是 | `"720P"`<br>`"1080P"` |
| `ratio` | 生成视频的宽高比。 | COMBO | 是 | `"16:9"`<br>`"9:16"`<br>`"1:1"`<br>`"4:3"`<br>`"3:4"`<br>`"21:9"`<br>`"9:21"`<br>`"5:4"`<br>`"4:5"` |
| `duration` | 生成视频的时长（秒）（默认值：5）。 | INT | 是 | 3 到 15 |

### HappyHorse 1.0 输入 (happyhorse-1.0-r2v)

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|-----------|-------------|-----------|----------|-------|
| `prompt` | 描述视频的提示词。使用诸如 'character1' 和 'character2' 等标识符来指代参考角色。 | STRING | 是 | N/A |
| `resolution` | 生成视频的分辨率。 | COMBO | 是 | `"720P"`<br>`"1080P"` |
| `ratio` | 生成视频的宽高比。 | COMBO | 是 | `"16:9"`<br>`"9:16"`<br>`"1:1"`<br>`"4:3"`<br>`"3:4"` |
| `duration` | 生成视频的时长（秒）（默认值：5）。 | INT | 是 | 3 到 15 |

### 参考输入

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|-----------|-------------|-----------|----------|-------|
| `reference_images` | 可扩展插槽：连接 1 到 9 张要在视频中呈现的人物或物体的参考图像。必须至少提供一张参考图像。 | IMAGE | 是 | 1 到 9（每个模型） |

注意：必须至少提供一张参考图像，否则节点将引发错误。每张参考图像至少为 400 x 400 像素，并且宽高比需在 1:2.5 到 2.5:1 之间。提示词不能为空。

## 输出

| 输出名称 | 描述 | 数据类型 |
|-------------|-------------|-----------|
| `VIDEO` | 生成的视频文件。 | VIDEO |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/zh.md)

---
**Source fingerprint (SHA-256):** `252c918afc4cf38be9c7d09b7112075b9adb23490ec9fed1717a8548519d2554`
