live
MODEL IDideogram:4.6@precise-edit

Ideogram 4.6 Precise Edit

Ideogram
by
Available with Zero Data Retention

Ideogram 4.6 Precise Edit is the precision editing variant of Ideogram 4.6. It applies a natural-language instruction to a source image, optionally limited by a mask and guided by up to four reference images, and returns the result at the source's exact dimensions. It accepts sources up to 8192x8192, and an edit limited to one region keeps a 4K or 8K source at full resolution. It suits retouching, exact color changes, product detail repair, and masked edits.

Ideogram 4.6 Precise Edit

Region edits

How to set settings.editRegion on Ideogram 4.6 Precise Edit: choosing auto, a box or the whole image, drawing the box and keeping an 8K source at full size.

Introduction

Ideogram 4.6 Precise Edit accepts sources up to 8192 × 8192. settings.editRegion decides which part of the source is sent to the model, the whole frame or one region of it, and on a source larger than 4096 × 4096 that choice also decides the size of the result.

A bright open-plan kitchen with a white marble island under three small black pendant lights, open oak shelves of cookbooks on the right and a garden window on the left, with the edit region drawn around the pendants

Photorealistic real estate listing photograph of a bright open-plan kitchen: a long white marble island runs across the middle of the frame, with three small matte black dome pendant lights hanging in a row above it in the upper middle of the frame. On the right wall, open oak shelves hold rows of cookbooks with readable spines, white ceramic bowls and small glass jars. White shaker cabinets and a large window with a garden view on the left. Wide straight-on shot at eye level with a 24mm lens, bright natural daylight, crisp detail everywhere.

Source and regionResult

The source is 4096 × 2304, and the result comes back at 4096 × 2304 with everything outside the box as it was.

This guide covers the three values of the setting, when the choice matters, drawing a box and sending the whole image.

Three ways to set the region

settings.editRegion takes one of three values:

ValueWhat the model works onUse it for
autoA region chosen automatically around the change. This is the default.Local edits on sources up to 4096 × 4096
A boxExactly the box you give, as [x1, y1, x2, y2]Local edits on larger sources, and any edit you want bounded
noneThe whole imageA change meant for the whole frame, such as relighting

A box is four whole numbers in pixels of the source image: the left and top edges, then the right and bottom edges. The hero's request:

Try in Playground
import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'ideogram:4.6@precise-edit',
  positivePrompt: 'Replace the three small black pendant lights above the kitchen island with three large woven rattan dome pendants, hanging at the same height. Keep everything else in the image exactly the same.',
  inputs: {
    seedImage: 'https://assets.runware.ai/guides/ideogram-4-6-precise-edit/region-edits/source-kitchen.jpg'
  },
  settings: {
    editRegion: [
      960,
      96,
      3136,
      1152
    ]
  }
})
import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "ideogram:4.6@precise-edit",
            "positivePrompt": "Replace the three small black pendant lights above the kitchen island with three large woven rattan dome pendants, hanging at the same height. Keep everything else in the image exactly the same.",
            "inputs": {
                "seedImage": "https://assets.runware.ai/guides/ideogram-4-6-precise-edit/region-edits/source-kitchen.jpg"
            },
            "settings": {
                "editRegion": [
                    960,
                    96,
                    3136,
                    1152
                ]
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "imageInference",
      "taskUUID": "9e4b2f61-3a87-4d15-b0c8-7f1e5d3a9c26",
      "model": "ideogram:4.6@precise-edit",
      "positivePrompt": "Replace the three small black pendant lights above the kitchen island with three large woven rattan dome pendants, hanging at the same height. Keep everything else in the image exactly the same.",
      "inputs": {
        "seedImage": "https://assets.runware.ai/guides/ideogram-4-6-precise-edit/region-edits/source-kitchen.jpg"
      },
      "settings": {
        "editRegion": [
          960,
          96,
          3136,
          1152
        ]
      }
    }
  ]'
