Ideogram 4.6 Precise Edit

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.

Complete technical specification for integration
Ready-to-use code snippets for common workflows
Step-by-step tutorials for advanced use cases
← All GuidesRegion 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.
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:
| Value | What the model works on | Use it for |
|---|---|---|
auto | A region chosen automatically around the change. This is the default. | Local edits on sources up to 4096 × 4096 |
| A box | Exactly the box you give, as [x1, y1, x2, y2] | Local edits on larger sources, and any edit you want bounded |
none | The whole image | A 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:
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:
| Source | Box | auto | none |
|---|---|---|---|
| 4096 × 2304 | 4096 × 2304 | 4096 × 2304 | 4096 × 2304 |
| 8192 × 4608 | 8192 × 4608 | 5440 × 3060 | 5440 × 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.
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
-
Draw a box on any source above 4096 × 4096. It is the one setting that returns an 8K source at its full size.
-
Leave it on
autoup to 4096 × 4096. It picks the region around the change, and the result keeps the source's size. -
Box the whole object. The edit stops at the edge of the box, so leave a margin for the shadow.
-
Measure on the full-size source. The coordinates count pixels of
inputs.seedImage, not of a preview. -
One region per request. For two areas far apart, run two edits in a row, each with its own box.
-
Save
nonefor whole-frame changes. On a large source, run it last, after the local edits.




