Costume Background Removal API

Remove backgrounds from costume images with pixel-level precision using our Costume Background Removal API, delivering high-quality cutout results.

Our Costume Background Removal API offers state-of-the-art technology to accurately remove backgrounds from a variety of costume images, including mannequins, real people, pure clothing items, and virtual models. Utilizing pixel-level precision, this API ensures clean and professional cutout results, perfect for e-commerce, digital fashion design, and content creation. The API processes images swiftly and returns high-quality cutouts, allowing for seamless integration into your projects. Enhance your workflows, improve visual appeal, and streamline your image processing tasks with our reliable and efficient Costume Background Removal API. Designed for scalability and optimized for rapid deployment, it’s the ultimate tool for any industry requiring high-quality image manipulation.

Application Scenarios

  • E-commerce Apparel Segmentation: Enables foreground segmentation of e-commerce apparel images, allowing for background separation and replacement, and facilitating batch processing and creation of main images for e-commerce apparel.
  • Virtual Try-On Creation: In virtual try-on scenarios such as wedding photography, traditional ethnic costumes, Hanfu, cosplay makeup, etc., the clothing is segmented through a pre-processing stage of the images, followed by outfit changes and virtual try-ons using AIGC (AI-generated content) technology.
  • Personalized Intelligent Recognition: Allows for segmentation and masking of specified categories within images, including outerwear, tops (including inner linings), pants, skirts, hats, shoes, and bags, thereby enabling personalized clipping and processing of specified types of apparel.

Featured Advantages

  • Multi-Type Automatic Recognition: Automatically identifies the main apparel in an image without the need for additional specification of clothing positions, and can return masks for specified categories.
  • Applicable in Various Apparel Scenes: Suitable for precise clipping scenarios such as human mannequin apparel, real human apparel, apparel-only images, and virtual human apparel.
  • Complex Full Category Segmentation: Suitable for segmentation of apparel subjects in multiple apparel product categories and under complex background conditions, achieving precise segmentation across all categories.

Rendering

Original Image

Original Image

return_form: Default

return_form: Default

return_form: mask

return_form: mask

return_form: whiteBK

return_form: whiteBK

Original Image

Original Image

hat

hat

tops

tops

skirt

skirt

shoes

shoes

Original Image

Original Image

tops

tops

pants

pants

bag

bag

shoes

shoes

API Documentation

Endpoints


Remove backgrounds from costume images with pixel-level precision using our Costume Background Removal API, delivering high-quality cutout results.

Request

Image requirements

  • Image format: JPEG JPG BMP PNG
  • Image size: No more than 5 MB.
  • Image resolution: Larger than 50x50px, smaller than 3000x3000px.

Body

Field Required Type Scope Example Description
image YES file      
cloth_class NO string
  • tops
  • coat
  • skirt
  • pants
  • bag
  • shoes
  • hat
tops,coat Clothing categories. Multiple values can be submitted at once, separated by commas (,).
  • tops: Tops.
  • coat: Coat.
  • skirt: Skirt.
  • pants: Pants.
  • bag: Bag.
  • shoes: Shoes.
  • hat: Hat.
return_form NO string
  • mask
  • whiteBK
  Specify the desired image format for the output.
  • whiteBK: Returns an image with a white background.
  • mask: Returns a single-channel mask.
  • If not specified, a four-channel PNG image will be returned.

Response

Public Parameters

Viewing Public Parameters and Error Codes

Business Parameters

Field Type Description
data object The content of the result data returned.
+elements array Returns an array of elements.
++0 object  
+++image_url string Returns the keying result image URL address.
++1 object  
+++class_url object Return the URL corresponding to the clothing category based on the input cloth_class.
++++tops string Tops URL.
++++coat string Coat URL.
++++skirt string Skirt URL.
++++pants string Pants URL.
++++bag string Bag URL.
++++shoes string Shoes URL.
++++hat string Hat URL.

