The BackgroundErase Postman collection is a developer tool for inspecting requests, trying response formats, and getting to a successful API response before you write setup code. It is not an automation platform like Make, Zapier, or n8n.
Best fit: Use Postman when you want to test authentication, multipart form-data, output parameters, and sample background removal requests before wiring BackgroundErase into your app, backend, or automation workflow.
What you can test
The collection includes practical examples for the most common BackgroundErase API workflows.
Remove background from image URL
Send an image URL and receive a transparent cutout.
Upload an image file
Test multipart file uploads directly from Postman.
Return transparent PNG
Generate PNG cutouts with alpha transparency.
Generate alpha mask
Return a foreground/background alpha mask for custom compositing.
Add a white background
Composite the subject onto a clean white JPG background.
Replace background image
Place the foreground onto a new background image URL.
How to use the Postman collection
- 1 Open the BackgroundErase collection in Postman.
- 2 Start a free trial and generate a BackgroundErase API key.
- 3 Set the
backgrounderase_api_keycollection variable in Postman. - 4 Run the "Remove background from image URL" quickstart request.
Security note: Never paste a real API key into a public collection value. Use your own private Postman environment or local current value when testing.
Collection variables
| Variable | Example value | Purpose |
|---|---|---|
base_url | https://api.backgrounderase.com | BackgroundErase API base URL |
backgrounderase_api_key | your_api_key_here | Your private API key |
sample_image_url | hosted sample image URL | Image used by quickstart requests |
sample_background_url | hosted background image URL | Background image used by replacement examples |
The public collection uses variable placeholders only. Add your own API key locally before sending requests.
Example request
curl -X POST "https://api.backgrounderase.com/v2" \
-H "x-api-key: YOUR_API_KEY" \
-F "image_url=https://example.com/product.jpg" \
-F "format=png" \
-F "channels=rgba" \
-F "size=preview" \
--output output.png