> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HappyHorseReferenceVideoApi - ComfyUI Built-in Node Documentation

> This node generates a video featuring a person or object from reference images using the HappyHorse model.

This node generates a video featuring a person or object from reference images using the HappyHorse model. It supports single-character performances and multi-character interactions. The reference images are uploaded and used to represent the characters in the generated video.

## Inputs

### Common Inputs

| Parameter   | Description                                                                                        | Data Type      | Required | Range                                              |
| ----------- | -------------------------------------------------------------------------------------------------- | -------------- | -------- | -------------------------------------------------- |
| `model`     | The HappyHorse reference-to-video model to use for generation.                                     | DYNAMIC\_COMBO | Yes      | `"happyhorse-1.1-r2v"`<br />`"happyhorse-1.0-r2v"` |
| `seed`      | Seed to use for generation (default: 0). Can be set to automatically change after each generation. | INT            | Yes      | 0 to 2147483647                                    |
| `watermark` | Whether to add an AI-generated watermark to the result (default: False).                           | BOOLEAN        | Yes      | True or False                                      |

### HappyHorse 1.1 Inputs (happyhorse-1.1-r2v)

| Parameter    | Description                                                                                                              | Data Type | Required | Range                                                                                                               |
| ------------ | ------------------------------------------------------------------------------------------------------------------------ | --------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
| `prompt`     | Prompt describing the video. Use identifiers such as 'character1' and 'character2' to refer to the reference characters. | STRING    | Yes      | N/A                                                                                                                 |
| `resolution` | The resolution of the generated video.                                                                                   | COMBO     | Yes      | `"720P"`<br />`"1080P"`                                                                                             |
| `ratio`      | The aspect ratio of the generated video.                                                                                 | COMBO     | Yes      | `"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`   | The duration of the generated video in seconds (default: 5).                                                             | INT       | Yes      | 3 to 15                                                                                                             |

### HappyHorse 1.0 Inputs (happyhorse-1.0-r2v)

| Parameter    | Description                                                                                                              | Data Type | Required | Range                                                         |
| ------------ | ------------------------------------------------------------------------------------------------------------------------ | --------- | -------- | ------------------------------------------------------------- |
| `prompt`     | Prompt describing the video. Use identifiers such as 'character1' and 'character2' to refer to the reference characters. | STRING    | Yes      | N/A                                                           |
| `resolution` | The resolution of the generated video.                                                                                   | COMBO     | Yes      | `"720P"`<br />`"1080P"`                                       |
| `ratio`      | The aspect ratio of the generated video.                                                                                 | COMBO     | Yes      | `"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:3"`<br />`"3:4"` |
| `duration`   | The duration of the generated video in seconds (default: 5).                                                             | INT       | Yes      | 3 to 15                                                       |

### Reference Inputs

| Parameter          | Description                                                                                                                                    | Data Type | Required | Range              |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | ------------------ |
| `reference_images` | Growable slot: connect 1 to 9 reference images of the person or object to feature in the video. At least one reference image must be provided. | IMAGE     | Yes      | 1 to 9 (per model) |

Note: At least one reference image must be provided, otherwise the node raises an error. Each reference image must be at least 400 x 400 pixels and have an aspect ratio between 1:2.5 and 2.5:1. The prompt must not be empty.

## Outputs

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

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

***

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