> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.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`


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