Image

Background Removal 1.0

zilapi/bgr-1.0 · by InverseAI

Available

Removes the background from an image, keeping the subject.

Background removal API

POST /v1/image/remove-background takes a photo and returns the subject on a transparent background as a PNG, plus an 8-bit greyscale mask you can use in your own editor or pipeline. Both outputs are at the input's size and included in one price per image.

What developers use it for

Product photos with clean, transparent backgrounds for e-commerce
Portrait and profile cut-outs for apps and design tools
Masks for compositing, retouching or replacing backgrounds
Process whole catalogues and marketplaces, one job per image

What it does

Keep the subject and remove the background for product photos, portraits and design assets. Use the transparent cutout directly or the mask in your editor.

Create a job

POST /v1/image/remove-background accepts an input_url, a ready file id, or a multipart file. Send the optional webhook_url to receive a signed completion event, or poll GET /v1/jobs/{id}.

curl -s https://api.zilapi.com/v1/image/remove-background \
  -H "Authorization: Bearer $ZILAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"input_url": "https://example.com/product.png",
       "model": "zilapi/bgr-1.0",
       "webhook_url": "https://your-app.example.com/hooks/zilapi"}' \
  > job.json
JOB_ID=$(jq -r .id job.json)

Outputs

Outputs of zilapi/bgr-1.0
Name	Contains
`image`	PNG with alpha: the subject on a transparent background, at the input’s upright size.
`mask`	8-bit greyscale PNG alpha mask, the same size as the image.

After the job succeeds, call GET /v1/jobs/{id}/output?name=image for a signed download URL. Use name=mask for the other output. Outputs are kept for 7 days.

Read the jobs guide

Inputs, limits and formats

Provider	InverseAI
Input formats	PNG, JPEG and WebP; no animation or HEIC
Max file size	25 MB
Max dimensions	8000 px per side and 36 MP
Output	Image → PNG: image with alpha and mask

Background removal API: questions

How much does the background removal API cost?

$0.01 per image, including both the cut-out and the mask. Failed jobs are free.

Which images can I send?

PNG, JPEG and WebP up to 25 MB, 8000 px per side and 36 megapixels. Animated images and HEIC are not supported.

What do I get back?

A PNG with alpha (the subject on a transparent background) and an 8-bit greyscale PNG mask, both at the input's upright size.

Compare every model on the pricing page, read the step-by-step guide, or start with the quickstart.