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

# HeyGenCreateAvatarNode - ComfyUI Built-in Node Documentation

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

根据人物照片或文本提示描述的角色，创建一个可复用的 HeyGen 虚拟形象。生成的虚拟形象 ID 可与 HeyGen 虚拟形象视频节点配合使用，制作包含该虚拟形象的视频。

## 输入

| 参数   | 描述                            | 数据类型  | 是否必填 | 范围                        |
| ---- | ----------------------------- | ----- | ---- | ------------------------- |
| `来源` | 通过文本提示生成新角色，或根据连接的人物照片创建虚拟形象。 | COMBO | 是    | `"prompt"`<br />`"photo"` |

当 `source` 设置为 `"prompt"` 时，将显示以下额外参数：

| 参数                 | 描述                       | 数据类型   | 是否必填 | 范围           |
| ------------------ | ------------------------ | ------ | ---- | ------------ |
| `prompt`           | 要生成的虚拟形象描述（最多 1000 个字符）。 | STRING | 是    | 1 至 1000 个字符 |
| `reference_images` | 最多 3 张参考图像，用于指导生成的外观。    | IMAGE  | 否    | 0 至 3 张图像    |

当 `source` 设置为 `"photo"` 时，将显示以下额外参数：

| 参数               | 描述                             | 数据类型  | 是否必填 | 范围   |
| ---------------- | ------------------------------ | ----- | ---- | ---- |
| `identity_photo` | 要转化为虚拟形象的人物照片。若分辨率大于 2K，将自动缩小。 | IMAGE | 是    | 单张图像 |

**注意：** `source` 参数可在两种模式间切换。在 `"prompt"` 模式下，您需提供文本描述，并可选择提供最多 3 张参考图像。在 `"photo"` 模式下，您需提供一张人物照片。这两种模式互斥。

## 输出

| 输出名         | 描述                                                               | 数据类型   |
| ----------- | ---------------------------------------------------------------- | ------ |
| `avatar_id` | 虚拟形象外观 ID。将其传递给 HeyGen 虚拟形象视频的 `custom_avatar_id`；保存后可后续复用该虚拟形象。 | STRING |
| `预览`        | 生成的虚拟形象预览图像。                                                     | IMAGE  |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/zh.md)

***

**Source fingerprint (SHA-256):** `c60e9cdb0d91fb5ec6ea83b503b9aa10c978ce065a16c751a52e90c12e70a5e2`