Name: Try on Clothes – AI Outfit Previews | Free · $10/mo | API.market
Brand: ailabtools
SKU: api-ailabtools-try-on-clothes
Availability: InStock
Author: API Market

# 👩👗Try on Clothes API

The Try on Clothes API enables developers to virtually dress a person by overlaying clothing items on a portrait image. This API processes a full-body, front-view portrait along with a separate clothing image, and applies the clothing according to the specified type (upper body, lower body, or full body). If the results do not fully meet your expectations, consider using the Try on Clothes Refiner for enhancements or the Try on Clothes Pro for advanced processing.

## Image Example

<style>
  table {
    width: 100%;
    border-collapse: collapse;
  }
  th, td {
    text-align: center;
    vertical-align: middle;
    padding: 8px;
  }
  img {
    display: block;
    margin-left: auto;
    margin-right: auto;
    max-width: 100%;
    height: auto;
  }
</style>

<table>
  <thead>
    <tr>
      <th>Clothing Type</th>
      <th>ORIGINAL IMAGE</th>
      <th>CLOTHING IMAGE</th>
      <th>RESULT IMAGE</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Upper Body Clothing</td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/OriginalImage-1.webp" alt="ORIGINAL IMAGE">
      </td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/top-1.webp" alt="CLOTHING IMAGE">
      </td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/ResultImage-1.webp" alt="RESULT IMAGE">
      </td>
    </tr>
    <tr>
      <td>Lower Body Clothing</td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/OriginalImage-1.webp" alt="ORIGINAL IMAGE">
      </td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/bottom-1.webp" alt="CLOTHING IMAGE">
      </td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/ResultImage-2.webp" alt="RESULT IMAGE">
      </td>
    </tr>
    <tr>
      <td>Full Body Clothing</td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/OriginalImage-1.webp" alt="ORIGINAL IMAGE">
      </td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/full-1.webp" alt="CLOTHING IMAGE">
      </td>
      <td>
        <img loading="lazy" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/ResultImage-3.webp" alt="RESULT IMAGE">
      </td>
    </tr>
  </tbody>
</table>

## Features
- **Virtual Try-On**: Combines a user’s portrait with clothing images to simulate a try-on experience.
- **Asynchronous Processing**: Returns a task ID for later retrieval, ensuring efficient handling of image processing without blocking.
- **Flexible Clothing Types**: Supports different clothing placements including upper body, lower body, or full body.
- **High-Quality Image Handling**: Optimized for clear, full-body images with specific pose requirements to maintain realism.

## Use-Cases
- **E-Commerce Virtual Fitting Rooms**: Allow customers to preview how clothing items would look on them before purchase.
- **Fashion Styling Apps**: Enable users to experiment with different outfits and combinations.
- **Digital Wardrobe & Personalization**: Integrate into apps for personalized styling recommendations and outfit planning.
- **Social Media & Content Creation**: Create engaging try-on visuals for fashion influencers and online campaigns.

## API Documentation

### Endpoint
```bash
curl -X 'POST' \
  'https://prod.api.market/api/v1/ailabtools/try-on-clothes/portrait/editing/try-on-clothes' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <YOUR API MARKT KEY>' \
  -H 'Content-Type: multipart/form-data' \
  -F 'task_type=async' \
  -F 'clothes_type=upper_body'
```
### Request

#### Image Requirements

**Portrait Image:**
- **Formats**: JPG, JPEG, PNG
- **Max Size**: 3 MB
- **Resolution**: Less than 4096×4096 px
- **Pose**: Full-body front view with hands fully visible. Avoid side views, seated/lying poses, or group photos.

**Clothing Image:**
- **Formats**: JPG, JPEG, PNG
- **Max Size**: 3 MB
- **Resolution**: Less than 4096×4096 px
- **Pose**: Full-body front view, flat-lay image with clear, well-aligned clothing.
- **Additional Guidance**: Use clothing items with minimal patterns and prints. The clothing item should occupy most of the image frame without any obstructions or overlapping layers.

#### Request Body Fields

| Field         | Required | Type   | Options                                 | Description                                                                                                   |
|---------------|:--------:|--------|-----------------------------------------|---------------------------------------------------------------------------------------------------------------|
| `task_type`   | Yes      | string | `async`                                 | Indicates that the task will be processed asynchronously.                                                   |
| `person_image`| Yes      | file   | —                                       | The portrait image of the person. Must meet the portrait image requirements.                                 |
| `clothes_image`| Yes     | file   | —                                       | The clothing image. Must meet the clothing image requirements.                                               |
| `clothes_type`| Yes      | string | `upper_body`, `lower_body`, `full_body`   | Specifies the type of clothing to be applied: upper body, lower body, or full body clothing.                  |


#### Response
```json
{
  "task_type": "async",
  "task_id": "string",
  "request_id": "string",
  "log_id": "string",
  "error_code": 0,
  "error_detail": {
    "status_code": 0,
    "code": "string",
    "code_message": "string",
    "message": "string"
  },
  "error_msg": "string"
}
```


## Status Codes & Error Handling

| Field        | Description                                                                                      |
|--------------|--------------------------------------------------------------------------------------------------|
| `error_code` | `0` indicates success; any non-zero value denotes a specific error (e.g., invalid image or pose, file size issues). |
| `error_msg`  | A short, descriptive message explaining any error encountered.                                   |
| `status_code`| Standard HTTP status codes (e.g., 200 for success, 400 for client error). Use in conjunction with `error_code` for debugging. |

## SEO Keywords
virtual try-on API, try on clothes API, virtual dressing room, asynchronous try-on API, fashion tech API, e-commerce virtual fitting, clothing overlay API, digital wardrobe tool

Virtually dress models with realistic AI clothing previews. Free 10 calls/mo, from $10/mo. Start free on API.market.

Try on Clothes – AI Outfit Previews | Free · $10/mo | API.market

BASIC

AILabTools

ULTRA

MEGA

Experience ultra-realistic AI-powered Try-On, transforming flat clothing images and portraits into accurate, life-like previews of garment fit and style.