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

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/en.md)

## Overview

This node generates a video featuring a person or object based on reference images using the HappyHorse model. It supports creating videos with a single character or multiple characters interacting with each other.

## Inputs

| Parameter          | Data Type | Required | Range                                                         | Description                                                                                                                                    |
| ------------------ | --------- | -------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`            | COMBO     | Yes      | `"happyhorse-1.0-r2v"`                                        | The HappyHorse model to use for video generation.                                                                                              |
| `prompt`           | STRING    | Yes      | N/A                                                           | A text description of the video you want to generate. Use identifiers like 'character1' and 'character2' to refer to the reference characters. |
| `resolution`       | COMBO     | Yes      | `"720P"`<br />`"1080P"`                                       | The resolution of the generated video.                                                                                                         |
| `ratio`            | COMBO     | Yes      | `"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:3"`<br />`"3:4"` | The aspect ratio of the generated video.                                                                                                       |
| `duration`         | INT       | Yes      | 3 to 15                                                       | The duration of the generated video in seconds (default: 5).                                                                                   |
| `reference_images` | IMAGE     | Yes      | 1 to 9                                                        | One or more reference images of the person or object to feature in the video. You must provide at least one image.                             |
| `seed`             | INT       | No       | 0 to 2147483647                                               | A seed value for reproducible generation (default: 0). The seed can be set to automatically change after each generation.                      |
| `watermark`        | BOOLEAN   | No       | True or False                                                 | Whether to add an AI-generated watermark to the resulting video (default: False).                                                              |

## Outputs

| Output Name | Data Type | Description               |
| ----------- | --------- | ------------------------- |
| `VIDEO`     | VIDEO     | The generated video file. |

***

**Source fingerprint (SHA-256):** `42c844db22ed2284bd16bd28fe0060652248ada0d5d31003134768ed5e44356c`