AI Background Removal API

Remove Background is a professional-mode plugin for teams that need to remove backgrounds from images automatically. The model performs foreground extraction across a broad range of subjects and objects rather than being tied to a single object category. The API returns either a production-ready transparent PNG or a layered ZIP archive containing the foreground mask.

Important: Remove Background must be the only plugin in the tasks array. Do not combine it with Heal, Crop, Color Correction, Clean Backdrop, or any other plugin in the same job. If you need additional processing, run background removal as a separate API request.

Background Removal Jobs This API Solves

How To Remove An Image Background By API

1. Upload one source image Send the JPG or PNG as multipart form data to /retoucher/start together with your token and JSON payload.
2. Choose the required output Request Layer: 0 for a ready transparent PNG, or Layer: 1 for a ZIP containing the foreground mask.
3. Poll and download Check /retoucher/status/{id} until the job completes, then download the result from /retoucher/getFile/{id}.

For bulk background removal, submit one job per image and manage the returned job IDs in your own queue. This pattern works for SKU imports, marketplace feeds, DAM/PIM synchronization, and other high-volume image-processing workflows.

Choose Transparent PNG Or Foreground Mask

Example Output

The first example shows a clean product-style batch: multiple strawberries are preserved as a single foreground group and returned as a transparent PNG. The same request can also return the foreground mask in a ZIP archive.

Second Example: Object Cutout From A Complex Scene

This example demonstrates a harder real-world scene with overlapping furniture, shadows, fine edges, and a blurred outdoor background. The photographed object happens to be a potted succulent, but the workflow is category-independent: the same API request is used for other foreground objects.

Ready Transparent PNG

Use flat output when your application needs the final image immediately. Set outputFormat to png and keep Layer at 0. The downloaded file is an RGBA PNG with transparency.

{
  "mode": "professional",
  "outputFormat": "png",
  "tasks": [
    {
      "Plugin": "Remove Background",
      "version": 1,
      "Layer": 0
    }
  ]
}

cURL Request

curl --location 'https://retoucher.hz.labs.retouch4.me/api/v1/retoucher/start' \
  --form 'file=@Remove_Background_Strawberries_Source.png' \
  --form 'token=YOUR_RETOUCH_TOKEN' \
  --form-string 'payload={"mode":"professional","outputFormat":"png","tasks":[{"Plugin":"Remove Background","version":1,"Layer":0}]}'

Poll /retoucher/status/{id} until state becomes completed, then download the transparent PNG:

curl --location 'https://retoucher.hz.labs.retouch4.me/api/v1/retoucher/getFile/remove-background-job-id' \
  --output remove-background-result.png

Layered ZIP With Foreground Mask

Use layered output when your editor, DAM, or backend pipeline needs the foreground mask separately. Set outputFormat to zip and Layer to 1. The ZIP contains a mask PNG named with type=mask and id=foreground.

{
  "mode": "professional",
  "outputFormat": "zip",
  "tasks": [
    {
      "Plugin": "Remove Background",
      "version": 1,
      "Layer": 1
    }
  ]
}

Layered ZIP Contents

The example archive contains this file:

index=0&blendmode=normal&name=Remove Background&type=mask&id=foreground.png

Download the example layered ZIP archive.

Parameters

Field	Type	Required	Description
Plugin	string	yes	Must be Remove Background.
version	integer	recommended	Use 1 for the current Remove Background model.
Layer	integer or boolean	no	0 returns a flattened transparent PNG. 1 returns a ZIP archive with the foreground mask.
outputFormat	string	yes	Use png for ready transparent PNG output, or zip for the mask archive.

Integration Notes

• Remove Background cannot be combined with other plugins in one job.
• For final cutouts, use outputFormat: "png"; JPEG cannot store transparency.
• For manual compositing or quality control, use the ZIP workflow and read the foreground mask layer.
• To create a white-background product image, first download the transparent PNG or mask, then composite the foreground over white in your application.
• The normal Cloud API flow still applies: submit with /retoucher/start, poll /retoucher/status/{id}, and download with /retoucher/getFile/{id}.

Background Removal API FAQ