> ## 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 Guide
> Use Luma Uni-1 partner nodes in ComfyUI for Create and Modify image workflows.
In **ComfyUI**, Luma **Uni-1** shows up as **partner Partner Nodes** for unified image work: **Create** graphs generate new images from prompts (with optional references); **Modify** graphs take an existing image as input and edit it in place. You drive both through the usual workflow—wire **Load Image** / **Save Image**, set prompts, seeds, aspect ratio, and reference slots on the Luma node, then queue the graph locally or open a template on **Comfy Cloud**.
Luma describes Uni-1 as a non-diffusion, decoder-only autoregressive model that reasons over your prompt before drawing. On the canvas, what matters most is choosing **Create vs Modify**, labeling references clearly, and iterating with seeds.
This page focuses on how to use Uni-1 **inside ComfyUI**, from simple graphs to multi-reference setups.
## What makes Uni-1 different
* **Two clear modes**: Create Image (generate something new) and Modify Image (edit something existing)
* **Up to 9 reference images**, each with a defined role
* **Strong control over niche and specific visual styles**
* **Seed support** for reproducibility and controlled iteration
* **Nine aspect ratios**, from ultra-tall to ultra-wide
* **Text rendering** that's actually readable
* **Web search grounding** for real-world context
* **Multilingual prompts**
* **Multi-panel output** with temporal consistency
If you understand the modes and how to control references, you understand Uni-1.
## Strengths
Uni-1 excels across a wide range of tasks:
* **Photorealism** with material accuracy
* **Illustration & stylized art** with strong aesthetic control
* **Old photo restoration** and vintage reproduction
* **Surreal and conceptual** compositions
* **Text rendering** — readable text inside images, great for infographics and posters
* **Image editing** and multi-turn refinement
* **Reference-guided generation** with identity preservation
* **Multi-panel output** — consistent characters/scenes across multiple frames
## The core distinction: Create vs Modify
Everything in Uni-1 starts with one question: **Am I creating something new, or changing something that already exists?**
| Mode | What it does | When to use |
| ---------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------- |
| **Create Image** | Produces a brand-new composition. Can be inspired by references. | "Create a new scene in the style of this photo" |
| **Modify Image** | Edits a specific input image. Preserves composition and structure unless told otherwise. | "Make this photo look like nighttime" |
When in doubt:
* If the output should look like a **version of your input**, use Modify
* If it should feel **inspired but new**, use Create
## Available workflows
### Image Create workflow
Try the Image Create workflow instantly on Comfy Cloud.
Download JSON or search "Luma UNI-1 Image Create" in Template Library
### Image Edit workflow
Try the Image Edit workflow instantly on Comfy Cloud.
Download JSON or search "Luma UNI-1 Image Edit" in Template Library
The workflow is simple: **prompt → evaluate → refine**. Leave the seed blank while exploring. Once you find something strong, lock the seed and iterate from there.
## Core parameters
| Parameter | Description |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Prompt** | Your primary control. Up to 6,000 characters. Be precise. |
| **Aspect ratio** | Controls framing, not quality. Choose based on use case. |
| **Seed** | Same seed + same prompt → same result. Same seed + changed prompt → controlled variation. No seed → exploration. |
| **Reference images** (Create) | Up to 9 images to guide different aspects. |
| **Source image** (Modify) | The image you are editing. Dimensions are preserved automatically. |
## Working with reference images
References only work if you tell the model what they are for. Use this structure:
```text theme={null}
Use IMAGE1 ([description]) as a [ROLE] reference.
```
Possible roles: **Style**, **Character**, **Composition**, **Color palette**, **Lighting**, **Texture**, **Mood**.
Without roles, the model guesses, and guesses are unreliable.
### Create mode examples
**Style reference**
```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.
```
**Character reference**
```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é.
```
**Multi-reference**
```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 mode examples
In Modify mode, clarity is everything. Always specify **what to change** and **what must stay untouched**.
```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.
```
## Prompting guidelines
Recommended lengths:
* **Text-to-image** → 80–250 words
* **Reference-guided** → 100–300 words
* **Modify** → 30–100 words
Avoid vague terms ("beautiful", "amazing"), redundant phrasing, and conflicting instructions. Instead, use specific, named aesthetics:
* `Golden hour, 85mm lens, shallow depth of field`
* `1970s Italian giallo film poster, high-contrast color blocking`
Precision beats generality.
## Aspect ratios
Choose based on where the image will live:
| Ratio | Use case |
| --------- | --------------------- |
| 1:1 | Social posts |
| 9:16 | Vertical video |
| 16:9 | Widescreen |
| 3:2 / 2:3 | Photography |
| 2:1 / 3:1 | Cinematic / panoramic |
| 1:2 / 1:3 | Ultra-tall |
In Modify mode, aspect ratio is locked to the source image.
## Seeds: control and reproducibility
Seeds turn experimentation into systems.
* **Fixed seed** → consistency
* **No seed** → exploration
Workflow:
1. Explore with no seed
2. Find a strong result
3. Lock the seed
4. Change one variable at a time
Save your prompt and seed together. That's your reusable recipe.
## Advanced techniques
### Character consistency
1. Generate a clean, front-facing reference image
2. Reuse it as `IMAGE1 (CHARACTER)` in every scene
3. Keep the label identical across prompts
### Multi-reference architecture
Assign one role per image:
* IMAGE1 → character
* IMAGE2 → style
* IMAGE3 → lighting
* IMAGE4 → environment
End the prompt with:
```text theme={null}
Treat each reference as having authority over its assigned layer only.
```
### Create → Modify chain
Use Create to explore compositions, then Modify to refine details. This is one of the most powerful workflows.
### Iterative refinement
1. Explore (no seed)
2. Lock seed
3. Change one variable per generation
4. Document results
It feels slower, but it's actually faster, because you always know what changed.
## Troubleshooting
| Problem | Fix |
| ------------------------------------- | ----------------------------------------- |
| References ignored | Label each one clearly |
| Modify changes too much | Explicitly state what must stay unchanged |
| Inconsistent outputs | Lock the seed |
| Prompt partially ignored | Remove conflicts or split into steps |
| Output looks like the reference image | You may be in Modify mode |
| Character inconsistency | Reuse a canonical reference image |
## Quick reference
**Create Image**
* New compositions
* Text + up to 9 references
* Descriptive prompts
**Modify Image**
* Edits existing images
* Source image + references
* Direct, surgical prompts
## The golden rules
1. Label every reference
2. In Modify mode, always state what should **not** change
3. Change one variable at a time when refining
4. Save prompt + seed for reproducibility
5. Create = new scenes, Modify = edits
## Key takeaway
Mastering Uni-1 comes down to three things: **choose the right mode → control your references → iterate with intention**. Once those are in place, you're no longer guessing, you're directing.