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

# Luma Uni-1 使用指南

> 在 ComfyUI 中使用 Luma Uni-1 合作伙伴节点进行图像创建与编辑。

在 **ComfyUI** 里，Luma **Uni-1** 以 **合作伙伴 API 节点**形式接入：**Create** 路线根据提示词生成新图（可挂多张参考图）；**Modify** 路线以已有图像为输入做定向编辑。操作上与普通工作流相同——用 **加载图像** / **保存图像** 与 Luma 节点串联，在节点上填写提示词、种子、宽高比与参考图槽位，再在本地排队运行或通过 **Comfy Cloud** 打开下方模板。

Luma 将 Uni-1 表述为非扩散、自回归类的模型，会在成图前对提示词做推理；在画布侧更需要关注的是 **Create / Modify** 选型、参考图角色写清楚，以及用种子做可控迭代。

下文说明如何在 **ComfyUI 工作流**里用好 Uni-1——从最简单的节点连线到多参考组合。

## Uni-1 的特点

* **两种清晰的模式**：Create Image（创建新图像）和 Modify Image（编辑已有图像）
* **最多 9 张参考图**，每张都可以指定明确的角色
* **强力控制**特定的小众视觉风格
* **支持种子（seed）**，便于复现和受控迭代
* **9 种宽高比**，从超高到超宽
* **文字渲染** — 图像内可读的文字，非常适合信息图和海报
* **网页搜索**作为背景知识来源
* **多语言提示词**支持
* **多面板输出** — 跨多帧保持角色/场景一致性

理解了模式与参考图控制方式，你就理解了 Uni-1。

## 强项

Uni-1 在广泛的任务中表现优异：

* **照片级真实感**与材质精度
* **插画与风格化艺术**，审美控制力强
* **老照片修复**与复古再现
* **超现实与概念性**构图
* **文字渲染** — 图像内可读的文字，擅长信息图与海报
* **图像编辑**与多轮细化
* **参考图引导生成**，可保持人物身份一致性
* **多面板输出** — 多帧间保持角色/场景一致

## 核心区别：Create 还是 Modify

使用 Uni-1 之前，先问自己一个问题：**我是要创建全新的内容，还是要修改已有的内容？**

| 模式               | 作用                  | 适用场景              |
| ---------------- | ------------------- | ----------------- |
| **Create Image** | 生成全新的构图，可参考输入图像     | "以这张照片的风格创建一个新场景" |
| **Modify Image** | 编辑指定的输入图像，默认保留构图与结构 | "把这张照片改成夜晚"       |

判断不清时：

* 如果输出应当像输入图像的**某个版本**，使用 Modify
* 如果输出应当**受其启发但全新**，使用 Create

## 可用工作流

### Image Create 工作流

<Card title="在 Cloud 上运行 Image Create" icon="cloud" href="https://cloud.comfy.org/?template=api_luma_uni_1_image_create&utm_source=docs">
  在 Comfy Cloud 上即时体验 Image Create 工作流。
</Card>

<Card title="下载 Image Create 工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_luma_uni_1_image_create.json">
  下载 JSON 或在模板库中搜索 "Luma UNI-1 Image Create"
</Card>

### Image Edit 工作流

<Card title="在 Cloud 上运行 Image Edit" icon="cloud" href="https://cloud.comfy.org/?template=api_luma_uni_1_image_edit&utm_source=docs">
  在 Comfy Cloud 上即时体验 Image Edit 工作流。
</Card>

<Card title="下载 Image Edit 工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_luma_uni_1_image_edit.json">
  下载 JSON 或在模板库中搜索 "Luma UNI-1 Image Edit"
</Card>

工作流很简单：**提示词 → 评估 → 优化**。探索阶段保持种子为空，找到效果不错的结果后再锁定种子并迭代。

## 核心参数

| 参数                           | 说明                                        |
| ---------------------------- | ----------------------------------------- |
| **Prompt 提示词**               | 你最主要的控制手段，最多 6,000 字符，越精确越好               |
| **Aspect ratio 宽高比**         | 控制画面框比例，不影响质量，根据用途选择                      |
| **Seed 种子**                  | 同种子+同提示词 → 同结果；同种子+改提示词 → 受控变化；无种子 → 自由探索 |
| **Reference images（Create）** | 最多 9 张参考图，引导生成的不同方面                       |
| **Source image（Modify）**     | 待编辑的源图，尺寸会被自动保留                           |

## 使用参考图

参考图必须指定用途才会生效。使用以下结构：

```text theme={null}
Use IMAGE1 ([description]) as a [ROLE] reference.
```

