For the complete documentation index, see llms.txt. This page is also available as Markdown.

Image Edit Nodes

Image editing nodes refine, restyle, and modify existing images using text instructions. Three core nodes range from fully generative edits to precise localized modifications, used heavily for iterati

When to use image edit nodes

  • Refine generated images. Take output from Image Generation and adjust composition, style, or content with text instructions rather than re-rolling the entire generation.

  • Isolate subjects for 3D. Use the generative edit nodes (Text + Image → Image) to remove backgrounds, isolate single objects, or clean up cluttered references before feeding into image-to-3D.

  • Apply style transfer. Bring an existing image into a different aesthetic via Text + Image → Image with style-reference inputs.

  • Make surgical changes. To modify a specific aspect (color, lighting, single element) without altering the rest of the image.

  • Generate variations from a reference. Use Text + Image List → Image with multiple references to produce assets that combine aesthetic elements from several inputs.

Atlas provides powerful image-editing nodes that can accept text + at least one image input:

  • Text + Image → Image Node

  • Text + Image List → Image Nodes

These nodes share the same core idea:

  • You provide an image (or multiple images) and a text instruction, and the node generates a modified image using the chosen backend.

They differ in how much freedom the model has:

  • Text+ Image Image and Text + Image List Image nodes allow fully generative edits

  • It can keep the original image untouched except for the specified modification.

Nodes Overview

Text + Image Image

A flexible, image-conditioned generation engine.

  • Requires text + image(s)

  • Merges all input images with the instruction

  • Allows scene transformations, object replacement, isolation

  • Produces new images guided by the provided visuals

  • Different backends = different image generation models

Text + Image List Image

A versatile, multi-reference image generation engine.

  • Requires a text prompt + an array of up to 4 images

  • Synthesizes multiple visual inputs based on complex text instructions

  • Supports object isolation, composition of multiple scenes, targeted edits and perspective shifts

  • Produces a single output image by referencing specific inputs (e.g., image_0, image_1)

  • Can change aspect ratio to expand the scene

  • Different backends (Gemini, Reve, Flux, etc.) offer varying levels of aesthetic quality and logic handling.


Inputs

Required:

  • Text prompt

  • At least one image

Optional:

  • Multiple images

These inputs can be manually uploaded or generated via other nodes.

Backends (the AI model powering the node)

You may choose from multiple backend generative models. Each backend interprets images differently:

  • Some are more realistic

  • Some preserve structure better

  • Some are more stylized

  • Some adhere more strictly to prompts

Switching backend changes the artistic and structural behavior.


Seed Control

Changing the seed gives new variations while keeping:

  • the same structure

  • the same instruction

  • the same conditioning images

Keeping the seed = reproducible outputs.


Example Use Cases:

Style Transformation of a Scene

Turn a normal bookshelf into a fantasy enchanted bookshelf.

Variation with Seed Change

Same prompt + same image + same backends + different seeds = different variations.

Restyling While Preserving Layout

Transform the bookshelf into an old, damaged one while keeping the structure.

Isolate an Object with Neutral Background

Perfect for Image → 3D workflows.

Multi-Image Conditioning for Object Replacement

Replace specific items on a shelf using three reference object images.

Adding Details to a Generated Asset

Example: adding decorative elements or small props without changing the underlying concept.

Removing Objects

Changing the Design Style

You can restyle the asset into a new design language (e.g., Scandinavian / futuristic / gothic) while keeping the same layout and camera.

Changing the seed gives controlled alternatives of the same style.

Changing Image Aspect Ratio

Common pitfalls

  • Using a fully-generative node when you want a precise edit. Text + Image → Image rewrites the whole image. If you only want to change a single element, use Edit Image with Text instead. Otherwise you'll get unintended changes elsewhere.

  • Conflicting text and image guidance. When the text instruction contradicts the reference image, output quality drops. Make sure prompts align with the visual reference, especially when using multiple reference images.

  • Over-editing iteratively. Each pass through an edit node loses some fidelity. After 3-4 chained edits, the image often degrades visibly. For complex changes, either combine instructions into a single edit pass or re-generate from a refined prompt.

  • Forgetting Text + Image List for multi-reference cases. When combining style, subject, and lighting from different references, Text + Image List → Image accepts multiple images. Using Text + Image → Image with a single reference and trying to describe the others in text rarely works.

  • Image Generation Nodes — the upstream source of images that often feed into edit nodes.

  • 2D Post Processing Nodes — finishing operations (camera framing, upscaling, background removal) after edits are complete.

  • Mesh Nodes — image-to-3D nodes consume the output of edit operations. Edit nodes are commonly used to isolate subjects before 3D conversion.

  • Utility Nodes — Describe Image and Text Generation (LLM) can refine edit instructions; Create Image List supports multi-reference Text + Image List workflows.

Frequently asked questions

When should I use Text + Image → Image ?

Text + Image → Image can be used for fully generative purposes: the output is a new image guided by your prompt and reference. Use it for major transformations (style transfer, composition changes, subject swaps). Also it can be used for fully conservative purposes: the original image is preserved except where the instruction explicitly changes things. Use it for surgical edits (color shift, single element change, minor cleanup).

Can I use multiple reference images in a single edit?

Yes, with Text + Image List → Image. The node accepts an image array (built via Create Image List in Utility Nodes) and uses all references when generating output. Useful for blending style references with subject references.

Can edit nodes upscale or change resolution?

Edit nodes preserve resolution by default. For upscaling, use the dedicated upscale nodes in 2D Post Processing.

Last updated