Remove Background | Ideogram

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.

Authentication

Api-Keystring

API key for access control. Use in the header with the name “Api-Key”

Request

A request to remove the background of an image.

imagefileRequired

The image whose background is being removed (max size 10MB); only JPEG, WebP and PNG formats are supported at this time.

Response

Background removed successfully.

createddatetime

The time the request was created.

datalist of objects

A list containing the single foreground image. The endpoint always returns exactly one entry.

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error

API key for access control. Use in the header with the name “Api-Key”

A request to remove the background of an image.

The image whose background is being removed (max size 10MB); only JPEG, WebP and PNG formats are supported at this time.

Background removed successfully.

The time the request was created.

A list containing the single foreground image. The endpoint always returns exactly one entry.

$	curl -X POST https://api.ideogram.ai/v1/remove-background \
>	-H "Api-Key: <apiKey>" \
>	-H "Content-Type: multipart/form-data" \
>	-F image=@string

1	{
2	"created": "2000-01-23 04:56:07+00:00",
3	"data": [
4	{
5	"is_image_safe": true,
6	"url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89"
7	}
8	]
9	}

$	curl -X POST https://api.ideogram.ai/v1/remove-background \
>	-H "Api-Key: <apiKey>" \
>	-H "Content-Type: multipart/form-data" \
>	-F image=@string

1	{
2	"created": "2000-01-23 04:56:07+00:00",
3	"data": [
4	{
5	"is_image_safe": true,
6	"url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89"
7	}
8	]
9	}