# AI Image Editor

<figure><img src="/files/MvGgQ5ZSi2BK4Yo4Em6j" alt=""><figcaption><p>Add or Remove Object and Change Lighting</p></figcaption></figure>

### The Quick 4-Step Workflow

1. **Bring in your image:** Click Upload Image or Select Asset in the middle of the screen.
2. **Pick your editing tool:** Click the Edit Mode dropdown to select how you want to modify the image.

<figure><img src="/files/CCQG2poy8oBTfe7jnFnB" alt="" width="375"><figcaption><p>Select from Edit Options</p></figcaption></figure>

1. **Refine the details:** Choose an Action (if using Edit Area), use sliders, or upload product cutouts to guide the changes.&#x20;

<figure><img src="/files/ItMXGfwRvGYpSg9yU7Q6" alt="" width="375"><figcaption><p>Edit Controls (Except for Place Object &#x26; Background)</p></figcaption></figure>

1. **Hit generate:** Choose how many variations you want, pick your quality, and watch your edits apply.

> 🔄 Note: As soon as you upload an image, the big buttons in the center will disappear to show your active workspace. To discard your changes and start completely fresh on a new image, just click the `+ New Edit` button at the top of your right-hand history gallery.

<figure><img src="/files/uJEwFwRdVZjz9aJnaRkl" alt="" width="244"><figcaption><p>New Edit Button on Top Right Side</p></figcaption></figure>

### 1. Import Your Image

Get started by placing your image into the center workspace:

* **Upload Image:** Select any photo, layout, or render from your local device.
* **Select Asset:** Open your built-in ArchiX library to select an image you previously generated.

<figure><img src="/files/gKZHelCponkTdo38KsMY" alt="" width="365"><figcaption><p>Upload New or Select from Library</p></figcaption></figure>

### 2. Choose Your Edit Mode

Click the top dropdown box under Edit Mode to open your editing toolkit. Depending on which tool you select, your left sidebar will instantly change to give you specific controls for that task:

#### Edit Area

This is your primary tool for making custom design changes. Use it to select a specific part of your image (like a couch, a wall, or a floor) and modify it using text instructions.

* **The Paintbrush:** Color over the exact object or area you want to alter.

<figure><img src="/files/AwQTOPjxQHXMWirJFzsG" alt="" width="375"><figcaption><p>Paintbrush Mode</p></figcaption></figure>

* **Auto-select:** Instead of manually painting over an object, click this tool and hover over the item you want to change. The AI will instantly read the edges of the object (like a chair, a window, or a plant) and select it perfectly with a single click, saving you time.

<figure><img src="/files/6iu3jfvnaMuF230OP14R" alt="" width="375"><figcaption><p>Auto-select Mode</p></figcaption></figure>

* **Hand Tool:** When you zoom in close to work on fine, tiny details, select the Hand tool to click and drag your way around the image. This lets you slide the picture around your workspace without accidentally painting over areas you want to keep.

<figure><img src="/files/jkz7IDphcbrovuofULN8" alt="" width="375"><figcaption><p>Hand Tool and Zoom</p></figcaption></figure>

* **The Eraser:** Made a mistake while brushing? Use the eraser icon next to the brush tool to clean up your selection area.

<figure><img src="/files/1SWcRENy55qPWVHRJDRA" alt="" width="375"><figcaption><p>Eraser Mode</p></figcaption></figure>

* **Request & Prompt Panels:** Once an area is painted, these panels unlock below so you can choose a specific design action (like *Replace*, *Recolor*, or *Retexture*) and type your keywords.

<figure><img src="/files/9F3tywtArWtgckjXBwk8" alt="" width="252"><figcaption><p>Add Additional Options</p></figcaption></figure>

#### Place Objects

Use this mode to drop real-world furniture, decor, or architectural fixtures directly into your scene.

<figure><img src="/files/nANbIR0qpuzb25PclNSq" alt="" width="253"><figcaption><p>Choose Object to Insert</p></figcaption></figure>

* **Product Placement Box:** Click the upload area inside the sidebar to import an image of the specific item you want to insert.

<figure><img src="/files/iYDN0zIVhmEFF2tt87cp" alt="" width="375"><figcaption><p>Adjust the Size and Placement</p></figcaption></figure>

* **Tip for Best Results:** Always use images with a transparent background (such as a clean `.png` cutout). This ensures the furniture blends seamlessly into your render without any awkward white boxes around it. Once uploaded, you can scale and position the item directly on your canvas.

<figure><img src="/files/AT4fw3t7CwMHpNxkXhfX" alt="" width="375"><figcaption><p>Advamce Perspective Placement</p></figcaption></figure>

* **Advanced Perspective Placement** (best used for for Carpets or Wallpaper) To ground flat objects like carpets or wall treatments into the scene's 3D perspective, use the Advanced Perspective tool (the box with corners, shown highlighted in the bottom toolbar).

  * **To Activate:** Click the perspective tool. A 4-point control grid will appear over your item.&#x20;

  <figure><img src="/files/veFe0lK2iWyOcZXE8dKl" alt="" width="251"><figcaption><p>Free Transform</p></figcaption></figure>

  * **To Manipulate:** Drag these control nodes (circles) to align your item's perspective with the room's geometry.

  <figure><img src="/files/TCJBiBERZ3n3Eu5OzOUu" alt="" width="375"><figcaption><p>Adjust the Perspective of Reference Image</p></figcaption></figure>

#### 🎛️ Tone Adjustment

<figure><img src="/files/3ypktxcgL0FoNtRsq1HS" alt="" width="375"><figcaption><p>Tone Adjustment</p></figcaption></figure>

If your layout is perfect but you want to tweak the photographic qualities of the image, use this mode to manually balance the image settings. The sidebar will split into two tuning categories:

* **Color Sliders:**
  * `Temperature`: Shift the room from cool blue tones to warm, cozy golden tones.
  * `Tint`: Balance the green and magenta color profiles of the lighting.
  * `Saturation`: Crank up the color intensity or fade it down for a more muted, neutral look.
* **Light Sliders:** Fine-tune the brightness and structural contrast using individual sliders for `Brightness`, `Contrast`, `Highlights`, `Shadows`, `Whites`, and `Blacks` to give your presentation perfect depth.

#### Background

<figure><img src="/files/IRWpvD7wvuqp0wCwi6ms" alt=""><figcaption><p>Background Changes</p></figcaption></figure>

Instantly change the entire environment surrounding your building or visible through the windows. Expand the Background (Optional) drop-down menu and click Background Type to choose from highly localized atmospheric presets:

* `Japanese Corner House`: Sets a clean, residential neighborhood corner environment.
* `Japanese Urban House`: Places your design within a standard modern city residential lot.
* `Japanese Urban Business Street`: Surrounds your project with a lively, high-density commercial district.
* `Traditional Japanese Street`: Frames your building against a classic, historic streetscape finish.

<figure><img src="/files/659ZrIQFlYsCqyx1NCXf" alt="" width="375"><figcaption><p>Background Adjuster</p></figcaption></figure>

#### Remove Brush

<figure><img src="/files/MV2LWKpH4c1cDN9ZlhLC" alt=""><figcaption><p>Mask and Erase</p></figcaption></figure>

Your quick-fix tool for clearing clutter, removing unwanted objects, or wiping away minor visual anomalies.

* **Mask & Erase:** Simply select this mode, paint directly over the item or glitch you want gone, and leave all text boxes completely blank. The AI will seamlessly dissolve the object away while automatically patching and rebuilding the background architecture beneath it.

<figure><img src="/files/M3LCNA7GGKrpT5f9icOr" alt="" width="375"><figcaption><p>Mask Desired Remove Area</p></figcaption></figure>

### 3. Select an Action & Add Descriptions (For Edit Area)

If you are using the Edit Area mode, expand the Request and Prompt menus to tell the AI exactly how to alter the brushed section. Click the Select Action dropdown to choose your design strategy:

<figure><img src="/files/epJO4IKwVm9YI85hBjWD" alt="" width="249"><figcaption></figcaption></figure>

| **Select This Action** | **What It Does**                                                 | **What to Put in the Prompt Box**                                        |
| ---------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------ |
| Replace                | Swaps a brushed item out for something completely different.     | Type the new object (e.g., *"minimalist oak coffee table"*).             |
| Add                    | Drops a new element cleanly into the brushed space.              | Type what you want to insert (e.g., *"potted fiddle leaf fig plant"*).   |
| Remove                 | Completely erases an item from the brushed area.                 | Leave the prompt box completely blank to wipe it away.                   |
| Recolor                | Updates the color of a surface without changing its texture.     | Type your new color choice (e.g., *"matte black"* or *"charcoal gray"*). |
| Retexture              | Swaps out the surface material entirely while keeping its shape. | Type the new material finish (e.g., *"light oak hardwood planks"*).      |
| Keep                   | Locks a specific element in place so the AI leaves it untouched. | Type what the item is to ensure the system protects it perfectly.        |

#### How to Use the Prompt Box

Don't worry about writing perfect sentences in the optional Prompt box. Treat it like a simple notepad:

<figure><img src="/files/l3PDeJxFVd9htMXEP5FF" alt="" width="252"><figcaption><p>Open the Dropdown to Reveal the Menu</p></figcaption></figure>

* **No full sentences required:** Just list your everyday keywords separated by commas (e.g., *"white marble, polished finish, modern"*).
* **Let the optimizer do the work:** Once you type your simple keywords, click the ⚡ Optimize Prompt button, and our system will automatically clean up your notes into a highly detailed instruction for the AI.

<figure><img src="/files/TajVDKonwm55HJ0UPjr6" alt="" width="252"><figcaption><p>Optimize Promt</p></figcaption></figure>

### 4. Quality & Generating

* **Image Count:** Select 1, 2, or 3 to choose how many different edited variations you want the AI to create at the same time.

<figure><img src="/files/cMieTYIuTJjjSWDitEav" alt="" width="253"><figcaption><p>Choose Number of Variants</p></figcaption></figure>

* **The Generate Button:** The number displayed directly on the button shows exactly how many credits your current configuration will use. Click the small arrow right inside the button to switch between your quality tiers:
  * **Standard Quality:** 20 credits per image variation.
  * **HD Quality:** 30 credits per image variation.

> 📁 Where did my work go? Every edit variation you generate is automatically saved chronologically on the right side of your screen. You can see your original upload right next to the new creation to track your changes. Click View All at the bottom of that column to browse or manage your entire project history gallery.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.archix.ai/en/ai-rendering-tools/ai-image-editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
