---
title: "Smart Background"
method: POST
path: "/painting/replace-background"
tags: ["Image2Image / Inpainting"]
---

# Smart Background

`POST /painting/replace-background`

## Request

- Base URL: `https://genai-api.picsart.io/v1`
- URL: `https://genai-api.picsart.io/v1/painting/replace-background`
- Auth: API key in header `X-Picsart-API-Key`

The **Smart Background** service elevates photo customization to new heights by offering an innovative solution for altering the backdrop of images. Unlike the traditional "Change Background" feature accessed via the /removebg endpoint, where users must provide a specific image to serve as the new background, **Smart Background** harnesses the power of AI to generate a completely new backdrop based on user descriptions.
  
In contrast, the /removebg endpoint's "Change Background" function requires a predetermined image to replace the original backdrop. While effective for straightforward substitutions, it lacks the flexibility and creative potential provided by "Smart Background," where the possibilities for your photo's new setting are limited only by your imagination. Whether you're looking to transport your subjects to exotic locales, whimsical landscapes, or bespoke scenarios, "Smart Background" offers a tailored, AI-generated solution for every photo.
  
With Smart Background, users have the unique opportunity to reimagine their photos by simply submitting an image along with a narrative of the desired background. Our advanced AI algorithms then work to seamlessly integrate a bespoke, contextually appropriate scene behind the subject of the photo. This not only allows for unparalleled personalization but also offers a creative freedom unmatched by conventional methods.

## Request body `multipart/form-data`

- object
  - `image` string, binary: Source image file (binary). (If this parameter is present, the other image source parameters must be empty.)
  - `image_url` string, uri: Source image URL. (If this parameter is present, the other image source parameters must be empty.)
  - `image_id` string: Deprecated. Source image ID of an image previously uploaded to Picsart or result image ID from a different API. (If this parameter is present, the other image source parameters must be empty.)
  - `prompt` string, required: The prompt.
  - `count` integer: The number of images to generate.
  - `format` 'JPG' | 'PNG' | 'WEBP': Optionally select one of the image formats (JPG is default). Options are as follows: * JPG * PNG * WEBP
  - `mode` 'sync' | 'async': Deprecated. The mode parameter is now deprecated. To control synchronous vs asynchronous execution, use the standard HTTP Prefer header (RFC 7240). If both mode and Prefer are provided, Prefer takes precedence. For migration guidance and examples, see the [Sync and Async Execution guide](https://docs.picsart.io/docs/sync-async-execution). Use this query parameter to establish the processing mode. Acceptable values are sync, async and auto (sync is default): * sync: issues a synchronous request, response is given when the result is ready. * async: forces an asynchronous request, the response, which is instantaneous, contains a "transaction_id" which is used to poll for the result. * REMOVED - auto: the processing mode decision is made by the service, which depends upon the expected processing time.
  - `negative_prompt` string: The negative prompt (don’t generate this type of images). Don't use the negative keywords such as 'no', e.g. don't use 'no distorted faces', use 'distorted faces'.

## Response `200`

Success.

- object
  - `status` string
  - `data` object[]
    - `id` string, nullable
    - `url` string

## Other responses

- `202`: Processing.
- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `413`: Request Entity Too Large
- `415`: Unsupported Media Type
- `429`: Too Many Requests
- `431`: Request Header Fields Too Large
- `500`: Internal Server Error
- `503`: Service Unavailable
- `529`: Overloaded. The model provider is overloaded and could not complete this request. Please retry shortly, or switch to a different model.

---

[API](https://skmtc.dev/picsart/apis/picsart-genai-api.md) - [All operations](https://skmtc.dev/picsart/apis/picsart-genai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/picsart/apis/picsart-genai-api/revisions/f36fdc4033ee?raw)