Precise edit (Ideogram 4.5)
ideogram_precise_editEdit an image while keeping untouched pixels exactly as they are: apply a prompt, optional black-mask region, reference images, and a context window to guide changes.
Instructions
Edit an image with Ideogram 4.5 at its exact size: pixels the edit does not change stay as they are. Takes the image, an optional mask (black = edit), up to 4 reference images that guide the edit, and context_window to confine it. Results are saved to the output directory; ideogram_quote prices a call first (nothing is generated).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mask | No | Local mask image file or a public https URL, the same size as the source | |
| seed | No | Random seed for a reproducible result | |
| image | No | Local image file to work on, or a public https URL of one | |
| model | No | The model (default ideogram-4-5); each takes the fields of its variant below | |
| prompt | No | What to create or change, in natural language | |
| wait_s | No | Seconds to wait for the result (0-50, default 45). The job is accepted first; if it is still running when the wait ends, the result is its generation_id for ideogram_generation (never resubmitted, never billed twice). | |
| private | No | Keep the result out of Ideogram's public feed; true unless you set false (enterprise accounts are always private) | |
| quality | No | very_low, low, medium or high: higher costs more | |
| num_images | No | How many images to make (each is billed) | |
| inline_images | No | true: each saved image is also returned as image content (base64; one over 3.75 MB, or past 10 MB in total, by path only), for a client without file access | |
| context_window | No | Where to edit: "none" (whole image, default), "auto" (around the mask) or "y_min,x_min,y_max,x_max" | |
| reference_images | No | Local image files (or public https URLs) that guide the edit (never edited themselves); at most 4, at most 3 with a mask | |
| image_asset_identifier | No | An Ideogram asset (an upload or an earlier result) instead of a local image | |
| enable_copyright_detection | No | Run Ideogram's copyright detection on the result (adds latency) | |
| reference_image_asset_identifiers | No | Ideogram assets that guide the edit; needs the edited image by reference too, not with a mask |