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

# HappyHorseReferenceVideoApi - ComfyUI Built-in Node Documentation

> Complete documentation for the HappyHorseReferenceVideoApi node in ComfyUI. Learn its inputs, outputs, parameters and usage.

### 概述

此节点基于参考图像，使用 HappyHorse 模型生成以人物或物体为特色的视频。它支持创建包含单个角色或多个角色互动的视频。

### 输入

| 参数                 | 描述                                                        | 数据类型    | 是否必填 | 范围                                                            |
| ------------------ | --------------------------------------------------------- | ------- | ---- | ------------------------------------------------------------- |
| `model`            | 用于视频生成的 HappyHorse 模型。                                    | COMBO   | 是    | `"happyhorse-1.0-r2v"`                                        |
| `prompt`           | 描述您想要生成的视频的文本。使用标识符如 'character1' 和 'character2' 来指代参考角色。 | STRING  | 是    | 无                                                             |
| `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` | 视频中人物或物体的一张或多张参考图像。您必须至少提供一张图像。                           | IMAGE   | 是    | 1 到 9                                                         |
| `seed`             | 用于可重复生成的种子值（默认值为 0）。种子可设置为每次生成后自动更改。                      | INT     | 否    | 0 到 2147483647                                                |
| `watermark`        | 是否在生成的视频中添加 AI 生成的水印（默认值为 False）。                         | BOOLEAN | 否    | True 或 False                                                  |

### 输出

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

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

***

**Source fingerprint (SHA-256):** `9162e150aef4cbafa42d59055bdff953e9c21b1e5fbf7c800629e570ee4cd0f9`
