SandBase is live — $1 in free credits on signupStart free ›

Ideogram modelsimage generation api

ideogram-ai/ideogram-v3/edit

Ideogram V3 Edit by ideogram-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.

Input
The prompt to fill the masked part of the image.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The image URL to generate an image from. MUST have the exact same dimensions (width and height) as the mask image.

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The mask URL to inpaint the image. MUST have the exact same dimensions (width and height) as the input image.
The rendering speed to use. Allowed values: TURBO, BALANCED, QUALITY.
Seed for the random number generator
Idle

Example output — click Run to generate your own

API README

Ideogram V3 Edit

ideogram-ai/ideogram-v3/edit applies natural-language edits to a supplied image while preserving requested subjects, typography, and unaffected composition. Ideogram's editing workflow combines scene understanding with its typography and design strengths, making it useful for meaningful creative changes rather than only basic retouching. This combination makes the model a practical choice when the creative outcome depends on those qualities rather than on a generic media conversion.

For production work with ideogram-ai/ideogram-v3/edit, it suits copy updates, object changes, restyling, background revision, and campaign variations where the source artwork must remain the foundation. The result is most reliable when the source material and creative brief clearly describe the intended subject, progression, visual or sonic character, and the qualities that must remain unchanged.

Highlights

Multi-reference image editing. Uses the source and additional visual references to guide a coordinated revision.

Precision masked reconstruction. Changes selected regions while protecting important identity, typography, and unaffected composition.

V3 typography revision. Produces more accurate spelling and better integrated lettering inside edited designs.

Higher-fidelity integration. Matches texture, illumination, perspective, and fine detail so new content belongs in the scene.

Pricing

Rendering speedPrice per image
Turbo$0.030
Balanced$0.060
Quality$0.090

When to Use

✅ Good fit❌ Consider alternatives
The model's named workflow matches the source material and intended outputA different input modality or model route is required
A managed asynchronous result is suitable for the production pipelineA synchronous, interactive editor is essential
The documented controls cover the required duration, framing, or formatThe project needs controls outside this endpoint's schema
Creative iteration benefits from a repeatable request structureExact deterministic pixels, frames, geometry, or samples are mandatory
A finished downloadable media asset is the desired deliverableEditable source layers or a native project file are required

Prompt Guide

For image-conditioned generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.

{
  "image": "https://static.sandbase.ai/examples/ideogram-ai/ideogram-v3/edit/output_url_0.png",
  "images": [
    [
      "https://example.com/reference.png"
    ]
  ],
  "prompt": "black bag"
}

Technical Specs

SpecValue
Model IDideogram-ai/ideogram-v3/edit
Inputsimage, images, mask, prompt, rendering_speed, seed
Required inputsprompt, image
Output fieldscontent_type, url
ExecutionAsync (submit, then poll for result)

Related Models

Related Models

ideogram-ai/ideogram-v33.0 is Ideogram's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.ideogram-ai/ideogram-v3/characterIdeogram V3 Character is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/character/editIdeogram V3 Character Edit by ideogram-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.ideogram-ai/ideogram-v3/character/remixIdeogram V3 Character Remix is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/layerize-textIdeogram V3 Layerize Text is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/reframeIdeogram V3 Reframe is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/remixIdeogram V3 Remix is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/replace-backgroundIdeogram V3 Replace Background by ideogram-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.