> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HeyGenAvatarVideoNode - ComfyUI Built-in Node Documentation

> HeyGen アバターからトーキングプレゼンター動画を生成します。

HeyGen アバターからトーキングプレゼンター動画を生成します。このノードは、HeyGen のレンダリングエンジンを使用して、提供したテキストを話す、または自分の音声にリップシンクする AI アバターの動画を作成します。

## 入力

### 共通入力

| パラメータ        | 説明                                                                                                                                      | データ型           | 必須  | 範囲                                                                          |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------- | -------------- | --- | --------------------------------------------------------------------------- |
| `エンジン`       | レンダリングエンジン。各選択肢には、それをサポートするアバターのみが一覧表示されます。`"auto"` はすべてのアバターを提供し、最適なエンジンを選択します（Avatar IV が優先されます）。Avatar V は最高忠実度で、Avatar III は最も手頃です。 | DYNAMIC\_COMBO | はい  | `"auto"`<br />`"avatar_iv"`<br />`"avatar_iii"`<br />`"avatar_v"`           |
| `カスタムアバターID` | オプションの HeyGen アバタールック ID。設定すると、上で選択したアバターを上書きします。HeyGen の 3000 以上の公開ルック（またはプライベートアバター）を使用できます。デフォルト: `""`。                              | STRING         | いいえ |                                                                             |
| `スピーチ`       | テキストスクリプト（HeyGen のテキスト読み上げ）または自分の音声でアバターを動作させます。表示名: 「speech source」。                                                                   | DYNAMIC\_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                                                   |

### `auto` 入力

`engine` が `"auto"` の場合、次のサブパラメータを使用できます。

| パラメータ    | 説明                                                                  | データ型  | 必須 | 範囲            |
| -------- | ------------------------------------------------------------------- | ----- | -- | ------------- |
| `avatar` | 動画に表示するアバタールック（HeyGen の公開ライブラリから厳選）。そのルックがサポートする最適なエンジンが自動的に選択されます。 | COMBO | はい | 複数のオプションが利用可能 |

### `avatar_iv` 入力

`engine` が `"avatar_iv"` の場合、次のサブパラメータを使用できます。

| パラメータ    | 説明                            | データ型  | 必須 | 範囲            |
| -------- | ----------------------------- | ----- | -- | ------------- |
| `avatar` | Avatar IV エンジンをサポートするアバタールック。 | COMBO | はい | 複数のオプションが利用可能 |

### `avatar_iii` 入力

`engine` が `"avatar_iii"` の場合、次のサブパラメータを使用できます。

| パラメータ    | 説明                             | データ型  | 必須 | 範囲            |
| -------- | ------------------------------ | ----- | -- | ------------- |
| `avatar` | Avatar III エンジンをサポートするアバタールック。 | COMBO | はい | 複数のオプションが利用可能 |

### `avatar_v` 入力

`engine` が `"avatar_v"` の場合、次のサブパラメータを使用できます。

| パラメータ    | 説明                           | データ型  | 必須 | 範囲            |
| -------- | ---------------------------- | ----- | -- | ------------- |
| `avatar` | Avatar V エンジンをサポートするアバタールック。 | COMBO | はい | 複数のオプションが利用可能 |

### `script` 入力

`speech` が `"script"` の場合、次のサブパラメータを使用できます。

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

### `audio` 入力

`speech` が `"audio"` の場合、次のサブパラメータを使用できます。

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

注: `engine` と `speech` はセレクターであり、選択した値に応じて異なるサブパラメータを表示します。`speech` セレクターには相互に排他的な 2 つのモードがあります。`"script"` モードでは `text` が必須です。`custom_voice_id` が指定されている場合は、`voice` を上書きします。`"audio"` モードでは、アバターは提供された音声クリップにリップシンクします。`background_color` を指定する場合は、`#` で始まる 16 進カラーコードである必要があります。`custom_avatar_id` が設定されている場合は、`avatar` の選択を上書きし、選択した `engine` はそのアバタールックでサポートされている必要があります。そうでない場合、`engine` が `"auto"` でない限りエラーが発生します。

## 出力

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

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

***

**Source fingerprint (SHA-256):** `86dc799d3a8cf2666449b0d422853b12feffb81ce002f84594f9b925d58b522a`