---
title: "Remove Background"
method: POST
path: "/v1/remove-background"
tags: ["generate"]
---

# Remove Background

`POST /v1/remove-background`

Remove the background of a given image synchronously. The foreground subject
is identified and returned on a transparent background. Supported image formats include JPEG,
PNG, and WebP.
Image links are available for a limited period of time; if you would like to keep the image,
you must download it.

## Response `200`

Background removed successfully.

- RemoveBackgroundResponse — The response containing the foreground image with the background removed. Image links are available for a limited period of time; if you would like to keep the image, you must download it.
  - `created` string, date-time, required — The time the request was created.
  - `data` RemoveBackgroundImageObject[], required — A list containing the single foreground image. The endpoint always returns exactly one entry.
    - `url` string, uri, nullable — The direct link to the foreground image. Empty when the image fails safety checks.
    - `is_image_safe` boolean, required — Whether the foreground image passes safety checks. If false, the url field will be empty.

## Other responses

- `400` — Invalid input provided.
- `401` — Not authorized to remove background.
- `422` — Initial image failed the safety checks.
- `429` — Too many requests.

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/bd40f367a834/schema)