👤Human Background Removal
Effortlessly remove backgrounds from human portraits, enabling clean and professional images for profiles, resumes, and creative projects.
You get 10 API units just by validating your email.
No credit card required.
- API Units: 10/month
- API Limit Type: HARD
- Total Endpoints: 1
Table of Contents
- 📄👤 Human Background Removal API
- ✨Features
- 📎Use-Cases
- 📘API Documentation
- 🔌Endpoint
- 📦Request
- 📬Response:
- ⚠️Status Codes & Error Handling
- 📎SEO Keywords
👤 Human Background Removal API
The Human Background Removal API is designed to isolate people in images by automatically removing the background. Whether it's for profile photos, marketing creatives, ID documentation, or social content, this API helps developers programmatically separate human subjects from any background and return a clean result in multiple formats.
It supports JPEG, JPG, BMP, WEBP, and PNG image types, offering flexibility in input and output formats.
Features
-
Automatic Human Segmentation
Detects and removes backgrounds for images containing people using advanced AI segmentation. -
Multiple Output Options
- Transparent PNG (default 4-channel).
- White background (
whiteBK). - Single-channel binary mask (
mask). - Cropped PNG removing empty borders (
crop).
-
Supports Common Image Formats
Accepts JPEG, JPG, BMP, WEBP, and 8-bit PNG images (does not support 16-bit or 64-bit PNG). -
Optimized for Web & Mobile
Lightweight response payloads and rapid processing for integration into online and mobile applications.
Use-Cases
-
Profile Picture Cleanup
Remove noisy or cluttered backgrounds from user-uploaded headshots or portraits. -
Virtual Backgrounds
Enable custom backdrops for virtual try-on apps or video conferencing tools. -
E-Commerce Models
Cleanly isolate human figures from studio shots for use in catalogs or lookbooks. -
ID or Passport Photo Automation
Instantly convert user-submitted photos into white-background images suitable for documentation.
Endpoint
curl -X 'POST' \
'https://prod.api.market/api/v1/ailabtools/human-background-removal/cutout/portrait/body' \
-H 'accept: application/json' \
-H 'x-magicapi-key: <YOUR API MARKET KEY>' \
-H 'Content-Type: multipart/form-data' \
-F 'image=@Markus-Beck-portrait-less-than-1MB-scaled-qnfhmm6p6lo14h0jjs50p6bg31bc1nv9i7rk0hq8a8.jpg;type=image/jpeg' \
-F 'return_form=whiteBK'
Request
Image Requirements
| Property | Value |
|---|---|
| Formats | JPG, JPEG, BMP, WEBP, PNG (8-bit only) |
| Max Size | 3 MB |
| Resolution | Up to 2000 × 2000 pixels |
Request Body Parameters
| Field | Required | Type | Values | Description |
|---|---|---|---|---|
image | Yes | file | — | Image containing one or more humans. |
return_form | No | string | mask, whiteBK, crop | Specifies the output format: - mask: binary mask only- whiteBK: person on white background- crop: cropped transparent PNGDefault: full transparent PNG |
Response:
{
"data": {
"image_url": "https://ai-result-001.ailabtools.com/cutout/body/2025-04-08/171445-9bc2820b-b2fc-663d-f87c-7ca0efa17e34-1744103685.jpg"
},
"error_code": 0,
"error_detail": {
"status_code": 200,
"code": "",
"code_message": "",
"message": ""
},
"log_id": "3B83EAFD-6219-592A-B96C-BE591203DD53",
"request_id": "3B83EAFD-6219-592A-B96C-BE591203DD53"
}
API Playground (Try the APIs)
API.market Guarantee
Only pay for API calls with OK(2XX) status code.
Cancel Anytime
Mange all your API subscriptions.
24/7 Customer Support
Just reach our using the chat window on the right corner.
Refunds policy
30 days return for unused API quota for any reason
★N/A · 0 ReviewsBack to top
Similar SaaS APIs
Related posts
3 Lucrative SaaS Ideas to Reach $3,000 MRR Using the Human Background Removal API
