> ## 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 でテキスト・画像・リファレンスから動画生成

> ComfyUI で HeyGen Video 1.0 を使い、プロンプト、最初のフレーム、最大 15 個のリファレンス素材から、セリフが同期した 5～30 秒のクリップを生成

**HeyGen Video 1.0** は HeyGen の汎用ビデオモデルで、映像、セリフ、環境音を一度の生成で作り出します。プロンプトでショットとセリフを記述すると、音声が同期されたクリップが返ってくるため、トーキングヘッドや製品ビデオの制作に撮影も、プレゼンターも、別途のナレーション工程も必要ありません。

ComfyUI では、このモデルは 2 つのパートナーノードを通じて実行されます。**HeyGen Video 1.0 Reference to Video** はテキストからビデオへの生成を単独で処理し、画像、ビデオ、またはオーディオが接続されると参照からビデオへの生成を処理します。**HeyGen Video 1.0 Image to Video** は最初のフレームから生成を開始します。どちらもクラウドAPIノードで、クレジットのある Comfy アカウントが必要となり、ローカルモデルのダウンロードは行いません。1 秒あたりの料金については[パートナーノードクレジット](https://docs.comfy.org/ja/tutorials/partner-nodes/pricing.md)をご覧ください。

すべての実行で 5 ～ 30 秒のクリップが 480p、768p、1080p、または 2K で返され、セリフ、ルームトーン、そして音楽がある場合はそれも既にビデオに含まれています。15 秒を超えるクリップは、参照画像と参照ビデオを接続していない場合にのみ利用できます。

> [!TIP]
>
> APIノードを使用するには、正しくログインしていることと、許可されたネットワーク環境で使用していることを確認する必要があります。APIノードの使用に必要な具体的な要件については、ドキュメントの「[APIノードの概要](https://docs.comfy.org/ja/tutorials/partner-nodes/overview.md)」セクションをご参照ください。

> [!TIP]
>
> > [tab] ローカルユーザー
> >
> > ComfyUI が最新版に更新されていることを確認してください。
> >
> > * [ComfyUI のダウンロード](https://www.comfy.org/download)
> > * [更新手順](https://docs.comfy.org/ja/installation/update_comfyui.md)
> >
> > このガイドで紹介するワークフローは、[ワークフローテンプレート](https://docs.comfy.org/ja/interface/features/template.md)から入手できます。
> > テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。
> >
> > ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：
> >
> > 1. 最新の ComfyUI（Nightly 版）を使用していない
> > 2. 起動時に一部のノードのインポートに失敗している
>
> > [tab] クラウドユーザー
> >
> > * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。
> >
> > したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。

## 利用可能なワークフロー

### テキストから動画へ

プロンプトだけでクリップを生成します。プロンプトが動作、セリフ、サウンドを担うため、1回のノード実行で完成したトーキングクリップが返されます。

<video controls src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_heygen_video_1_t2v.mp4" />

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=api_heygen_video_1_t2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=heygen-video-1)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_heygen_video_1_t2v.json)
>
> JSON をダウンロードするか、テンプレートライブラリで "HeyGen Video 1.0: Text to Video" を検索してください

テキストから動画へのテンプレートは、何も接続せずに Reference to Video ノードを実行します。これがこのノードのテキストから動画へのモードです。

### 画像から動画へ

1枚の画像をアニメートします。その画像がクリップの最初のフレームになり、出力はアスペクト比を維持するため、異なる形状が必要な場合は画像をクロップしてください。プロンプトが、何が起こるか、何が話されるかを決めます。

<video controls src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_heygen_video_1_i2v.mp4" />

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=api_heygen_video_1_i2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=heygen-video-1)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_heygen_video_1_i2v.json)
>
> JSON をダウンロードするか、テンプレートライブラリで "HeyGen Video 1.0: Image to Video" を検索してください

**入力マテリアル**

> [card] [model\_red\_curls\_ring.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/model_red_curls_ring.png)
>
> HeyGen Video 1.0 Image to Video ノードに渡す `LoadImage` ノードに読み込んでください

### リファレンスから動画へ

人物、製品、場所をリファレンスとして接続することで、ショット全体を通して一貫させます。最大9枚の画像、3本のビデオ、3つのオーディオクリップ、合計15個です。参照ビデオは合計15秒のフッテージ枠を共有します。合計が収まる場合はすべて使用され、収まらない場合は各ビデオの最初の5秒までを使い、残りの枠を素材が残っているビデオで均等に分けます。プロンプトでは、それらを `@Image1`、`@Video1`、`@Audio1` として参照します。番号は種類ごとに入力順に付けられます。

<video controls src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_heygen_video_1_r2v.mp4" />

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=api_heygen_video_1_r2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=heygen-video-1)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_heygen_video_1_r2v.json)
>
> JSON をダウンロードするか、テンプレートライブラリで "HeyGen Video 1.0: Reference to Video" を検索してください