runware run ideogram:4.6@precise-edit \
  positivePrompt="Replace the three small black pendant lights above the kitchen island with three large woven rattan dome pendants, hanging at the same height. Keep everything else in the image exactly the same." \
  inputs.seedImage=https://assets.runware.ai/guides/ideogram-4-6-precise-edit/region-edits/source-kitchen.jpg \
  settings.editRegion.0=960 \
  settings.editRegion.1=96 \
  settings.editRegion.2=3136 \
  settings.editRegion.3=1152
{
  "taskType": "imageInference",
  "taskUUID": "9e4b2f61-3a87-4d15-b0c8-7f1e5d3a9c26",
  "model": "ideogram:4.6@precise-edit",
  "positivePrompt": "Replace the three small black pendant lights above the kitchen island with three large woven rattan dome pendants, hanging at the same height. Keep everything else in the image exactly the same.",
  "inputs": {
    "seedImage": "https://assets.runware.ai/guides/ideogram-4-6-precise-edit/region-edits/source-kitchen.jpg"
  },
  "settings": {
    "editRegion": [
      960,
      96,
      3136,
      1152
    ]
  }
}
Response
[
  {
    "taskType": "imageInference",
    "taskUUID": "9e4b2f61-3a87-4d15-b0c8-7f1e5d3a9c26",
    "imageUUID": "c2f7a9d4-8e13-4b60-a5d1-3e9c6b2f8a47",
    "imageURL": "https://im.runware.ai/image/os/a14d18/ws/2/ii/c2f7a9d4-8e13-4b60-a5d1-3e9c6b2f8a47.jpg"
  }
]

When the region matters

The same pendant edit ran with each setting on the kitchen at 4096 × 2304, and on an 8192 × 4608 version of it, upscaled two times:

SourceBoxautonone
4096 × 23044096 × 23044096 × 23044096 × 2304
8192 × 46088192 × 46085440 × 30605440 × 3060

Up to 4096 × 4096, every setting returns the source's size, with the same detail: on the 4K kitchen the new pendants were equally sharp with a box and with none, and the parts the instruction did not touch came back unchanged in every run.

Above it, only a box keeps the full size. With auto or none, the 8K kitchen came back at 5440 × 3060, about 16.6 megapixels, so a print master or a 4K crop for a detail tile loses a third of its width. For any local edit on a source that large, draw the box.

Drawing the box

Take the coordinates from the full-size file. A box measured on a 1920-pixel preview of a 4K photo lands in the wrong place, because the numbers count pixels of inputs.seedImage itself.

A box is also a hard boundary: nothing outside it can change. Draw it too tight and the edit stops in a straight line at its edge.

An office lounge with a long deep green velvet sofa against a white brick wall, with a narrow edit region drawn over the middle of the sofa

Photorealistic office lounge photograph: a long three-seat sofa in deep green velvet with slim black metal legs stands centered against a painted white brick wall, spanning the middle half of the frame from left to right and sitting in the lower half, with three square cushions in the same green velvet. A low black coffee table in front of it, a tall fiddle leaf fig in a white pot on the far left, and a framed black and white city print on the wall above the sofa. Soft daylight, shot straight-on at seated eye level with a 28mm lens.

Source and regionNarrow box
The same lounge with an edit region drawn around the whole sofa and some wall and floor around it

Photorealistic office lounge photograph: a long three-seat sofa in deep green velvet with slim black metal legs stands centered against a painted white brick wall, spanning the middle half of the frame from left to right and sitting in the lower half, with three square cushions in the same green velvet. A low black coffee table in front of it, a tall fiddle leaf fig in a white pot on the far left, and a framed black and white city print on the wall above the sofa. Soft daylight, shot straight-on at seated eye level with a 28mm lens.

Source and regionBox around the sofa

Draw the box around the whole object, with a margin for its shadow and anything else the change touches.

When to send the whole image

none is for a change meant for the whole frame, such as relighting or a change of season, so the whole image goes to the model.

On a source up to 4096 × 4096, none keeps the source's size. Above it, the result comes back scaled down, the 8K kitchen to about 16.6 megapixels, so run the local edits first with boxes, and the whole-frame pass last, on the copy that is allowed to shrink.

Tips

  1. Draw a box on any source above 4096 × 4096. It is the one setting that returns an 8K source at its full size.

  2. Leave it on auto up to 4096 × 4096. It picks the region around the change, and the result keeps the source's size.

  3. Box the whole object. The edit stops at the edge of the box, so leave a margin for the shadow.

  4. Measure on the full-size source. The coordinates count pixels of inputs.seedImage, not of a preview.

  5. One region per request. For two areas far apart, run two edits in a row, each with its own box.

  6. Save none for whole-frame changes. On a large source, run it last, after the local edits.