Ideogram 4.5 Edit.

Ideogram 4.5 Edit Overview

Ideogram 4.5 Edit transforms images with text prompts, reference images and optional masks. Create image variations for design and visual content on each::labs.

Text instructions, a source image and optional edit references or masks steer the revision.

Ideogram 4.5 Edit from Ideogram is available through each::labs in the ideogram family. Required fields are prompt, image_url.

reference_image_urls: Up to four references plus the primary source, or three references plus the primary source and mask. mask_url: Mask matching the source dimensions.

Use the Ideogram 4.5 Edit API when you need this transformation or analysis as a repeatable step in an application or creative pipeline. The sections below distinguish the required material, adjustable controls and checks that matter before delivery.

Capabilities

• Text instructions, a source image and optional edit references or masks steer the revision.
• reference_image_urls: Up to four references plus the primary source, or three references plus the primary source and mask.
• mask_url: Mask matching the source dimensions.
• image_size: auto preserves source geometry, downscaled by the provider if needed.
• image_url: Primary source image to edit.

Use Cases for Ideogram 4.5 Edit

Ideogram 4.5 Edit is useful when this specific operation fits between source preparation and delivery. These scenarios show how it can support different parts of a working pipeline.

Creators

Revise a poster layout. Use a representative source or a concise brief, then inspect the result before preparing a larger set of assets.

Design and marketing teams

Change an existing design concept. Compare the result with the intended message, composition and destination. Keep reviewable versions of the source and output.

Developers

Prepare image variations for visual review. Inspect the actual returned value before connecting it to another step, and keep the chosen request settings with the result.

Start with a clear definition of the desired result and use the exposed controls to reach it. Keep any additional generation, editing or application logic in separate steps so that the effect of this operation remains easy to review.

Tips and Tricks

Make the main subject, composition, lighting and intended visual style unambiguous. When references are available, state which details should be retained and which should change. Start with one clear creative direction before adding several competing requests.

• mask_url: Mask matching the source dimensions.
• image_size: auto preserves source geometry, downscaled by the provider if needed.

• Example direction: “Replace the background with a softly lit studio; keep the subject, colors and framing unchanged.”
• Example direction: “Make the lighting warmer while preserving the main subject and its visible details.”

Compare one deliberate adjustment at a time. Inspect the part of the result affected by that change, then check the rest of the asset or response for unwanted side effects before reusing the settings.

Technical Specifications

• Result type: array.
• Required fields: prompt, image_url.
• image_size: string; options auto, square, square_hd, portrait_4_3, landscape_4_3, portrait_16_9, landscape_16_9, custom; default "auto".
• prompt: string.
• reference_image_urls: array.
• mask_url: string.

image_url: Primary source image to edit.

Values must use the types and accepted options listed in the parameter reference. A displayed default does not remove a required-field requirement. Choose a supported output setting for this entry rather than borrowing a preset from a related model.

Things to Be Aware Of

Review lettering, small structures, edges and any requested product details at the intended display size. An attractive first impression is not enough to establish that a visual matches its brief.

Some input combinations have cross-field requirements. Check the conditional rules in the parameter reference before combining optional settings.

For media-based inputs, supply a directly retrievable file URL rather than a page containing the asset. Keep the source available while processing. Check the final content in the destination player, editor or application, not only the request status.

Key Considerations

Check the accepted mask and reference options for this entry rather than copying parameters from the text-to-image entry.

Public estimate: $0.008–$0.22 per image.

Prepare prompt, image_url before starting. Optional settings include reference_image_urls, mask_url, image_size. Keep these settings aligned with the intended delivery, especially when a later step expects a particular type or format.

Run a representative request before scaling to a larger collection. Judge the result against the source and the brief, and account for all generated outputs or usage-sensitive options when estimating a batch.

Limitations

• prompt: minimum characters: 1; maximum characters: 10000.
• reference_image_urls: maximum items: 4; item string; item format: uri.

Conditional combinations must also satisfy the cross-field rules. Unsupported parameters do not establish additional capabilities. A generated result can differ from the intended brief, so review detail and consistency before publication.