**入力マテリアル**

> [card] [model\_black\_blazer\_red\_earrings.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/model_black_blazer_red_earrings.png)
>
> 最初のリファレンス画像スロットに読み込む · `@Image1`

> [card] [cognac\_leather\_handbag.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/cognac_leather_handbag.png)
>
> 2番目のリファレンス画像スロットに読み込む · `@Image2`

## ノードのコントロール

| コントロール | 値 | 適用対象 | 効果 |
| - | - | - | - |
| `prompt` | テキスト、最大16000文字 | 両方のノード | ショット、話すセリフ、サウンド。参照メディアは `@Image1`、`@Video1`、`@Audio1` として指定します |
| `duration` | 5～30秒 | 両方のノード | スライダー、デフォルトは5。Reference to Video では、15秒を超えるには参照画像も参照ビデオも接続しない必要があります |
| `resolution` | `480p`、`768p`、`1080p`、`2K` | 両方のノード | 出力解像度。Reference to Video では、`1080p` と `2K` には `16:9` または `9:16` の `aspect_ratio` が必要で、参照メディアを接続していない場合にのみ `auto` をこれらの解像度で使用できます |
| `auto_duration` | `disabled`、`enabled` | 両方のノード | `duration` の代わりにプロンプト内のセリフに合わせます。8～30秒、Reference to Video で参照画像または参照ビデオを接続した場合は8～15秒。デフォルトは `disabled` |
| `aspect_ratio` | `auto`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`21:9` | Reference to Video | `auto` は何も接続されていない場合は16:9になります。参照がある場合は最初の参照画像に従い、画像が接続されていない場合は最初の参照ビデオに従います |
| `seed` | 整数 | 両方のノード | 同じシードでも実行ごとに結果が変わることがあります |
| `reference_images` | 最大9 | Reference to Video | 1スロットにつき画像1つ。単一スロットへのバッチ入力は拒否されます |
| `reference_videos` | 最大3 | Reference to Video | 1スロットにつきビデオ1つ |
| `reference_audios` | 最大3 | Reference to Video | 少なくとも1つの参照画像または参照ビデオが接続されている必要があります。音声参照には数秒間のクリーンな音声が必要です |

Image to Video ノードは、画像、プロンプト、再生時間、解像度、シードを受け取ります。最初のフレームがクリップの形状を決めるため、アスペクト比のコントロールはありません。

## プロンプトのヒント

* **発話するセリフはプロンプトに書く**。台詞はショットの説明の一部として引用符で囲みます。そうすることで、モデルがそのセリフを話し、口の動きも一致します。両方のテンプレートには長いサンプルプロンプトが付属しており、その形を示しています。まずショットと被写体、次に引用符で囲んだセリフ、その後にサウンドとカメラの表現が続きます。
* **サウンドは映像と一緒に記述する**。ルームトーン、音楽、あるいは動作が発するノイズは、コントロールで設定するのではなくプロンプトに書き込みます。サンプルプロンプトはアンビエンスで終わります。たとえば、かすかなケトルの笛音を伴う静かなルームトーンや、物を置くときの柔らかなグラスの触れ合う音などです。
* **製品や出演者の一貫性を保つ**。製品や人物を参照画像として接続し、プロンプト内でその名前を挙げてから、どのように同じ状態を保つ必要があるかを記述します。たとえば、`@Image2` のバッグの正確な色、比率、金具を維持するなどです。
* **参照画像でショットを形作る**。`aspect_ratio` を `auto` に設定すると、フレーミングは最初の参照画像に従うため、最初に接続した参照画像がビデオの形状を決めます。
* **実行ごとのばらつきを想定する**。シードは結果を固定しません。同じ設定でも異なるテイクが生成されることがあります。

## はじめる

1. ComfyUIを最新バージョンにアップデート
2. テンプレートライブラリに移動し、`HeyGen Video 1.0` を検索


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