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

Ideogram modelsimage generation api

ideogram-ai/ideogram-v3/replace-background

Ideogram 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 effortle...

Input
Cyber punk city with neon lights and skyscrappers

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

The image URL whose background needs to be replaced

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
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 Replace Background

replace background in the Ideogram lineup is built to rebuild the setting behind a retained foreground subject from written direction. The ideogram v3 replace background configuration combines that transformation with the quality and motion profile represented by this exact model version, so teams can choose it deliberately among adjacent family variants. It is useful when the input already establishes part of the creative intent and the model must supply a polished result rather than a generic media conversion, with subject identity, scene logic, visual hierarchy, and the delivery goal kept explicit.

For production work with ideogram-ai/ideogram-v3/replace-background, begin with the non-negotiable content, then describe the desired change, framing, action, atmosphere, and finishing cues in that order. Separate what must remain recognizable from what may vary, and prefer concrete nouns and observable actions over abstract praise. That structure makes outputs easier to compare across storyboard passes, campaign variants, catalog assets, and other repeatable creative pipelines.

Highlights

Foreground-aware replacement. Keeps the principal subject readable while synthesizing a new environment behind it.

Contextual scene integration. Reconciles perspective, illumination, shadows, and color between foreground and setting.

Typography-conscious composition. Retains designed wording when the changed background surrounds labels, posters, or campaign copy.

ideogram v3 replace background art-directed regeneration. Builds a requested environment from language instead of limiting the result to stock templates. This is the defining creative strength of the ideogram v3 replace background configuration.

Pricing

Rendering modePrice per image
TURBO$0.030
BALANCED$0.060
QUALITY$0.090

Billing follows params.rendering_speed == "TURBO" ? 0.03 : params.rendering_speed == "QUALITY" ? 0.09 : 0.06.

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/replace-background/input_image_0.webp",
  "images": [
    [
      "https://example.com/reference.png"
    ]
  ],
  "prompt": "https://example.com/reference.png"
}

Technical Specs

SpecValue
Model IDideogram-ai/ideogram-v3/replace-background
Inputsimage, images, 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/editIdeogram 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.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.