# Ideogram 3.0 Replace Background

`ideogram/ideogram-3-replace-background` · Ideogram · image

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

[Model page](https://sociaro.com/models/ideogram/ideogram-3-replace-background) · [JSON](https://sociaro.com/models/ideogram/ideogram-3-replace-background.json) · [Model pricing](https://sociaro.com/pricing?model=ideogram%2Fideogram-3-replace-background) · [Documentation](https://docs.sociaro.com/models/ideogram-ideogram-3-replace-background/) · [Playground](https://my.sociaro.com/playground/?model=ideogram/ideogram-3-replace-background)

## Use cases

- Move a studio product into a lifestyle scene
- Try seasonal backgrounds around the same product

## Technical details

- 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

- `prompt` (string, required) — Plain-language description of the new background, 1 to 4000 characters and not blank.
  - 1–4000 characters
- `rendering_speed` (string) — The rendering speed: `turbo` is the fastest and cheapest, `quality` the slowest and best; it defaults to `default`.
  - Allowed values — `turbo`, `default`, `quality`
- `private` (boolean) — Whether to keep the result private; when omitted, the generator's own default applies.
- `image` (string, 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.

## Pricing

Rates in USD. Catalogue timestamp 2026-11-21T02:23:44Z.

- USD 0.03 per image · rendering_speed: turbo · active
- USD 0.06 per image · rendering_speed: default · active
- USD 0.09 per image · rendering_speed: quality · active

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

## Examples

### A tropical setting

Palm fronds and patterned tiles replace the blue studio backdrop around the curved red chair.

[Result (image)](https://previews.sociaro.com/shared/promo/gallery/ideogram/chair-palm-room.webp)

Source inputs

- [Source chair (image)](https://previews.sociaro.com/shared/promo/gallery/ideogram/ribbon-chair-source-b8be5e51.png) · [Thumbnail](https://previews.sociaro.com/shared/promo/gallery/ideogram/chair-thumb.webp)
