Skip to main content

Remove Background

Remove Background API

The Remove background API consists of a single HTTP POST endpoint available on
The body must be a multipart/form-data that has one image file:

  • image_file is the original image to process.
    • The original image should be a JPG or a PNG, with a max resolution up to 25 megapixels.

In case of success:

  • the response mime-type is image/png and the response image is a PNG image with the same dimensions as the image_file.
  • the response headers will include a x-remaining-credits property to tell you how many credits you have left.

In case of an error:

  • the response mime-type is application/json, error type is indicated by the response status code and details are in the json body, ie
{ "error": "No api key provided" }


Authentication is supported via an API key. If you need one, please contact us at

If your key has leaked, you can revoke it and request a new one in your account page.


1 successful background removal API call = 1 credit.

Once logged in, you can claim 100 free ClipDrop APIs credits that you can use for development and debugging purposes.
Once the 100 images have been consumed, further calls will be rejected.

If you need more credits, you can purchase packs of 10 to 10 000 credits.

Quota / Rate limiting

By default, each API key has a limit of 50 requests per minute. Please let us know if you'd like higher values.


curl -X POST \
-H 'x-api-key: YOUR_API_KEY' \
-F 'image_file=@car.jpg' \
-o result.png


The result image, e.g. 
Example result the car image where the background has been removed

Examples of input and outputs





Sample integrations


Any question ? Contact us at or join the Slack community.