Name: Clothing Cutout – Remove Backgrounds | Free · $10/mo | API.market
Brand: ailabtools
SKU: api-ailabtools-costume-background-removal
Availability: InStock
Author: API Market

# 👕 Costume Background Removal API

The Costume Background Removal API is designed to isolate and extract clothing items from images by removing their backgrounds. It supports multiple clothing categories including tops, coats, skirts, pants, shoes, bags, and hats. The API returns a four-channel PNG by default, or alternatively, a white background image or a single-channel mask depending on the specified output format.

This API is ideal for fashion retailers, virtual try-on applications, online stores, and AI-based styling tools where clean, segmented clothing images are required.

---
## Image Example
#### 1.
<div align="center ">
  <table >
    <tr>
      <td style="padding:8px;">
        <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/OriginalImage-1.webp" alt="Original Image" style="max-width:100%; border-radius:8px; ">
        <h4>Original Image</h4>
      </td>
      <td style="padding:8px;">
        <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-default-1.webp" alt="Costume background removal" style="max-width:100%; border-radius:8px;">
        <h4>-</h4>
      </td>
      <td style="padding:8px;">
        <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-mask-1.webp" alt="Costume background removal" style="max-width:100%; border-radius:8px;">
        <h4>mask</h4>
      </td>
      <td style="padding:8px;">
        <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-whiteBK-1.webp" alt="Costume background removal" style="max-width:100%; border-radius:8px;">
        <h4>whiteBK</h4>
      </td>
    </tr>
  </table>
</div>

#### 2.
<div style="display: grid; grid-template-columns: repeat(5, 1fr); gap: 8px; justify-items: center; align-items: center; padding: 8px;  border-radius: 8px; text-align: center;">
  <div>
    <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/OriginalImage-2.webp" alt="Original Image" style="border-radius: 8px; max-width: 100%;">
    <h4>Original Image</h4>
  </div>
  <div>
    <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-hat-2.webp" alt="hat" style="border-radius: 8px; max-width: 100%;">
    <h4>hat</h4>
  </div>
  <div>
    <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-tops-2.webp" alt="tops" style="border-radius: 8px; max-width: 100%;">
    <h4>tops</h4>
  </div>
  <div>
    <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-skirt-2.webp" alt="skirt" style="border-radius: 8px; max-width: 100%;">
    <h4>skirt</h4>
  </div>
  <div>
    <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-shoes-2.webp" alt="shoes" style="border-radius: 8px; max-width: 100%;">
    <h4>shoes</h4>
  </div>
</div>

#### 3.
<div style="display: flex; justify-content: center; gap: 16px; flex-wrap: nowrap; padding: 8px;  border-radius: 8px; text-align: center;">
  <div style="flex: 1;">
    <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/OriginalImage-3.webp" alt="Original Image" style="max-width: 100%; border-radius: 8px;">
    <h4>Original Image</h4>
  </div>
  <div style="flex: 1;">
    <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-tops-3.webp" alt="tops" style="max-width: 100%; border-radius: 8px;">
    <h4>tops</h4>
  </div>
  <div style="flex: 1;">
    <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-pants-3.webp" alt="pants" style="max-width: 100%; border-radius: 8px;">
    <h4>pants</h4>
  </div>
  <div style="flex: 1;">
    <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-bag-3.webp" alt="bag" style="max-width: 100%; border-radius: 8px;">
    <h4>bag</h4>
  </div>
  <div style="flex: 1;">
    <img src="https://ai-resource.ailabtools.com/costume-background-removal/doc/ResultImage-shoes-3.webp" alt="shoes" style="max-width: 100%; border-radius: 8px;">
    <h4>shoes</h4>
  </div>
</div>

## Features
- **Multi-Class Support**:  
  Process one or more clothing categories in a single request. Supported types include:
  - Tops
  - Coats
  - Skirts
  - Pants
  - Bags
  - Shoes
  - Hats

- **Flexible Output Options**:  
  - Default: Transparent background PNG (4-channel).  
  - `whiteBK`: Returns image with a white background.  
  - `mask`: Returns a single-channel binary mask.

- **Accurate Clothing Segmentation**:  
  Designed to segment clothing accurately even when multiple items are present in an image.

- **Lightweight and Fast**:  
  Optimized for high-throughput environments like product catalog automation.

---

