This API is used to validate the suitability of a model image before performing virtual try-on. The API analyzes the following aspects:

• Determines if the image meets the requirements for try-on processing
• Analyzes and returns the types of clothing that can be tried on with the model (upper, lower, or full body)
• Checks and warns about issues with pose, size, and camera angle

Model Image Requirements:

• Only one person should be present in the image
• Model must be standing straight and facing forward
• Person in the image must be clearly visible and of sufficient size
• Full body shot is recommended for trying different types of clothing
• Simple background without complex patterns or distractions

curl -X POST https://platform.fitroom.app/api/tryon/input_check/v1/model \
  -H "X-API-KEY: your-api-key" \
  -F "[email protected]"

{
    "is_good": true,
    "good_clothes_types": [
        "upper",    // Suitable for tops, shirts, jackets
        "lower",    // Suitable for pants, skirts
        "full"      // Suitable for dresses, jumpsuits
    ]
}

{
    "is_good": true,
    "error_code": "410xxx",    // Warning code
    "good_clothes_types": [
        "upper",
        "lower",
        "full"
    ]
}

{
    "is_good": false,
    "error_code": "400xxx",    // Error code
    "good_clothes_types": []   // No suitable clothing types
}

This API helps validate clothing images before performing virtual try-on. It analyzes the image to:

• Determine if the image contains valid clothing that can be processed
• Identify the type of clothing (upper body, lower body, or full body)
• Check image quality and suitability for virtual try-on

Image Requirements:

• Clear, high-resolution image of the clothing item
• Good lighting and contrast
• Minimal background distractions
• Clothing should be displayed flat or on a mannequin
• The entire clothing item should be visible in the frame

Clothing Types:

• Upper: Shirts, t-shirts, blouses, jackets, sweaters
• Lower: Pants, shorts, skirts
• Full: Dresses, jumpsuits, full-body outfits

curl -X POST https://platform.fitroom.app/api/tryon/input_check/v1/clothes \
  -H "X-API-KEY: your-api-key" \
  -F "[email protected]"

{
    "clothes_type": "upper",    // Detected clothing type
    "is_clothes": true         // Image contains valid clothing
}

{
    "clothes_type": "upper",    // Detected clothing type
    "is_clothes": false        // Image may not be suitable
}

This API initiates the virtual try-on process by creating a task that will generate an image of the model wearing the specified clothing. The service supports both single item try-ons and combo try-ons (combining upper and lower body clothing).

curl -X POST https://platform.fitroom.app/api/tryon/v2/tasks \
  -H "X-API-KEY: your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "cloth_type=upper" \
  -F "hd_mode=true"

curl -X POST https://platform.fitroom.app/api/tryon/v2/tasks \
  -H "X-API-KEY: your-api-key" \
  -F "cloth_image=@upper_cloth.jpg" \
  -F "lower_cloth_image=@lower_cloth.jpg" \
  -F "[email protected]" \
  -F "cloth_type=combo" \
  -F "hd_mode=true"

{
    "task_id": "123456",    // Unique identifier for the task
    "status": "CREATED"     // Initial status of the task
}

This API allows you to check the status of a try-on task and retrieve the final result. Since the try-on process runs asynchronously, you'll need to poll this endpoint until the task is completed.

curl -X GET https://platform.fitroom.app/api/tryon/v2/tasks/123456 \
  -H "X-API-KEY: your-api-key"

{
    "task_id": "123456",
    "status": "CREATED",
    "progress": 0,
    "created_at": 1744707904
}

{
    "task_id": "123456",
    "status": "PROCESSING",
    "progress": 45,    // Task is 45% complete
    "created_at": 1744707904,
    "started_at": 1744707904
}

{
    "task_id": "123456",
    "status": "COMPLETED",
    "download_signed_url": "https://storage.googleapis.com/enhance-asia-southeast1-dev/tryon/bc140fd58ece45c493...",
    "progress": 100,
    "created_at": 1744707904,
    "started_at": 1744707904,
    "completed_at": 1744707912
}

{
    "task_id": "123456",
    "status": "FAILED",
    "error": "Failed to process try-on task",
    "created_at": 1744707904,
    "started_at": 1744707904,
    "completed_at": 1744707912
}