API Integration Guide

remove.bg provides a straightforward REST API for automated background removal.

Authentication

All API requests require an X-Api-Key header. Obtain your key from the remove.bg account dashboard.

Basic API Request (cURL)

curl -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'image_file=@/path/to/image.jpg' \
  -F 'size=auto' \
  -o result.png \
  https://api.remove.bg/v1.0/removebg

Key Parameters

Parameter	Type	Description
`image_file`	File	Image to process (multipart upload)
`image_url`	String	Public URL of the image to process
`size`	String	Output resolution: `preview`, `small`, `regular`, `hd`, `4k`, `auto`
`type`	String	Subject type hint: `auto`, `person`, `product`, `car`
`bg_color`	String	Replace background with a hex color (e.g., `#ffffff`)
`bg_image_url`	String	Replace background with an image from a URL
`format`	String	Output format: `auto`, `png`, `jpg`, `zip`

Response

Returns the processed image as binary data in the response body, along with headers indicating credits consumed (X-Credits-Charged) and remaining (X-Api-Credits-Remaining).

SDKs & Integrations

Official and community SDKs are available for Python, Node.js, PHP, Ruby, Java, and more. Native plugins exist for Adobe Photoshop, Figma, GIMP, and automation via Zapier. Desktop apps are available for Windows, macOS, and Linux.