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

# LumaImageNode - ComfyUI Built-in Node Documentation

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

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

根据文本提示和宽高比同步生成图像。此节点使用文本描述创建图像，并允许您通过多种参考输入（包括角色图像和风格图像）控制图像尺寸和风格。

## 输入

| 参数         | 说明                                      | 数据类型      | 是否必填 | 取值范围                                                                                              |
| ---------- | --------------------------------------- | --------- | ---- | ------------------------------------------------------------------------------------------------- |
| `提示词`      | 图像生成的提示词（默认：空字符串）。长度至少为 3 个字符。          | STRING    | 是    | -                                                                                                 |
| `模型`       | 用于图像生成的模型选择。不同模型成本不同。                   | COMBO     | 是    | `photon-flash-1`<br />`photon-1`<br />`photon`                                                    |
| `宽高比`      | 生成图像的宽高比（默认：`16:9`）                     | COMBO     | 是    | `16:9`<br />`1:1`<br />`4:3`<br />`3:2`<br />`21:9`<br />`9:16`<br />`3:4`<br />`2:3`<br />`9:21` |
| `种子`       | 用于判断节点是否应重新运行的种子；实际结果与种子无关，具有非确定性（默认：0） | INT       | 是    | 0 到 18446744073709551615                                                                          |
| `风格图权重`    | 风格图像的权重。若未提供 `风格参考图` 则忽略此参数（默认：1.0）     | FLOAT     | 否    | 0.0 到 1.0                                                                                         |
| `Luma 参考图` | Luma 参考节点连接，用于通过输入图像影响生成结果；最多可考虑 4 张图像。 | LUMA\_REF | 否    | -                                                                                                 |
| `风格参考图`    | 风格参考图像；仅使用 1 张图像。                       | IMAGE     | 否    | -                                                                                                 |
| `角色参考图`    | 角色参考图像；可为多张图像的批次，最多可考虑 4 张图像。           | IMAGE     | 否    | -                                                                                                 |

**参数约束：**

* `prompt` 去除首尾空格后长度至少为 3 个字符。
* `image_luma_ref` 参数最多可接受 4 张参考图像。
* `character_image` 参数最多可接受 4 张角色参考图像。
* `style_image` 参数仅接受 1 张风格参考图像。
* `style_image_weight` 参数仅在提供了 `style_image` 时生效。

## 输出

| 输出名称     | 说明           | 数据类型  |
| -------- | ------------ | ----- |
| `output` | 根据输入参数生成的图像。 | IMAGE |

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

***

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