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 GuidesEditing images
How to edit an image with Ideogram 4.6 Precise Edit: the request, one instruction per change, the output size and the four quality tiers.
Introduction
Ideogram 4.6 Precise Edit applies one natural-language instruction to an existing image and returns the edited image at the source's dimensions. It is built for the edits a product team runs every day: a stain on a packshot, a price on a sign, a prop on a shelf, a lawn that needs to look like spring.
Drag the slider across the left toe: the leather grain and the stitching around the stain line up with the source.
This guide covers the request, the instruction, the output size and the quality tiers.
The request
An edit takes two required fields: the image in inputs.seedImage and the instruction in positivePrompt. The source sets the size of the output, so the request has no width or height.
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: 'Remove the green grass stain from the toe of the left sneaker, so the leather there is clean white like the rest of the shoe. Keep everything else in the image exactly the same.',
inputs: {
seedImage: 'https://assets.runware.ai/guides/ideogram-4-6-precise-edit/editing-images/source-sneakers.jpg'
}
})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": "Remove the green grass stain from the toe of the left sneaker, so the leather there is clean white like the rest of the shoe. Keep everything else in the image exactly the same.",
"inputs": {
"seedImage": "https://assets.runware.ai/guides/ideogram-4-6-precise-edit/editing-images/source-sneakers.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "imageInference",
"taskUUID": "1f6c3a85-7e29-4d40-9b13-5a8e2c7f4d06",
"model": "ideogram:4.6@precise-edit",
"positivePrompt": "Remove the green grass stain from the toe of the left sneaker, so the leather there is clean white like the rest of the shoe. Keep everything else in the image exactly the same.",
"inputs": {
"seedImage": "https://assets.runware.ai/guides/ideogram-4-6-precise-edit/editing-images/source-sneakers.jpg"
}
}
]'runware run ideogram:4.6@precise-edit \
positivePrompt="Remove the green grass stain from the toe of the left sneaker, so the leather there is clean white like the rest of the shoe. Keep everything else in the image exactly the same." \
inputs.seedImage=https://assets.runware.ai/guides/ideogram-4-6-precise-edit/editing-images/source-sneakers.jpg{
"taskType": "imageInference",
"taskUUID": "1f6c3a85-7e29-4d40-9b13-5a8e2c7f4d06",
"model": "ideogram:4.6@precise-edit",
"positivePrompt": "Remove the green grass stain from the toe of the left sneaker, so the leather there is clean white like the rest of the shoe. Keep everything else in the image exactly the same.",
"inputs": {
"seedImage": "https://assets.runware.ai/guides/ideogram-4-6-precise-edit/editing-images/source-sneakers.jpg"
}
}Response
[
{
"taskType": "imageInference",
"taskUUID": "1f6c3a85-7e29-4d40-9b13-5a8e2c7f4d06",
"imageUUID": "b4e8d1a7-6c35-4f92-8a0e-2d7b9c5f1e63",
"imageURL": "https://im.runware.ai/image/os/a14d18/ws/2/ii/b4e8d1a7-6c35-4f92-8a0e-2d7b9c5f1e63.jpg"
}
]Three optional fields shape the edit further, each with a guide of its own: reference images to take a product or a logo from, a mask to aim the edit at one area, and an edit region for large sources and small, exact changes.
Writing the instruction
Precise Edit works best with one change per request, stated as an action on a named target. Three verbs cover most of the work: remove, change and add. Each instruction below names the target by what it is and where it is, then closes with what has to stay.
Box the text you change. The instruction quotes the old price and the new one, and settings.editRegion draws a box around the "$5", in pixels of the source. Nothing outside a box can change, and here the result matches the source pixel for pixel outside it. "In the same hand-lettered style" keeps the new number in the board's lettering instead of a clean font pasted on top. Without the box, the same kind of change went wrong in three of four runs on this board, adding a second price beside the first or rewriting another line. Boxes are covered in Region edits.
Place an addition against something already there. "On the empty part of the oak shelf, next to the rolled towel" gives the fern a surface and a neighbor, so its position and its scale both come from the scene. To pin the spot exactly, draw it with a mask.
List the neighbors in the keep clause when the change covers a large area. The lawn touches the path, the hedges and the porch, so the instruction names each of them: "Keep the house, the porch, the path, the hedges and the sky exactly the same."
The output size
At low, medium and high, the result comes back at the source's exact dimensions, from a phone photo to a 4096 × 4096 master. The edit can be diffed against the original or dropped into the layout the original came from without a resize.
very_low is the exception. It returns at most about 4.2 megapixels, so a larger source comes back scaled down: the 3072 × 2048 driveway below came back at 2496 × 1664.
Above 4096 × 4096, the size of the result depends on settings.editRegion, and only a box keeps the full size. See Region edits.
Choosing a quality tier
settings.quality takes very_low, low, medium or high, and medium is the default. The lower tiers return faster and cost less. The four results below share the source, the instruction and the seed.

Real estate listing photograph of a two-story modern house with dark wood cladding and a white garage door, seen from the street. A silver hatchback is parked in the paved driveway in front of the garage, and a neat green lawn with ornamental grasses runs along the right side. Soft late afternoon light, shot on a 24mm lens at standing height.

Remove the silver hatchback parked in the driveway, and continue the paved driveway and the edge of the lawn where it stood. Keep the house, the garage door, the plants and the light exactly the same.

Remove the silver hatchback parked in the driveway, and continue the paved driveway and the edge of the lawn where it stood. Keep the house, the garage door, the plants and the light exactly the same.

Remove the silver hatchback parked in the driveway, and continue the paved driveway and the edge of the lawn where it stood. Keep the house, the garage door, the plants and the light exactly the same.

Remove the silver hatchback parked in the driveway, and continue the paved driveway and the edge of the lawn where it stood. Keep the house, the garage door, the plants and the light exactly the same.
Every tier removed the car. The tiers differ in how cleanly the scene continues where it stood. At very_low the siding behind it carries a lighter patch where the boards do not line up, while low and up continue the boards and the paving joints without a seam. A removal also says what goes in the gap, "continue the paved driveway and the edge of the lawn", so the model fills it with the scene instead of a guess.
Check the instruction at very_low, which returns large sources at a reduced size, then render the one you keep at a higher tier.
Tips
-
One change per request. Run a second edit on the result for the next change.
-
Name the target by what and where. "The toe of the left sneaker" points at one spot on one shoe.
-
Box small text changes. Quote the old and the new text, and draw
settings.editRegionaround it so nothing else on the layout can change. -
Anchor additions to the scene. A surface and a neighbor set both the position and the scale.
-
Say what fills a removal. "Continue the paved driveway" is the instruction for the gap.
-
Close with a keep clause. List the neighbors of a large change by name.
-
Draft at
very_low, ship at a higher tier. It is the cheapest way to check that an instruction lands, and it returns large sources at a reduced size.