## Use-Cases
- **E-Commerce Product Listing**:  
  Automatically remove noisy backgrounds from apparel product photos before uploading to online stores.

- **Virtual Try-On Systems**:  
  Segment individual fashion elements to power real-time AR try-on experiences.

- **AI Styling Tools**:  
  Extract wardrobe elements for virtual outfit creation or fashion recommendations.

- **Fashion Dataset Preparation**:  
  Batch-segment large image datasets for machine learning training pipelines in computer vision.

---

## API Documentation

### Endpoint
```bash
curl -X 'POST' \
  'https://prod.api.market/api/v1/ailabtools/costume-background-removal/cutout/commodity/cloth' \
  -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 'cloth_class=tops,coat,skirt,pants,bag,shoes,hat' \
  -F 'return_form=whiteBK'
```
### Request

#### Image Requirements
- **Supported Formats**: JPEG, JPG, PNG, BMP  
- **Max File Size**: 5 MB  
- **Resolution Range**: Between 50×50 px and 3000×3000 px

---

#### Request Body Fields

| Field         | Required | Type   | Accepted Values                  | Description                                                                                     |
|---------------|:--------:|--------|----------------------------------|-------------------------------------------------------------------------------------------------|
| `image`       | Yes      | file   | —                                | The image containing the clothing item(s) to be processed.                                     |
| `cloth_class` | No       | string | tops, coat, skirt, pants, bag, shoes, hat | One or more comma-separated clothing categories. If not provided, all visible items are processed. |
| `return_form` | No       | string | `mask`, `whiteBK`                | - `mask`: Returns a single-channel mask.<br> - `whiteBK`: Returns the image with a white background.<br> If not set, returns a transparent PNG. |

### Response
```json
{
  "data": {
    "elements": [
      {
        "image_url": "https://ai-result-001.ailabtools.com/cutout/cloth/2025-04-08/165933-8f1ea42c-f210-0804-ecb1-871c4f69f973-1744102773.png"
      },
      {
        "class_url": {
          "coat": "https://ai-result-001.ailabtools.com/cutout/cloth/2025-04-08/165933-fbb9c1c4-f400-e6b8-493f-084577ec7287-1744102773.png",
          "pants": "https://ai-result-001.ailabtools.com/cutout/cloth/2025-04-08/165933-1b68b829-59fc-3938-60ac-c8ceb6550a5f-1744102773.png",
          "skirt": "https://ai-result-001.ailabtools.com/cutout/cloth/2025-04-08/165933-f13feb32-3111-c1bd-4df3-e3330bb0f661-1744102773.png",
          "tops": "https://ai-result-001.ailabtools.com/cutout/cloth/2025-04-08/165933-cd7db93c-9664-3d93-fa96-cab593df5eef-1744102773.png",
          "bag": "https://ai-result-001.ailabtools.com/cutout/cloth/2025-04-08/165933-36d3edcd-8e30-a2a2-ada9-8d37e5412fd9-1744102773.png",
          "hat": "https://ai-result-001.ailabtools.com/cutout/cloth/2025-04-08/165933-552713ba-50ce-5807-19d7-51c31c88edea-1744102773.png",
          "shoes": "https://ai-result-001.ailabtools.com/cutout/cloth/2025-04-08/165933-3536b516-b5ef-438a-c8d7-0eafed453548-1744102773.png"
        }
      }
    ]
  },
  "error_code": 0,
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "log_id": "A70960F6-E794-541C-9B45-B36DC7768EEB",
  "request_id": "A70960F6-E794-541C-9B45-B36DC7768EEB"
}
```
## Status Codes & Error Handling

| Field         | Description                                                                                 |
|---------------|---------------------------------------------------------------------------------------------|
| `error_code`  | `0` means success. Non-zero values indicate an error (e.g. file too large, invalid input).  |
| `error_msg`   | Describes the error message in human-readable format.                                       |
| `status_code` | HTTP status code returned (`200`, `400`, etc.) for network-level troubleshooting.           |

## SEO Keywords
costume background removal API, apparel segmentation API, clothing item extraction, remove fashion background, product fashion AI, fashion AI tools, remove background from clothes image, transparent clothing PNG, white background clothing API, virtual try-on API


Automatically remove backgrounds from clothing & apparel photos. Free 10 calls/mo, from $10/mo. Start free on API.market.

Clothing Cutout – Remove Backgrounds | Free · $10/mo | API.market

BASIC