> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.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`