The URL address is a temporary address, valid for 24 hours, and will not be accessible after it expires. If you need to save the file for a long time or permanently, please visit the URL address within 24 hours and download the file to your own storage space.

Example


{
  "request_id": "",
  "log_id": "",
  "error_code": 0,
  "error_code_str": "",
  "error_msg": "",
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "data": {
    "elements": [
      {
        "image_url": ""
      },
      {
        "class_url": {
          "tops":  "",
          "coat":  "",
          "skirt": "",
          "pants": "",
          "bag":   "",
          "shoes": "",
          "hat":   ""
        }
      }
    ]
  }
}


                                                                            
POST https://zylalabs.com/api/4404/costume+background+removal+api/5413/costume+background+removal
                                                                            
                                                                        

Costume Background Removal - Endpoint Features

Object Description
cloth_class [Optional] Clothing categories. Multiple values can be submitted at once, separated by commas (,). `tops`: Tops. `coat`: Coat. `skirt`: Skirt. `pants`: Pants. `bag`: Bag. `shoes`: Shoes. `hat`: Hat.
return_form [Optional] Specify the desired image format for the output. If not specified, a four-channel PNG image will be returned. `whiteBK`: Returns an image with a white background. `mask`: Returns a single-channel mask.
Request Body [Required] File Binary
Test Endpoint

API EXAMPLE RESPONSE

       
                                                                                                        
                                                                                                                                                                                                                            {
  "request_id":     "",
  "log_id":         "",
  "error_code":     0,
  "error_code_str": "",
  "error_msg":      "",
  "error_detail":   {
    "status_code":  200,
    "code":         "",
    "code_message": "",
    "message":      ""
  },
  "data":           {
    "elements": [
      {
        "image_url": ""
      },
      {
        "class_url": {
          "tops":  "",
          "coat":  "",
          "skirt": "",
          "pants": "",
          "bag":   "",
          "shoes": "",
          "hat":   ""
        }
      }
    ]
  }
}
                                                                                                                                                                                                                    
                                                                                                    

Costume Background Removal - CODE SNIPPETS


    curl --location 'https://zylalabs.com/api/4404/costume+background+removal+api/5413/costume+background+removal' \
    --header 'Content-Type: application/json' \ 
    --form 'image=@"FILE_PATH"'


