Skip to content

Ideogram

Ideogram 3.0 Replace Background

Keep the subject of a source photo and describe a new setting for it. The model identifies the subject without a hand-drawn mask.

API model IDideogram/ideogram-3-replace-background
Palm fronds and patterned tiles replace the blue studio backdrop around the curved red chair.
A tropical settingPalm fronds and patterned tiles replace the blue studio backdrop around the curved red chair.

Source inputs

Best for

Technical details

Read the model documentation
API model ID
ideogram/ideogram-3-replace-background
Provider
Ideogram
Modality
Image
Input
Text prompt · Images
Output
Image
Endpoint
POST /v2/jobs
Workflow
Image edit

Request parameters

  • promptstring · Required

    Plain-language description of the new background, 1 to 4000 characters and not blank.

    1–4000 characters

  • imagestring · Required

    The image whose background is replaced;

    • the subject is detected automatically, no mask is needed, and its longer side may be at most 3 times its shorter side.
    • A public https URL that answers without a redirect;
    • JPEG, PNG or WEBP, up to 50 MB.
  • privateboolean

    Whether to keep the result private; when omitted, the generator's own default applies.

  • rendering_speedstring

    The rendering speed: `turbo` is the fastest and cheapest, `quality` the slowest and best; it defaults to `default`.

    • turbo
    • default
    • quality

Pricing

Billable unit and optionsRate (USD)
Per imagerendering_speed: turbo$0.03
Per imagerendering_speed: default$0.06
Per imagerendering_speed: quality$0.09

Billing notes

  • Leaving out rendering_speed gives default.
  • Every image the generator produces is billed, including an image it withholds after its safety check (a withheld image is not delivered); num_images multiplies the price.

Catalogue rates on 21 Nov 2026. Prices exclude VAT.

View in pricing catalogue