# Ideogram BG Remover API — AI background removal for production at scale

Ideogram publishes a public search API over its indexed pages; the guide is at https://ideogram.ai/agents/agent-access.

Source: https://ideogram.ai/features/background-remover/api/
Source observed: 2026-11-03T18:37:23.420Z
Last checked: 2026-11-15T16:35:39.842+00:00
Indexed: 2026-11-03T18:38:08.962+00:00

---

# Ideogram BG Remover API

## AI background remover API, for production at scale

We provide a production-scale API that accepts an image and returns a transparent PNG. Our background remover identifies the foreground subject and is designed to preserve clean logos, fine typography, and intricate cutouts for developers and enterprise teams in design, e-commerce, marketing, and advertising.

[Try the API](https://ideogram.ai/api/api-keys)

## Overview

Send an image and receive a JSON response containing a signed URL for the transparent PNG. The service costs **$0.01 per image**; batch and volume discounts are available. You do not need to provide a GPU or host the model.

## Endpoint reference

| Endpoint | Method | Description |
| --- | --- | --- |
| `/v1/remove-background` | `POST` | Remove the background of an image and return a transparent PNG. |

### Request

Send the image as `multipart/form-data`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `image` | binary | Yes | Image to process. Accepted formats are JPEG, PNG, and WebP. Maximum size is 10 MB. |

### Response

A successful `200 OK` response is a JSON object with a top-level `created` timestamp and a `data` array. The processed image is the first entry in the array.

| Field | Type | Description |
| --- | --- | --- |
| `created` | string | ISO 8601 timestamp for when the result was generated. |
| `data[].url` | string | Signed URL for the transparent PNG. It is valid for approximately 24 hours; download the image to retain it. |
| `data[].is_image_safe` | boolean | Indicates whether the image passed safety checks. If `false`, `url` is empty. |

### Response headers

Every response includes `x-request-id`. Save it and include it in support tickets when investigating a request.

### Errors

| Status | Meaning |
| --- | --- |
| `400` | Invalid input. |
| `401` | Missing or invalid API key. |
| `422` | Image failed safety checks. |
| `429` | Rate limit exceeded. |

## Remove a background

- **Format:** `multipart/form-data`
- **Maximum size:** 10 MB per image
- **Accepted formats:** JPEG, PNG, WebP
- **Authentication:** `Api-Key` header

### Python example

```python
import requests

with open("input.jpg", "rb") as f:
  response = requests.post(
    "https://api.ideogram.ai/v1/remove-background",
    headers={"Api-Key": "<apiKey>"},
    files={"image": ("input.jpg", f, "image/jpeg")},
    timeout=60,
  )
response.raise_for_status()
request_id = response.headers.get("x-request-id")  # save for support tickets

result = response.json()["data"][0]
if not result["is_image_safe"]:
  raise RuntimeError(f"safety check failed (request {request_id})")

# Signed URL is valid for ~24h; download to keep.
png = requests.get(result["url"], timeout=60).content
with open("cutout.png", "wb") as out:
  out.write(png)
```

## Response shape

The endpoint returns a `data` array, with the processed image in the first entry. The `url` is a signed link, so download its bytes if you need to retain the image.

```json
{
  "created": "2026-05-05T03:43:30.424309+00:00",
  "data": [
    {
      "url": "https://ideogram-ephemeral.ideogram.ai/<signed-url>.png",
      "is_image_safe": true
    }
  ]
}
```

## Tips

- **Download the result.** The signed `url` is valid for roughly 24 hours. Persist the bytes if you need to keep the image; do not hotlink the signed URL from production assets.
- **Stay under 10 MB.** Larger images return `400`. Resize or recompress before uploading. Our model handles source images up to approximately 4K well; larger inputs primarily increase upload time.
- **Set a generous client timeout.** The endpoint is synchronous. A typical 1 MB request finishes in a few seconds, while harder inputs—including refraction, fine hair, and intricate cutouts—can take longer. A 60-second client timeout is a safe default.
- **Run requests in parallel for catalogs.** Run concurrent requests up to your account’s rate limit. `429` responses can be retried with backoff.
- **Check `is_image_safe` before using `url`.** When it is `false`, the URL is empty because the input failed a safety check.
- **Capture `x-request-id`.** Log it on every call; it helps us investigate a specific failure.
- **Re-encode when metadata is needed.** Our response is a transparent PNG with a clean alpha channel and no input metadata. Re-add a color profile or copyright tags downstream if your pipeline requires them.
- **Pre-resize thumbnails.** Output resolution matches the input. If you only need 1024px assets, resize before uploading to reduce bandwidth and processing time.

## Built for

- **Developers:** Use one REST endpoint with multipart form data to receive a signed PNG URL. We require no GPU, model hosting, or SDK lock-in; call us from any language with an HTTP client and integrate us into a backend, queue worker, or CLI.
- **Product photography:** Remove studio backgrounds, mannequins, and shadows from hero shots, packshots, and lifestyle photography. The transparent PNG is ready for listing templates without manual retouching.
- **E-commerce and marketplaces:** Process complete catalogs in batches with consistent framing, from the first SKU through the ten-thousandth. Use the results for Amazon, Shopify, Etsy, or your own storefront and refresh listings on a recurring schedule.
- **Marketing and advertising:** Cut subjects from raw shoots, stock imagery, or AI generations and composite them onto another background. Transparent PNG output fits Photoshop, Figma, and ad-builder workflows for campaign assets at volume.
- **Graphic design:** Remove source backgrounds from artwork for reuse on posters, packaging, merchandise, and digital surfaces. We preserve anti-aliased typography, fine illustration linework, and intricate cutouts.
- **Enterprise:** Use high-volume batch processing with priority throughput, dedicated support, and volume-based pricing. Contact [partnership@ideogram.ai](mailto:partnership@ideogram.ai) for a quote.

## Related Ideogram resources

- [API](https://ideogram.ai/api-learn/)
- [API Pricing](https://ideogram.ai/pricing/?pricing_tab=api)
- [API Docs](https://developer.ideogram.ai/ideogram-api/api-overview)
- [API Status](https://status.ideogram.ai/)
- [Enterprise](https://ideogram.ai/enterprise/)
- [Background Remover](https://ideogram.ai/tools/background-remover/)
- [Pricing](https://ideogram.ai/pricing/)
- [Privacy Policy](https://ideogram.ai/legal/privacy/)
- [Terms of Service](https://ideogram.ai/legal/tos/)

© 2026 Ideogram, Inc. All rights reserved.

---

[Read this page’s summary](https://ideogram.ai/agents/api/public/v1/page-tldr?url=https%3A%2F%2Fideogram.ai%2Ffeatures%2Fbackground-remover%2Fapi%2F&trace=t_380edc68d53d)

## Ask a follow-up about this page

Need a more specific answer? Ask the exact question you have. It returns a fresh, cited answer from Ideogram’s knowledge base. No account or API key required.

Open this URL with your own question, URL-encoded. Include your question in q. All research inputs are optional; no account or setup.

`GET https://ideogram.ai/agents/agent/faq?q={question}&trace=t_380edc68d53d`

[Tool guide and examples](https://ideogram.ai/agents/agent-access) · [OpenAPI](https://ideogram.ai/agents/api/public/v1/openapi.json) · [Page TLDR form](https://ideogram.ai/agents/agent-tools/page-tldr?url=https%3A%2F%2Fideogram.ai%2Ffeatures%2Fbackground-remover%2Fapi%2F). Opening a form does not execute a tool.