API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Costume Background Removal API REST API, simply include your bearer token in the Authorization header.
Headers
Header Description
Authorization [Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.

Simple Transparent Pricing

No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.

πŸš€ Enterprise

Starts at
$ 10,000/Year


  • Custom Volume
  • Specialized Customer Support
  • Real-Time API Monitoring

Customer favorite features

  • βœ”οΈŽ Only Pay for Successful Requests
  • βœ”οΈŽ Free 7-Day Trial
  • βœ”οΈŽ Multi-Language Support
  • βœ”οΈŽ One API Key, All APIs.
  • βœ”οΈŽ Intuitive Dashboard
  • βœ”οΈŽ Comprehensive Error Handling
  • βœ”οΈŽ Developer-Friendly Docs
  • βœ”οΈŽ Postman Integration
  • βœ”οΈŽ Secure HTTPS Connections
  • βœ”οΈŽ Reliable Uptime

Costume Background Removal API FAQs

Our Costume Background Removal API offers state-of-the-art technology to accurately remove backgrounds from a variety of costume images, including mannequins, real people, pure clothing items, and virtual models. Utilizing pixel-level precision, this API ensures clean and professional cutout results, perfect for e-commerce, digital fashion design, and content creation. The API processes images swiftly and returns high-quality cutouts, allowing for seamless integration into your projects. Enhance your workflows, improve visual appeal, and streamline your image processing tasks with our reliable and efficient Costume Background Removal API.

E-commerce Clothing Stores: Enhancing product images by removing distracting backgrounds, allowing customers to focus on the clothing items. Fashion Photography: Creating professional-looking fashion photoshoots by isolating models and clothing from the background, highlighting the designs. Cosplay and Costume Events: Editing costume photos for personal or event purposes, ensuring the focus remains on the costumes themselves. Theatrical Productions and Film: Editing costume images for promotional materials, posters, and digital assets related to theatrical productions and films.

Enhanced Visual Focus: Removes distractions from the background, directing attention to the costumes and their details. Professional Presentation: Provides clean and polished images suitable for e-commerce, marketing, and promotional materials. Time Efficiency: Streamlines the editing process, allowing for faster production of high-quality costume images. Flexibility in Design: Enables customization of backgrounds or integration into different settings for creative purposes. Versatility: Applicable to various types of costumes, including historical, fantasy, and contemporary designs.

We have designed a dedicated experience page for developer users. You can visit the experience page to try out the product for free: https://www.ailabtools.com/cutout-clothing-background-removal-example

Yes, we do have more detailed [API documentation](https://www.ailabtools.com/doc/ai-cutout/general/apparel-background-removal/api-marketplace) available. You can access it on our website or by contacting our support team for assistance.

The API returns a structured JSON response containing the processed image URLs and optional category-specific URLs for the clothing items identified in the input image. The main fields include `image_url` for the cutout image and `class_url` for categorized clothing items.

Key fields in the response include `request_id`, `log_id`, `error_code`, `data`, and `elements`. The `data` field contains an array of `elements`, each with `image_url` and `class_url` for categorized clothing, providing direct access to the processed images.

Users can customize requests by specifying the `cloth_class` parameter to target specific clothing categories (e.g., tops, pants) and the `return_form` parameter to choose the output format (mask, white background, or default PNG).

The response data is organized in a hierarchical JSON structure. The top-level contains metadata like `request_id` and `error_code`, while the `data` field includes an array of `elements`, each detailing the processed image and its associated clothing categories.

The endpoint provides information on processed images, including URLs for the main cutout image and URLs for specific clothing categories based on the input. This allows users to access both the overall result and detailed segmentation.

Accepted parameter values include `cloth_class` options such as tops, coat, skirt, pants, bag, shoes, and hat. The `return_form` can be set to `mask` or `whiteBK`, with the default being a four-channel PNG image if not specified.

Users can utilize the returned data by accessing the `image_url` for the final cutout image and the `class_url` for specific clothing items. This enables seamless integration into e-commerce platforms or design projects, enhancing visual presentation.

Typical use cases include e-commerce image enhancement, virtual try-on applications, and fashion photography. The API allows for quick background removal, enabling businesses to create professional images that focus on apparel details.

General FAQs

Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world’s most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.

The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.

Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]

Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.

API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.

Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.

To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.

To check how many API calls you have left for the current month, refer to the β€˜X-Zyla-API-Calls-Monthly-Remaining’ field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

To see the maximum number of API requests your plan allows, check the β€˜X-Zyla-RateLimit-Limit’ response header. For instance, if your plan includes 1,000 requests per month, this header will display 1,000.

The β€˜X-Zyla-RateLimit-Reset’ header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

Yes, you can cancel your plan anytime by going to your account and selecting the cancellation option on the Billing page. Please note that upgrades, downgrades, and cancellations take effect immediately. Additionally, upon cancellation, you will no longer have access to the service, even if you have remaining calls left in your quota.

You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

To give you the opportunity to experience our APIs without any commitment, we offer a 7-day free trial that allows you to make up to 50 API calls at no cost. This trial can be used only once, so we recommend applying it to the API that interests you the most. While most of our APIs offer a free trial, some may not. The trial concludes after 7 days or once you've made 50 requests, whichever occurs first. If you reach the 50 request limit during the trial, you will need to "Start Your Paid Plan" to continue making requests. You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab. Alternatively, if you don't cancel your subscription before the 7th day, your free trial will end, and your plan will automatically be billed, granting you access to all the API calls specified in your plan. Please keep this in mind to avoid unwanted charges.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it’s important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.

When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.

Payout Orders are processed between the 20th and the 30th of each month. If you submit your request before the 20th, your payment will be processed within this timeframe.


Related APIs