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

# HeyGen Video 1.0 参照から動画 - ComfyUI Built-in Node Documentation

> HeyGen Video 1.0 を使用し、テキストプロンプトからセリフと音声が同期した動画を生成します。

HeyGen Video 1.0 を使用し、テキストプロンプトからセリフと音声が同期した動画を生成します。接続した参照素材によってガイドすることもできます。人物・製品・場所の画像、再利用する動画、声を提供する音声クリップを参照として利用できます。プロンプト内では各参照を @Image1、@Video1、@Audio1 のように記述します。番号は種類ごとに、入力が接続された順に振られます。これらのタグは HeyGen が期待するラベルに書き換えられ、接続されていない参照を指すタグはエラーになります。参照画像も参照動画もない場合、このノードはテキストから動画への生成として動作します。

## 入力

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| - | - | - | - | - |
| `model` | 生成に使用するモデルバージョンです。（デフォルト：`"heygen-video-1"`） | DYNAMIC\_COMBO | はい | `"heygen-video-1"` |
| `prompt` | 動画の説明です。セリフを含めることができます。接続した参照は @Image1、@Video1、@Audio1 として参照し、番号は種類ごとに入力順に振られます。（デフォルト：空文字列） | STRING | はい | 1～16000 文字 |
| `duration` | 出力動画の長さ（秒）です。15 秒を超える長さは、参照画像および参照動画がない場合にのみ利用できます。（デフォルト：5） | INT | はい | 5～30 |
| `resolution` | 出力解像度です。1080p と 2k では 16:9 または 9:16 のアスペクト比が必要です。'auto' は、これらの解像度では参照がない場合にのみ機能します。（デフォルト：`"768p"`） | COMBO | はい | `"768p"` `"480p"` `"1080p"` `"2k"` |
| `aspect_ratio` | 出力のアスペクト比です。`"auto"` は、参照が接続されていない場合は 16:9 になり、それ以外の場合は最初の参照画像、参照画像が接続されていない場合は最初の参照動画に従います。（デフォルト：`"auto"`） | COMBO | はい | `"auto"` `"16:9"` `"9:16"` `"1:1"` `"4:3"` `"3:4"` `"21:9"` |
| `seed` | 生成用のシードです。同じシードでも実行ごとに結果が変わる可能性があります。（デフォルト：42） | INT | はい | 0～4294967295 |
| `reference_images` | 拡張可能スロット：動画内で使用する人物・製品・場所の画像（`image_1` ... `image_9`）です。@Image1、@Image2、… として参照します。各入力には必ず 1 枚の画像のみを含める必要があり、各画像のアスペクト比は 1:4～4:1 の範囲である必要があります。 | IMAGE | いいえ | 0～9 枚の画像 |
| `reference_videos` | 拡張可能スロット：参照として使用する動画（`video_1` ... `video_3`）です。@Video1、@Video2、… として参照します。使用される映像は合計で最大 15 秒です。 | VIDEO | いいえ | 0～3 本の動画 |
| `reference_audios` | 拡張可能スロット：話者の声などの音声クリップ（`audio_1` ... `audio_3`）です。@Audio1、@Audio2、… として参照します。少なくとも 1 つの参照画像または参照動画が必要です。声の参照には数秒間のクリーンな音声が必要で、約 2 秒未満のクリップは通常無視されます。 | AUDIO | いいえ | 0～3 個の音声クリップ |
| `auto_duration` | 有効にすると、動画の長さはプロンプト内で引用されたセリフに従い（8～30 秒、参照画像または参照動画がある場合は 8～15 秒）、`duration` は無視されます。（デフォルト：`"disabled"`） | COMBO | いいえ | `"disabled"` `"enabled"` |

### パラメータの制約

* **参照数の上限：** 参照は合計で最大 15 個です。画像は最大 9 枚、動画は最大 3 本、音声クリップは最大 3 個です。それ以上接続するとエラーになります。
* **音声には画像または動画が必要：** 参照画像も参照動画も接続されていない場合、参照音声は拒否されます。
* **参照画像のルール：** 各 `reference_images` 入力には必ず 1 枚の画像のみを含める必要があり（バッチは拒否されます）、各画像のアスペクト比は 1:4～4:1 の範囲である必要があります。
* **プロンプトのタグ：** `@ImageN`、`@VideoN`、`@AudioN` は大文字と小文字を区別せずに照合されます。番号は、その種類で接続されている参照の数を超えてはならず、プロンプトは空白を除去した後に空でない必要があります。
* **モード：** 少なくとも 1 つの参照画像または参照動画がある場合、リクエストは参照から動画への生成（reference-to-video）になります。ない場合は通常のテキストから動画への生成です。
* **1080p と 2k の解像度：** `resolution` が `"1080p"` または `"2k"` の場合、`aspect_ratio` は `"16:9"` または `"9:16"` である必要があります。`"auto"` は、参照画像も参照動画も接続されていない場合に限り、これらの解像度で受け付けられます。
* **長さ：** 参照画像または参照動画がある場合、生成される動画は 15 秒以下になります。より長い動画には参照画像も参照動画も接続できません。`auto_duration` は `duration` を無視させるだけであり（セリフから 8～30 秒、参照がある場合は 8～15 秒）、この上限を引き上げるものではありません。

## 出力

| 出力名 | 説明 | データ型 |
| - | - | - |
| `VIDEO` | セリフと音声が同期した生成動画です。 | VIDEO |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenReferenceToVideoNode/ja.md)

***

**Source fingerprint (SHA-256):** `415ffca1c385936e35bdb0451a23f03756e936b3b871d8d6a958da1ef8c56c36`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.