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

# Luma 文生图合作节点 ComfyUI 官方示例

> 本文介绍如何在 ComfyUI 中使用 Luma 文生图合作节点

Luma 文生图节点允许你使用 Luma AI 的高级技术，根据文本提示生成高质量图像，能够创建照片级写实内容和艺术风格图像。

## Luma 文生图擅长什么

* **高质量文生图生成**：根据文本提示词生成逼真内容和艺术风格图像
* **风格参考**：`style_image` 输入用于引导结果的视觉风格，`style_image_weight` 控制风格参考图像的影响程度
* **图像和角色参考**：`image_luma_ref` 输入支持参考引导生成，可同时使用最多 4 张参考图像和角色参考

## 示例输出

不同 `style_image_weight` 值下的风格引导生成，展示了风格参考图像的影响：

<img src="https://mintcdn.com/dripart-docs-custom-nodes-sdk-v2-frontend/eIcaTwArXXbGzGMg/images/tutorial/api_nodes/luma/t2i_style_image_weight.jpg?fit=max&auto=format&n=eIcaTwArXXbGzGMg&q=85&s=db19afad8d5c3f2d23d59a44126cc8f5" alt="风格图像权重对比" width="2100" height="1867" data-path="images/tutorial/api_nodes/luma/t2i_style_image_weight.jpg" />

<Tip>
  使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](/zh/tutorials/partner-nodes/overview)部分文档来了解使用 API 节点的具体使用要求。
</Tip>

<Tip>
  <Tabs>
    <Tab title="本地用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新版（每夜版）。
      2. 启动时有些节点导入失败。
    </Tab>

    <Tab title="云端用户">
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新。

      所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。
    </Tab>
  </Tabs>
</Tip>

## Luma 文生图合作节点工作流

当 `Luma 文生图` 节点在没有任何图像输入的情况下使用时，它即可作为文生图工作流运行。在本指南中，我们使用 `style_image` 和 `image_luma_ref` 创建了示例，以展示 Luma AI 出色的图像处理能力。

### 1. 下载工作流文件

工作流信息包含在下方图像的元数据中。下载该图像并将其拖入 ComfyUI，即可加载工作流。

![Luma 文生图工作流](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/luma/t2i/luma_t2i.png)

请下载以下图像作为输入：

![输入图像 - 参考](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/luma/t2i/input_ref.png)
![输入图像 - 风格](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/luma/t2i/input_style.png)

### 2. 按照步骤运行工作流

<img src="https://mintcdn.com/dripart-docs-custom-nodes-sdk-v2-frontend/eIcaTwArXXbGzGMg/images/tutorial/api_nodes/luma/luma_t2i_step_guide.jpg?fit=max&auto=format&n=eIcaTwArXXbGzGMg&q=85&s=c067fd3c2ebbde7b578e7d5d48bb1640" alt="Luma 文生图工作流步骤" width="2796" height="1694" data-path="images/tutorial/api_nodes/luma/luma_t2i_step_guide.jpg" />

请按照图像中的编号步骤完成基本工作流：

1. 在 `加载图像` 节点中上传参考图像
2. 在 `加载图像（已重命名为 styleref）` 节点中上传风格参考图像
3. （可选）修改 `Luma 文生图` 节点中的提示词
4. （可选）调整 `style_image_weight`，以控制风格参考图像的影响程度
5. 点击 `运行` 按钮，或使用快捷键 `Ctrl(cmd) + Enter` 生成图像
6. API 返回结果之后，在 `保存图像` 节点中查看已生成的图像。图像会保存到 `ComfyUI/output/` 目录中

<img src="https://mintcdn.com/dripart-docs-custom-nodes-sdk-v2-frontend/eIcaTwArXXbGzGMg/images/tutorial/api_nodes/luma/t2i_style_image_weight.jpg?fit=max&auto=format&n=eIcaTwArXXbGzGMg&q=85&s=db19afad8d5c3f2d23d59a44126cc8f5" alt="风格图像权重对比" width="2100" height="1867" data-path="images/tutorial/api_nodes/luma/t2i_style_image_weight.jpg" />

### 3. 补充说明

* 该节点最多支持同时使用 4 张参考图像和角色参考。
* 要启用多个图像输入，请右键单击紫色的“Bypassed”节点，并将其 `mode` 设置为 `always`