> ## 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 파트너 노드를 사용해 Create 및 Modify 이미지 워크플로를 진행하는 방법을 안내합니다.

**ComfyUI**에서 **Luma Uni-1** 은 통합 이미지 작업을 위한 **파트너 노드**로 제공됩니다: **Create** 그래프는 프롬프트(선택적 레퍼런스 포함)로 새 이미지를 생성하고, **Modify** 그래프는 기존 이미지를 입력으로 받아 편집합니다. 두 모드 모두 평소 워크플로처럼 **Load Image** / **Save Image** 노드를 연결하고, Luma 노드에서 프롬프트, 시드, 종횡비, 레퍼런스 슬롯을 설정한 후 로컬에서 그래프를 실행하거나 **Comfy Cloud**에서 템플릿을 열면 됩니다.

Luma는 Uni-1을 비확산, 디코더 전용 자기회귀 모델로 설명하며, 그리기 전에 프롬프트를 추론합니다. 캔버스에서 가장 중요한 것은 **Create vs Modify** 모드를 선택하고, 레퍼런스를 명확히 라벨링하고, 시드로 반복 작업하는 것입니다.

이 페이지는 ComfyUI **내부에서** Uni-1을 사용하는 방법, 간단한 그래프부터 다중 레퍼런스 구성까지 설명합니다.

## Uni-1만의 특징

* **두 가지 명확한 모드**: Create Image (새로운 이미지 생성) 및 Modify Image (기존 이미지 편집)
* **최대 9장의 레퍼런스 이미지**, 각각 역할 정의 가능
* **니치하고 구체적인 비주얼 스타일에 강력한 제어력**
* **시드 지원**으로 재현성과 통제된 반복 작업 가능
* **9가지 종횡비**, 울트라톨에서 울트라와이드까지
* **실제로 읽을 수 있는 텍스트 렌더링**
* **실시간 맥락을 위한 웹 검색 기반 보강**
* **다국어 프롬프트**
* **시간적 일관성을 갖춘 멀티 패널 출력**

모드와 레퍼런스 제어 방법을 이해하면 Uni-1을 이해한 것입니다.

## 강점

Uni-1은 다양한 작업에서 뛰어납니다:

* 재질 정확도가 높은 **포토리얼리즘**
* 강력한 미학적 통제가 가능한 **일러스트 & 스타일라이즈드 아트**
* **오래된 사진 복원** 및 빈티지 재현
* **초현실적이고 개념적인** 컴포지션
* **텍스트 렌더링** — 이미지 내 읽을 수 있는 글자, 인포그래픽과 포스터에 탁월
* **이미지 편집** 및 다단계 개선
* 정체성을 보존하는 **레퍼런스 기반 생성**
* **멀티 패널 출력** — 여러 프레임에 걸쳐 일관된 캐릭터/장면

## 핵심 구분: Create vs Modify

Uni-1의 모든 것은 한 가지 질문으로 시작합니다: **새로운 것을 만들고 싶은가, 이미 존재하는 것을 바꾸고 싶은가?**

| 모드               | 하는 일                                           | 사용 시점                      |
| ---------------- | ---------------------------------------------- | -------------------------- |
| **Create Image** | 완전히 새로운 컴포지션을 생성합니다. 레퍼런스를 참고할 수 있습니다.         | "이 사진의 스타일로 새로운 장면을 만들어 줘" |
| **Modify Image** | 특정 입력 이미지를 편집합니다. 별도의 지시가 없으면 컴포지션과 구조를 유지합니다. | "이 사진을 밤처럼 보이게 만들어 줘"      |

의심스럽다면:

* 결과물이 **입력 이미지의 버전**처럼 보여야 한다면 Modify를 사용하세요
* **영감은 받았지만 새롭게** 느껴져야 한다면 Create를 사용하세요

## 사용 가능한 워크플로

### Image Create 워크플로

<Card title="클라우드에서 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="클라우드에서 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>

워크플로는 간단합니다: **프롬프트 → 평가 → 다듬기**. 탐색 단계에서는 시드를 비워 두세요. 마음에 드는 결과를 찾으면 시드를 고정하고 거기서부터 반복하세요.

## 핵심 파라미터

| 파라미터                  | 설명                                                                  |
| --------------------- | ------------------------------------------------------------------- |
| **프롬프트**              | 주된 제어 수단. 최대 6,000자. 정확하게 작성하세요.                                    |
| **종횡비**               | 프레이밍을 제어하며 품질에는 영향을 주지 않습니다. 용도에 맞게 선택하세요.                          |
| **시드**                | 동일한 시드 + 동일한 프롬프트 → 동일한 결과. 동일한 시드 + 변경된 프롬프트 → 통제된 변화. 시드 없음 → 탐색. |
| **레퍼런스 이미지** (Create) | 다양한 측면을 가이드할 최대 9장의 이미지.                                            |
| **소스 이미지** (Modify)   | 편집 중인 이미지. 해상도는 자동으로 유지됩니다.                                         |

