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

# Luma Text to Image API 节点 ComfyUI 官方示例

> 本文将介绍如何在 ComfyUI 中使用 Luma Text to Image API 节点的相关功能

[Luma Text to Image](/zh-CN/built-in-nodes/api-node/image/luma/luma-text-to-image) 节点允许你使用Luma AI的先进技术根据文本提示词生成高质量的图像，能够创建照片级别的逼真内容和艺术风格图像。

本篇指南中，我们将引导你如何使用对应节点来进行文本生图的工作流设置。

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

<Tip>
  如果在加载下面的工作流文件时，你发现存在节点缺失，可能是因为以下情况：

  1. 你使用的 ComfyUI 版本不是最新的开发（nightly）版本。
  2. 你使用的 ComfyUI 版本是稳定（release）版本或桌面版（desktop）版本（不包含最新的功能更新）。
  3. 你使用的 ComfyUI 版本是最新的 commit 版本，但在启动过程中部分节点导入失败了。

  请先确保你已经成功更新 ComfyUI 到最新的开发（nightly）版本, 请查看：[如何更新 ComfyUI](zh-CN/installation/update_comfyui) 部分了解如何更新 ComfyUI。
</Tip>

## Luma Text to Image 节点文档

你可查阅下面的文档了解对应节点的详细参数设置等

<Card title="Luma Text to Image 节点文档" icon="book" href="/zh-CN/built-in-nodes/api-node/image/luma/luma-text-to-image">
  Luma Text to Image API 节点说明文档
</Card>

<Card title="Luma Reference 节点文档" icon="book" href="/zh-CN/built-in-nodes/api-node/image/luma/luma-reference">
  Luma Reference API 节点说明文档
</Card>

## Luma Text to Image API 节点文本生图工作流

在 `Luma Text to Image` 节点没有使用任何的图像输入时，对应的工作流则为文生图工作流，在本篇指南中，我们制作了使用`style_image` 和 `image_luma_ref` 的示例。
能够让你体验到 Luma AI 在相关图像处理上的优秀能力。

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

下面的图片的`metadata`中已经包含工作流信息，请下载并拖入 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. 按步骤完成工作流的运行

![Luma 文本生图工作流步骤图](https://mintlify.s3.us-west-1.amazonaws.com/dripart-train-lora-docs/images/tutorial/api_nodes/luma/luma_t2i_step_guide.jpg)

你可参考图片中的序号来完成最基础的工作流运行  

1. 在 `Load image` 节点中上传参考图像
2. 在 `Load image（已重命名为 styleref）` 节点中上传风格参考图像
3. （可选）修改 `Luma Text to Image` 节点的提示词
4. （可选）修改 `style_image_weight` 的权重，来调整风格参考图像的权重
5. 点击 `Run` 按钮，或者使用快捷键 `Ctrl(cmd) + Enter(回车)` 来执行图片的生成
6. 等待 API 返回结果后，你可在`Save Image`节点中查看生成的图像, 对应的图片也会被保存至`ComfyUI/output/` 目录下

![不同 style\_image\_weight 效果对比](https://mintlify.s3.us-west-1.amazonaws.com/dripart-train-lora-docs/images/tutorial/api_nodes/luma/t2i_style_image_weight.jpg)

### 3. 补充说明

* [对应的节点](/zh-CN/built-in-nodes/api-node/image/luma/luma-text-to-image)同时允许最多同时分别输入 4 张参考图和角色参考。
* 如果要启用多张图像输入参考，请在对应“紫色”的处于`绕过(Bypass)` 的节点上右键，将对应的 `模式（mode）` 设置为 `总是（always）`