Name: Try on Clothes Pro – AI Virtual Try-On | Free · $40/mo | API.market
Brand: ailabtools
SKU: api-ailabtools-try-on-clothes-pro
Availability: InStock
Rating: 5.00 (1 reviews)
Author: API Market

# 🛍️Try on Clothes Pro API

The **Try on Clothes Pro API** offers an advanced, AI-driven method for virtually fitting clothing onto a user’s full-body photograph. It supports asynchronous processing, which suits complex scenarios with high-resolution images or multiple garment layers. This API is designed to maintain natural human features, allowing you to combine upper and (optionally) lower body garments in a single virtual try-on experience.

## Image Example
### Portrait
**Correct Example:**

<div align="center">
  <div style="display: grid; grid-template-columns: repeat(2, 1fr); gap: 16px;">
    <img alt="Correct Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/CorrectExample-1.webp" class="medium-zoom-image">
    <img alt="Correct Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/CorrectExample-2.webp" class="medium-zoom-image">
  </div>
</div>
<br/>

**Incorrect Example:**
<table style="width: 100%; border-collapse: collapse; text-align: center;">
  <tr>
    <td>
      <strong>Non-Front Full-Body Shot</strong><br>
      <small>(Avoid uploading side views, sitting poses, lying down poses, or half-body photos.)</small>
    </td>
    <td>
      <strong>Group Photo</strong>
    </td>
    <td>
      <strong>Clothing Obstruction</strong><br>
      <small>(Avoid holding items, bags, etc.)</small>
    </td>
    <td>
      <strong>Lighting Too Dark / Blurry</strong>
    </td>
  </tr>
  <tr>
    <td>
      <img alt="Incorrect Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/SideView-1.webp" style="max-width: 100%;">
    </td>
    <td>
      <img alt="Incorrect Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/MultiplePeople-1.webp" style="max-width: 100%;">
    </td>
    <td>
      <img alt="Incorrect Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/Occlusion-1.webp" style="max-width: 100%;">
    </td>
    <td>
      <img alt="Incorrect Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/PoorImage-1.webp" style="max-width: 100%;">
    </td>
  </tr>
</table>

### Clothing
**Correct Example:**
<div align="center">

<table>
  <tr>
    <td>
      <div style="display: grid; grid-template-columns: repeat(4, 1fr); gap: 16px;">
        <img alt="Correct Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/CorrectExampleTop-1.webp" class="medium-zoom-image">
        <img alt="Correct Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/CorrectExampleTop-2.webp" class="medium-zoom-image">
        <img alt="Correct Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/CorrectExampleTop-3.webp" class="medium-zoom-image">
        <img alt="Correct Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/CorrectExampleSuit-1.webp" class="medium-zoom-image">
      </div>
    </td>
  </tr>
  <tr>
    <td>
      <div style="display: grid; grid-template-columns: repeat(4, 1fr); gap: 16px;">
        <img alt="Correct Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/CorrectExampleBottom-1.webp" class="medium-zoom-image">
        <img alt="Correct Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/CorrectExampleBottom-2.webp" class="medium-zoom-image">
        <img alt="Correct Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/CorrectExampleBottom-3.webp" class="medium-zoom-image">
        <img alt="Correct Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/CorrectExampleSuit-2.webp" class="medium-zoom-image">
      </div>
    </td>
  </tr>
</table>

</div>
<br/>

**Incorrect Example:**
<table style="width:100%;">
  <tr>
    <td>
      <div style="display: grid; grid-template-columns: repeat(4, 1fr); gap: 16px;">
        <div style="display: flex; align-items: center; justify-content: center;">Multiple Clothing Items</div>
        <div style="display: flex; align-items: center; justify-content: center;">Non-Front View</div>
        <div style="display: flex; align-items: center; justify-content: center;">Folded Obstruction</div>
        <div style="display: flex; align-items: center; justify-content: center;">Clothing Wrinkles</div>
      </div>
    </td>
  </tr>
  <tr>
    <td>
      <div style="display: grid; grid-template-columns: repeat(4, 1fr); gap: 16px;">
        <div style="display: flex; align-items: center; justify-content: center;">
          <img alt="Incorrect Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/MultiplePieces-1.webp" class="medium-zoom-image">
        </div>
        <div style="display: flex; align-items: center; justify-content: center;">
          <img alt="Incorrect Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/Back-1.webp" class="medium-zoom-image">
        </div>
        <div style="display: flex; align-items: center; justify-content: center;">
          <img alt="Incorrect Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/Folds-1.webp" class="medium-zoom-image">
        </div>
        <div style="display: flex; align-items: center; justify-content: center;">
          <img alt="Incorrect Example Image" src="https://ai-resource.ailabtools.com/try-on-clothes/doc/example/Pleats-1.webp" class="medium-zoom-image">
        </div>
      </div>
    </td>
  </tr>
</table>


## Features

- #### Asynchronous Task Management
- Improves performance and reliability for large files or complex tasks
- Returns a `task_id` for later retrieval of results

- #### Multiple Garment Support
- Upload separate items for upper and lower clothing
- Optionally let the service generate lower-body clothing automatically if not provided

