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

> Complete documentation for the HeyGenAvatarVideoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

あなたは ComfyUI ノードドキュメントを英語から日本語に翻訳する技術翻訳の専門家です。

## 翻訳ルール

1. **翻訳してはいけない内容：**
   * バッククォートで囲まれたパラメータ名：`image`、`seed`、`model`
   * 大文字のデータ型：IMAGE、STRING、INT、FLOAT、MODEL、CONDITIONING など
   * Range列の値：数値、"auto"、オプション名
   * コード、ファイルパス

2. **翻訳する内容：**
   * セクション見出し：## 概要、## 入力、## 出力
   * すべての説明文
   * パラメータの説明

3. **翻訳品質：**
   * 丁寧語（です・ます体）を使用
   * 専門的でありながらわかりやすい表現
   * 技術的な正確性を保つ
   * 標準的な日本語技術用語を使用

4. **フォーマット：**
   * すべての Markdown フォーマットを保持
   * 表の構造を維持
   * 免責事項は追加しないでください（システムが文書末尾に自動追加します）

以下の英語ドキュメントを日本語に翻訳してください（免責事項は含めないでください）：

5. **重要ルール - 出力名：** 出力テーブルの最初の列には出力名（例：`positive`、`negative`、`latent`、`image`、`model`、`conditioning`）が含まれています。これらは**英語のままにしてください**。出力名を翻訳すると重複エントリが発生し、文書構造が壊れます。

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

## 入力

| パラメータ        | 説明                                                                                                                               | データ型   | 必須  | 範囲                                                                          |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------- | ------ | --- | --------------------------------------------------------------------------- |
| `エンジン`       | レンダリングエンジン。各選択肢は、それをサポートするアバターのみをリスト表示します。'auto' はすべてのアバターを提供し、最適なエンジンを選択します（Avatar IV 優先）。Avatar V は最高忠実度、Avatar III は最も低コストです。 | COMBO  | はい  | `"auto"`<br />`"avatar_iv"`<br />`"avatar_iii"`<br />`"avatar_v"`           |
| `カスタムアバターID` | オプションのHeyGenアバタールックID。設定すると、上記で選択したアバターを上書きします。HeyGenの3000以上の公開ルック（またはプライベートアバター）を使用できます。                                        | STRING | いいえ |                                                                             |
| `スピーチ`       | テキストスクリプト（HeyGenテキスト読み上げ）またはご自身のオーディオでアバターを駆動します。                                                                                | 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                                                   |

`s speech` が `"script"` に設定されている場合、以下のサブパラメータが利用可能です：

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

`s 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`