---
title: "Remove Object"
method: POST
path: "/v1/remove-object"
tags: ["generate"]
---

# Remove Object

`POST /v1/remove-object`

Remove a masked object from a given image synchronously. Supply the image and a binary mask marking the region to remove (white = remove); the masked region is regenerated to blend with the surrounding scene. 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`

Object removed successfully.

- RemoveObjectResponse — The response containing the image with the masked object 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` RemoveObjectImageObject[], required — A list containing the single edited image. The endpoint always returns exactly one entry.
    - `url` string, uri, nullable — The direct link to the edited image. Empty when the image fails safety checks.
    - `is_image_safe` boolean, required — Whether the edited image passes safety checks. If false, the url field will be empty.

## Other responses

- `400` — Invalid input provided.
- `401` — Not authorized to remove object.
- `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)