可选角色：**Style（风格）**、**Character（角色）**、**Composition（构图）**、**Color palette（色板）**、**Lighting（光照）**、**Texture（纹理）**、**Mood（氛围）**。

不指定角色时，模型只能猜测，结果不可靠。

### Create 模式示例

**风格参考**

```text theme={null}
Use IMAGE1 (impressionist oil painting with loose brushwork and warm
sunset tones) as a STYLE reference. Create a portrait of a woman in her
30s applying IMAGE1's color palette and painterly texture. The subject
should be new.
```

**角色参考**

```text theme={null}
Use IMAGE1 (woman with short copper-red hair, freckles) as a CHARACTER
reference. Preserve her features. Generate a new scene: she's sitting
in a softly lit café.
```

**多参考组合**

```text theme={null}
Use IMAGE1 as a COLOR PALETTE reference, IMAGE2 as LIGHTING, IMAGE3 as
COMPOSITION. Create a lone figure walking through a rain-slicked street
at night.
```

### Modify 模式示例

Modify 模式中，**清晰**最重要，必须明确说明**要改什么**与**不能动什么**。

```text theme={null}
Change the time of day to golden hour. Update sky, light direction,
shadows, and color temperature. Keep all subjects and composition
unchanged.
```

```text theme={null}
Make the rain heavier and add reflections on the ground. Keep all other
elements unchanged.
```

## 提示词撰写建议

推荐长度：

* **文生图（Text-to-image）** → 80–250 词
* **参考图引导** → 100–300 词
* **Modify** → 30–100 词

避免：

* 模糊词汇（"beautiful"、"amazing"）
* 重复表达
* 自相矛盾的指令

应使用具体、有命名的美学描述：

* `Golden hour, 85mm lens, shallow depth of field`
* `1970s Italian giallo film poster, high-contrast color blocking`

精确胜过笼统。

## 宽高比

按用途选择：

| 比例        | 用途       |
| --------- | -------- |
| 1:1       | 社交媒体帖子   |
| 9:16      | 竖屏视频     |
| 16:9      | 宽屏       |
| 3:2 / 2:3 | 摄影       |
| 2:1 / 3:1 | 电影感 / 全景 |
| 1:2 / 1:3 | 超高画幅     |

Modify 模式下，宽高比锁定为源图比例。

## 种子（Seed）：控制与可复现

种子能让试验变成系统化流程。

* **固定种子** → 一致性
* **无种子** → 自由探索

工作流：

1. 不设种子，自由探索
2. 找到效果不错的结果
3. 锁定种子
4. 一次只改一个变量

将提示词和种子一起保存，就是你可复用的"配方"。

## 进阶技巧

### 角色一致性

1. 先生成一张干净的、正面的角色参考图
2. 在每个场景中复用该图作为 `IMAGE1 (CHARACTER)`
3. 保持标签在所有提示词中一致

### 多参考图架构

为每张参考图分配一个角色：

* IMAGE1 → 角色
* IMAGE2 → 风格
* IMAGE3 → 光照
* IMAGE4 → 环境

提示词末尾加上：

```text theme={null}
Treat each reference as having authority over its assigned layer only.
```

### Create → Modify 链式工作流

先用 Create 探索构图，再用 Modify 精修细节，这是最强大的工作流之一。

### 迭代式优化

1. 不设种子探索
2. 锁定种子
3. 每次只改一个变量
4. 记录结果

看似更慢，但因为每次都明确知道改了什么，实际效率更高。

## 故障排查

| 问题           | 解决方法            |
| ------------ | --------------- |
| 参考图被忽略       | 给每张参考图明确打标签     |
| Modify 改动过多  | 显式声明哪些部分必须保持不变  |
| 输出不一致        | 锁定种子            |
| 提示词被部分忽略     | 删除冲突项或拆分为多步     |
| 输出看起来就是参考图本身 | 可能误用了 Modify 模式 |
| 角色不一致        | 复用同一张标准参考图      |

## 快速参考

**Create Image**

* 全新构图
* 文本 + 最多 9 张参考图
* 描述性提示词

**Modify Image**

* 编辑已有图像
* 源图 + 参考图
* 直接、外科式的指令

## 黄金法则

1. 给每张参考图打标签
2. Modify 模式下，永远说明**不能改**的部分
3. 优化时，一次只改一个变量
4. 保存提示词 + 种子，便于复现
5. Create = 新场景，Modify = 编辑

## 核心要点

掌握 Uni-1 的核心是三件事：**选对模式 → 控制参考图 → 有意识地迭代**。三者到位后，你就不再是"碰运气"，而是在"导演"。