> ## 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.
# HeyGenReferenceToVideoNode - ComfyUI Built-in Node Documentation
> HeyGen Video 1.0 を使用して、テキストプロンプトから同期した台詞と音声を備えた動画を生成します。
HeyGen Video 1.0 を使用して、テキストプロンプトから同期した台詞と音声を備えた動画を生成します。接続された参照素材によって任意でガイドすることもできます。人物、製品、場所の画像、再利用する動画、声を提供する音声クリップを参照として使用できます。各参照はプロンプト内で @Image1、@Video1、@Audio1 として言及し、入力が接続された順にタイプごとに番号を付けます。これらのタグは HeyGen が期待するラベルに書き換えられ、接続されていない参照を指すタグがあるとエラーになります。参照画像も参照動画もない場合、このノードはテキストから動画への生成として実行されます。
## 入力
| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| - | - | - | - | - |
| `モデル` | 生成に使用するモデルバージョン。（デフォルト: `"heygen-video-1"`） | DYNAMIC\_COMBO | はい | `"heygen-video-1"` |
| `prompt` | 動画の説明。台詞を含みます。接続された参照は、入力順にタイプごとに番号を付けた @Image1、@Video1、@Audio1 として参照します。（デフォルト: 空文字列） | STRING | はい | 1～32000文字 |
| `duration` | 出力動画の長さ（秒）。（デフォルト: 5） | INT | はい | 5～15 |
| `resolution` | 出力解像度。（デフォルト: `"768p"`） | COMBO | はい | `"768p"`
`"480p"` |
| `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、... として参照します。 | VIDEO | いいえ | 0～3 動画 |
| `reference_audios` | 拡張可能なスロット: 話者の声などの音声クリップ（`audio_1` ... `audio_3`）。それらは @Audio1、@Audio2、... として参照します。少なくとも1つの参照画像または参照動画が必要です。声の参照には数秒間のクリーンな音声が必要で、約2秒より短いクリップは通常無視されます。 | AUDIO | いいえ | 0～3 音声クリップ |
### パラメータ制約
* **参照数の上限:** `reference_images`、`reference_videos`、`reference_audios` 全体で合計最大12個の参照までです。それ以上接続するとエラーになります。
* **音声には画像または動画が必要:** 参照画像も参照動画も接続されていない場合、参照音声は拒否されます。
* **参照画像のルール:** 各 `reference_images` 入力には正確に1枚の画像を含める必要があり（バッチは拒否されます）、各画像のアスペクト比は 1:4 から 4:1 の間でなければなりません。
* **プロンプトタグ:** `@ImageN`、`@VideoN`、`@AudioN` は大文字と小文字を区別せずに照合されます。番号は、そのタイプで接続されている参照の数を超えてはならず、プロンプトは空白を削除した後に空でない必要があります。
* **モード:** 少なくとも1つの参照画像または参照動画がある場合、リクエストは参照から動画への実行です。ない場合は、通常のテキストから動画への実行です。
* **シード:** シードはノードを再実行するかどうかを決めるだけです。同じシードでも結果は再現されません。
## 出力
| 出力名 | 説明 | データ型 |
| - | - | - |
| `VIDEO` | 同期した台詞と音声を備えた生成動画。 | VIDEO |
> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenReferenceToVideoNode/ja.md)
***
**Source fingerprint (SHA-256):** `44de381703821043aa1399e58c9132f9b6a2b0ac5dbf47197dffed0438ea7ad7`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.