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

# HeyGenAvatarVideoNode - ComfyUI Built-in Node Documentation

> Generate a talking-presenter video from a HeyGen avatar.

### 概要

HeyGenアバターからトーキングプレゼンタービデオを生成します。このノードは、HeyGenのレンダリングエンジンを使用して、指定したテキストを話すAIアバターのビデオ、または独自のオーディオにリップシンクするビデオを作成します。

### 入力

| パラメータ        | 説明                                                                                                                                                                          | データ型   | 必須 | 範囲                                                                          |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -- | --------------------------------------------------------------------------- |
| `エンジン`       | レンダリングエンジン。各選択肢には、それをサポートするアバターのみが表示されます。`"auto"` はすべてのアバターを提供し、そのルックがサポートする最適なエンジンを選択します（Avatar IV優先）。Avatar Vは最高忠実度、Avatar IIIは最も手頃な価格です。                                 | COMBO  | 必須 | `"auto"`<br />`"avatar_iv"`<br />`"avatar_iii"`<br />`"avatar_v"`           |
| `avatar`     | ビデオを発表するアバタールック。エンジン `"auto"` の場合、HeyGenのパブリックライブラリから厳選され、そのルックがサポートする最適なエンジンが自動的に選択されます。エンジン `"avatar_iv"`、`"avatar_iii"`、`"avatar_v"` の場合、そのエンジンをサポートするアバタールックのみがリストされます。 | COMBO  | 必須 | `エンジン` の選択によって異なります                                                         |
| `カスタムアバターID` | オプションのHeyGenアバタールックID。設定すると、上で選択したアバターを上書きします。HeyGenの3000以上のパブリックルック（またはプライベートアバター）を使用できます。                                                                                 | STRING | 任意 |                                                                             |
| `スピーチ`       | テキストスクリプト（HeyGenテキスト読み上げ）または独自のオーディオでアバターを駆動します。`"script"` を選択した場合は、以下のサブパラメーターを参照してください。`"audio"` を選択した場合は、リップシンク用のオーディオファイルを指定します。                                        | COMBO  | 必須 | `"script"`<br />`"audio"`                                                   |
| `解像度`        | 出力ビデオ解像度（デフォルト: `"1080p"`）。                                                                                                                                                 | COMBO  | 任意 | `"720p"`<br />`"1080p"`                                                     |
| `アスペクト比`     | 出力アスペクト比。`"auto"` はアバターのソース映像に従います（デフォルト: `"auto"`）。                                                                                                                        | COMBO  | 任意 | `"auto"`<br />`"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:5"`<br />`"5:4"` |
| `背景色`        | オプションの単色背景色を16進コードで指定します（例: `'#00ff00'`）。アバター自身の背景を使用する場合は空のままにします。指定する場合は、値は `#` で始まる必要があります。                                                                              | STRING | 任意 |                                                                             |
| `シード`        | HeyGenには送信されません。再実行を強制するために変更します（デフォルト: `42`）。                                                                                                                              | INT    | 任意 | 最小: 0<br />最大: 2147483647                                                   |

#### `speech` が `"script"` の場合のサブパラメーター

| パラメータ             | 説明                                                                        | データ型   | 必須 | 範囲                                   |
| ----------------- | ------------------------------------------------------------------------- | ------ | -- | ------------------------------------ |
| `text`            | アバターが話すテキスト（最大5000文字）。生成される音声は少なくとも1秒以上である必要があります。                        | STRING | 必須 |                                      |
| `voice`           | スクリプト用の音声。デフォルトのオプションは、HeyGenがアバターに割り当てた音声を使用します。                         | COMBO  | 必須 | 複数のオプション（デフォルト音声とHeyGenの一般音声ライブラリ）   |
| `custom_voice_id` | オプションのHeyGen音声ID。設定すると、上で選択した音声を上書きします。HeyGenのライブラリ（2000以上）の任意の音声を使用できます。 | STRING | 任意 |                                      |
| `voice_speed`     | 音声速度の倍率（デフォルト: `1.0`）。                                                    | FLOAT  | 任意 | 最小: 0.5<br />最大: 1.5<br />ステップ: 0.05 |

#### `speech` が `"audio"` の場合のサブパラメーター

| パラメータ   | 説明                            | データ型  | 必須 | 範囲 |
| ------- | ----------------------------- | ----- | -- | -- |
| `audio` | アバターがリップシンクするためのオーディオ（最大10分）。 | AUDIO | 必須 |    |

### 出力

| 出力名     | 説明                  | データ型  |
| ------- | ------------------- | ----- |
| `VIDEO` | 生成されたアバタープレゼンタービデオ。 | VIDEO |

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

***

**Source fingerprint (SHA-256):** `009bc72b841ca273af83fe6f80fb24d4b11c2efd96c011795b1ff1cf8e66ee61`