- #### Pose Validation
- Optimized for a full-body, front-facing posture with visible arms and minimal obstructions
- Ensures the highest realism in the try-on results

- #### Resolution Control
- Choose from default resolutions or preserve the original image size for downstream refinement

- #### Facial Preservation
- Configure whether to keep the original face or regenerate it (e.g., for privacy or stylization)


## Use Cases

1. **E-Commerce**  
   Allow customers to preview how clothing items might look on their own bodies before purchase.

2. **Fashion Tech Apps**  
   Build interactive dressing room apps or styling tools that combine various garments.

3. **Virtual Styling & Personalization**  
   Provide stylists or influencers with instant outfit compositions to share with clients or followers.

## API Documentation
### Endpoints
##### 1. Request for TASK ID 
<small>*Charges 1 API unit*</small>
```bash
curl -X 'POST' \
  'https://prod.api.market/api/v1/ailabtools/try-on-clothes-pro/portrait/editing/try-on-clothes-pro' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <YOUR API MARKET KEY>' \
  -H 'Content-Type: multipart/form-data' \
  -F 'task_type=async' \
  -F 'bottom_garment=' \
  -F 'resolution=-1' \
  -F 'restore_face=true'
```
**Response:** 
```json
{
  "data": {
    "status": "QUEUING"
  },
  "error_code": 0,
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "log_id": "F4DBA369-BF94-5140-901B-13ADDA2267B2",
  "request_id": "F4DBA369-BF94-5140-901B-13ADDA2267B2",
  "task_id": "1744181493302.c405a500-eda3-144d-3911-476b3bb9f283",
  "task_type": "async"
}
```
<small>*Returns The <task_id>*</small>
### 2. Check Status (GET REQUEST)

**Request:**
```bash
curl -X 'GET' \
  'https://prod.api.market/api/v1/ailabtools/try-on-clothes-pro/api/apimarket/query-async-task-result?task_id=1744181493302.c405a500-eda3-144d-3911-476b3bb9f283' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <YOUR API MARKET KEY>'
```
**Response:**
```json
{
  "data": {
    "status": "PROCESS_SUCCESS",
    "result_url": "https://ai-result-001.ailabtools.com/image/generateCartoonizedImage/2025-04-09/145143-e6a837af-1ae2-5cf6-1fd5-a03f58e121f4-1744181503.jpg"
  },
  "error_code": 0,
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "log_id": "99EAF69E-6677-5193-9788-C6B1DCB31EB4",
  "request_id": "99EAF69E-6677-5193-9788-C6B1DCB31EB4",
  "task_status": 2
}
```
<small>*Returns The Image Url*</small>
### Request Fields

| Field          | Required | Type    | Default | Description                                                                                                                                                    |
|----------------|----------|---------|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|
| task_type      | YES      | string  | async   | Only `async` is supported. Indicates an asynchronous task.                                                                                                     |
| person_image   | YES      | file    | —       | The user’s portrait image. Must meet the pose and resolution requirements for realistic results.                                                              |
| top_garment    | YES      | file    | —       | The upper body clothing item. Must be a clear front-facing image or well-aligned flat-lay.                                                                    |
| bottom_garment | NO       | file    | —       | The lower body clothing item. If omitted, the service will randomly generate or adapt lower body clothing. If you don’t need it (like a one-piece dress), leave this empty. |
| resolution     | NO       | integer | -1      | Output resolution. <br/>-1 = original resolution <br/>1024 = 576×1024 px <br/>1280 = 720×1280 px <br/>Select -1 if you plan to refine the output later or want to keep the original dimensions as much as possible. |
| restore_face   | NO       | boolean | true    | Whether to maintain the user’s original face. <br/>true = Keep the face (recommended if you plan to refine later) <br/>false = Regenerate the face           |

### Response
```bash
{
  "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` | A numeric code indicating success (`0`) or a specific error condition (e.g., invalid file, pose, or dimension). |
| `error_msg`  | A brief message describing the error if `error_code ≠ 0`.                   |
| `status_code`| Mirrors standard HTTP status codes (e.g., `200`, `400`, `404`). Check both this and `error_code` for a complete error diagnosis. |
## Additional Details

- **Performance**: Asynchronous tasks typically complete in a few seconds to a few minutes, depending on image complexity.
- **Result Validity**: Retrieved try-on results are generally stored for 24 hours; poll the endpoint periodically (e.g., every 5 seconds) if needed.
- **Face Preservation**: `restore_face=true` is recommended if you want to maintain identity or plan further refining steps.
- **Usage Recommendation**: Keep clothing images simple and ensure minimal patterns or overlapping items for the highest quality result.

## SEO Keywords
AI virtual try-on, Clothing try-on API, Full-body try-on, Asynchronous fashion API, Virtual fitting room, 3D garment simulation, Apparel e-commerce tool, Try on Clothes Pro API


Virtually fit clothes onto full-body photos with AI. Supports layered garments. Free 3 calls/mo, from $40/mo. Start free on API.market.

Try on Clothes Pro – AI Virtual Try-On | Free · $40/mo | API.market

BASIC