# 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 (per model) |

注意：至少必須提供一張參考影像，否則節點會觸發錯誤。每張參考影像至少必須為 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-TW.md)

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