## 레퍼런스 이미지 활용하기

레퍼런스는 모델에게 그 용도를 알려줄 때만 제대로 작동합니다. 다음과 같은 구조를 사용하세요:

```text theme={null}
IMAGE1 ([설명])을 [역할] 레퍼런스로 사용하세요.
```

가능한 역할: **Style**, **Character**, **Composition**, **Color palette**, **Lighting**, **Texture**, **Mood**.

역할을 지정하지 않으면 모델이 추측하고, 추측은 신뢰할 수 없습니다.

### Create 모드 예시

**스타일 레퍼런스**

```text theme={null}
IMAGE1(느슨한 붓질과 따뜻한 노을 톤의 인상파 유화)을 STYLE 레퍼런스로 사용하세요.
IMAGE1의 색채 팔레트와 회화적 질감을 적용해 30대 여성의 초상화를 만드세요.
피사체는 새로운 인물이어야 합니다.
```

**캐릭터 레퍼런스**

```text theme={null}
IMAGE1(짧은 구릿빛 적갈색 머리, 주근깨를 가진 여성)을 CHARACTER 레퍼런스로 사용하세요.
그녀의 특징을 유지합니다. 새로운 장면을 생성하세요: 그녀가 부드러운 조명의 카페에 앉아 있습니다.
```

**다중 레퍼런스**

```text theme={null}
IMAGE1을 COLOR PALETTE 레퍼런스, IMAGE2를 LIGHTING, IMAGE3을 COMPOSITION으로 사용하세요.
비에 젖은 거리를 밤에 걸어가는 외로운 인물을 만드세요.
```

### Modify 모드 예시

Modify 모드에서는 명확성이 전부입니다. 항상 **무엇을 바꿀지** 그리고 **무엇이 변하지 않아야 하는지**를 명시하세요.

```text theme={null}
시간대를 골든 아워로 변경하세요. 하늘, 빛의 방향, 그림자, 색온도를 업데이트하세요.
모든 피사체와 컴포지션은 그대로 유지하세요.
```

```text theme={null}
비를 더 세게 만들고 바닥에 반사를 추가하세요. 다른 모든 요소는 변경하지 마세요.
```

## 프롬프팅 가이드라인

권장 길이:

* **텍스트-이미지** → 80–250단어
* **레퍼런스 가이드** → 100–300단어
* **Modify** → 30–100단어

모호한 표현("아름다운", "놀라운"), 중복된 문구, 상충되는 지시를 피하세요. 대신 구체적이고 명명된 미적 감각을 사용하세요:

* `골든 아워, 85mm 렌즈, 얕은 피사계 심도`
* `1970년대 이탈리아 지알로 영화 포스터, 고대비 컬러 블로킹`

정밀함이 일반성을 능가합니다.

## 종횡비

이미지가 사용될 곳에 따라 선택하세요:

| 비율        | 사용 사례       |
| --------- | ----------- |
| 1:1       | 소셜 미디어 게시물  |
| 9:16      | 세로 영상       |
| 16:9      | 와이드 스크린     |
| 3:2 / 2:3 | 사진          |
| 2:1 / 3:1 | 시네마틱 / 파노라마 |
| 1:2 / 1:3 | 울트라 톨       |

Modify 모드에서는 종횡비가 소스 이미지에 고정됩니다.

## 시드: 통제와 재현성

시드는 실험을 시스템으로 바꿉니다.

* **고정 시드** → 일관성
* **시드 없음** → 탐색

워크플로:

1. 시드 없이 탐색
2. 좋은 결과 발견
3. 시드 고정
4. 한 번에 하나의 변수만 변경

프롬프트와 시드를 함께 저장하세요. 재사용 가능한 레시피입니다.

## 고급 기법

### 캐릭터 일관성

1. 깨끗하고 정면을 바라보는 레퍼런스 이미지 생성
2. 모든 장면에서 `IMAGE1 (CHARACTER)`로 재사용
3. 프롬프트에서 라벨을 동일하게 유지

### 다중 레퍼런스 아키텍처

이미지당 하나의 역할을 할당합니다:

* IMAGE1 → 캐릭터
* IMAGE2 → 스타일
* IMAGE3 → 조명
* IMAGE4 → 환경

프롬프트 끝에 추가:

```text theme={null}
각 레퍼런스는 할당된 레이어에 대해서만 권한을 가집니다.
```

### 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을 마스터하는 것은 세 가지로 요약됩니다: **올바른 모드 선택 → 레퍼런스 통제 → 의도적 반복**. 이것만 갖추면 더 이상 추측하지 않고 감독할 수 있습니다.
