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 ID
ideogram/ideogram-3-replace-backgroundBest for
- Move a studio product into a lifestyle scene
- Try seasonal backgrounds around the same product
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 · RequiredPlain-language description of the new background, 1 to 4000 characters and not blank.
1–4000 characters
imagestring · RequiredThe 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.
privatebooleanWhether to keep the result private; when omitted, the generator's own default applies.
rendering_speedstringThe rendering speed: `turbo` is the fastest and cheapest, `quality` the slowest and best; it defaults to `default`.
- turbo
- default
- quality
Pricing
| Billable unit and options | Rate (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