AI Virtual Try-On Actor

An Apify Actor that generates virtual try-on images using AI-powered technology. Simply provide a human image and a garment image, and the Actor will create a realistic visualization of how the clothing would look on the person.

What This Tool Does

This Actor connects to the MultipleWords virtual try-on API to create realistic try-on images by combining human photos with garment images. It accepts human and clothing images, processes the request through the API, and returns a high-quality virtual try-on image along with detailed metadata.

Key Features:

• 🎨 Generate realistic virtual try-on images from photos
• 👔 Support for upper body, lower body, and dresses
• 🚀 Fast and automated try-on generation
• 📦 Structured output with image URLs and metadata
• 🔄 Reliable error handling and validation
• 📊 Complete generation details and timestamps
• 📤 Multiple file upload methods (direct upload, URLs, base64, file paths)

Purpose & Use Cases

This tool is designed to help individuals, businesses, and developers automate virtual try-on visualization for various purposes:

E-commerce & Retail

• Enable customers to visualize clothing before purchase
• Reduce return rates by showing accurate fit visualization
• Generate try-on images for product listings
• Create personalized shopping experiences

Fashion & Apparel

• Rapid prototyping of clothing designs
• Generate multiple try-on variations for marketing
• Create visual content for social media and campaigns
• Showcase clothing on different body types

Content Creation

• Generate try-on content for fashion blogs and YouTube channels
• Create visual comparisons for product reviews
• Design marketing materials with realistic try-ons
• Generate social media content

Development & Automation

• Integrate virtual try-on into e-commerce platforms
• Batch generate try-on images for product catalogs
• Create automated try-on workflows
• Build custom fashion applications

Fashion Designers

• Quickly visualize designs on models
• Create presentation materials for clients
• Generate design variations and alternatives
• Streamline the design review process

Input Parameters

The Actor requires the following input:

user_id (Required)

• Type: Integer
• Default: 663559
• Description: User ID for the API request. The default value is automatically used if not provided.
• Note: This parameter is handled automatically with a default value and typically does not need to be changed.

for_body_part (Required)

• Type: String (Enum)
• Options: "upper_body", "lower_body", "dresses"
• Description: Specifies which part of the body the garment is for. This helps the AI understand the context and generate more accurate try-on results.
• Examples:
  • "upper_body" - For shirts, jackets, tops, t-shirts
  • "lower_body" - For pants, skirts, shorts
  • "dresses" - For dresses and full-body garments

isPro (Required)

• Type: Integer
• Options: 0 or 1
• Description: Pro version flag that determines the quality and features of the generation.
  • 0 - Standard version
  • 1 - Pro version (recommended for best results)

human_image (Required)

• Type: String (File Upload, URL, or File Path)
• Description: Image of the human/person who will be wearing the garment. This should be a clear photo showing the person's body.
• Accepted Formats:
  • File Upload: Upload directly through Apify Console (recommended)
  • File Path: Local file path (e.g., "./images/human.jpg")
  • URL: Direct image URL (e.g., "https://example.com/person.jpg")
  • Base64: Base64 encoded image string
• Best Practices:
  • Use clear, well-lit photos
  • Ensure the person is clearly visible
  • Front-facing photos work best
  • Recommended formats: JPEG, PNG, WebP

garment_image (Required)

• Type: String (File Upload, URL, or File Path)
• Description: Image of the clothing item/garment to be tried on. This should be a clear photo of the clothing item.
• Accepted Formats:
  • File Upload: Upload directly through Apify Console (recommended)
  • File Path: Local file path (e.g., "./images/garment.jpg")
  • URL: Direct image URL (e.g., "https://example.com/shirt.jpg")
  • Base64: Base64 encoded image string
• Best Practices:
  • Use product photos with clear background
  • Ensure the garment is fully visible
  • Flat lay or mannequin photos work well
  • Recommended formats: JPEG, PNG, WebP

Output Structure

The Actor returns structured data containing the generated try-on image information:

{
  "success": true,
  "status": 1,
  "image_url": "https://multiplewords.nyc3.cdn.digitaloceanspaces.com/tryon/tryon_result_1769493904.jpg",
  "user_image_url": "https://multiplewords.nyc3.cdn.digitaloceanspaces.com/tryon/useroutput048c8a055b7940428f03220c76ebd6fb-2026-01-27-06-04-20.jpg",
  "garment_image_url": "https://multiplewords.nyc3.cdn.digitaloceanspaces.com/tryon/Tshirt-2026-01-27-06-04-21.webp",
  "details": {
    "id": 508905,
    "image_url": "https://multiplewords.nyc3.cdn.digitaloceanspaces.com/tryon/tryon_result_1769493904.jpg",
    "image_description": "upper_body",
    "image_name": "user generated try on",
    "image_created_at": "2026-01-27T06:05:05.671862Z",
    "image_updated_at": "2026-01-27T06:05:05.671902Z",
    "engine": 33,
    "url_slug": "",
    "source_image_url": "https://multiplewords.nyc3.cdn.digitaloceanspaces.com/tryon/Tshirt-2026-01-27-06-04-21.webp",
    "rating": 0,
    "feedback": "",
    "job_key": "0",
    "job_status": 0,
    "extra_1": "https://multiplewords.nyc3.cdn.digitaloceanspaces.com/tryon/useroutput048c8a055b7940428f03220c76ebd6fb-2026-01-27-06-04-20.jpg",
    "extra_2": "upper_body",
    "extra_3": null,
    "extra_4": null,
    "extra_5": null,
    "extra_6": null,
    "attempts": 3,
    "is_public": false,
    "isIndexed": false,
    "is_active": true,
    "user_id": 663559,
    "image_category_id": 2,
    "language_id": 49,
    "dreambooths_project_id": 1,
    "dreambooth_inference_category_id": 4
  },
  "message": "Virtual try-on image generated successfully"
}

Output Fields Explained

• success: Boolean indicating if the generation was successful
• status: API response status code (1 = success)
• image_url: Direct URL to download the generated virtual try-on image
• user_image_url: URL of the processed user/human image
• garment_image_url: URL of the processed garment image
• details: Complete metadata about the try-on generation
  • id: Unique identifier for the generated try-on
  • image_created_at: Timestamp when the try-on was created
  • image_updated_at: Timestamp when the try-on was last updated
  • engine: AI engine used for generation
  • job_status: Status of the generation job
  • attempts: Number of attempts made
  • user_id: User ID used for the generation
• message: Status message from the Actor

How to Use

Running Locally

1. Install dependencies:

   $npm install
   

2. Add your test images:

   • Create an images folder in the project root
   • Add your test images:
     • images/human.jpg - Image of a person
     • images/garment.jpg - Image of clothing item

3. Create input file in storage/key_value_stores/default/INPUT.json:

   {
     "user_id": 663559,
     "for_body_part": "upper_body",
     "isPro": 1,
     "human_image": "./images/human.jpg",
     "garment_image": "./images/garment.jpg"
   }
   

4. Run the Actor:

   $apify run
   

Deploy to Apify Platform

1. Login to Apify:

   $apify login
   

2. Deploy the Actor:

   $apify push
   

3. Run on Apify Console:

   • Go to Actors → My Actors
   • Select your AI Virtual Try-On Actor
   • Upload images using the file upload buttons:
     • Click "Choose File" for Human Image
     • Click "Choose File" for Garment Image
   • Select Body Part from dropdown (upper_body, lower_body, or dresses)
   • Set Is Pro to 1 (recommended)
   • Click "Start" to generate your virtual try-on

Using via API

Once deployed, you can call the Actor via Apify API:

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~ai-virtual-try-on/run-sync" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 663559,
    "for_body_part": "upper_body",
    "isPro": 1,
    "human_image": "https://example.com/person.jpg",
    "garment_image": "https://example.com/shirt.jpg"
  }'

Using ApifyClient (JavaScript)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const input = {
    user_id: 663559,
    for_body_part: 'upper_body',
    isPro: 1,
    human_image: './images/human.jpg',
    garment_image: './images/garment.jpg'
};

const run = await client.actor('YOUR_USERNAME/ai-virtual-try-on').call(input, {
    waitSecs: 120
});

console.log(`Results: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);

See test-with-apify-client.js and test-upload-files.js for complete examples.

Integration Examples

With Make (Integromat)

• Connect the Actor to your Make workflows
• Automatically generate try-on images when new products are added
• Send generated images to storage services or email
• Create automated product catalog updates

With Zapier

• Trigger try-on generation from e-commerce product uploads
• Automatically add try-on images to product listings
• Send try-on notifications via Slack or email
• Integrate with Shopify, WooCommerce, or other platforms

With Custom Applications

• Integrate via Apify API into your e-commerce platform
• Batch generate try-on images for product catalogs
• Create automated try-on workflows for fashion apps
• Build custom virtual fitting room experiences

Technical Details

• Runtime: Node.js 18+
• Dependencies: Apify SDK v3.5.2+
• API Endpoint: https://shorts.multiplewords.com/mwvideos/api/generate_try_on_image
• Request Method: POST
• Content Type: multipart/form-data
• Supported Image Formats: JPEG, PNG, WebP
• File Upload Methods: Direct upload, URLs, base64, local file paths

File Upload Methods

The Actor supports multiple ways to provide images:

1. File Upload (Recommended) - Upload directly in Apify Console using the file upload interface
2. File Paths - Local file paths for testing (e.g., "./images/human.jpg")
3. URLs - Direct image URLs (e.g., "https://example.com/image.jpg")
4. Base64 - Base64 encoded images (e.g., "data:image/jpeg;base64,...")

See FILE_UPLOAD_GUIDE.md and HOW_TO_UPLOAD_FILES.md for detailed instructions.

Error Handling

The Actor includes comprehensive error handling:

• ✅ Validates all required input parameters before processing
• ✅ Validates for_body_part enum values
• ✅ Validates isPro is 0 or 1
• ✅ Handles file upload errors gracefully
• ✅ Handles API errors with detailed messages
• ✅ Provides clear error messages in logs
• ✅ Returns appropriate exit codes for debugging
• ✅ Supports multiple file input methods with fallback handling

Resources

• Apify SDK Documentation
• Apify Platform Documentation
• Apify Academy - Node.js Tutorials
• Join Apify Developer Community

Additional Documentation

• FILE_UPLOAD_GUIDE.md - How to upload files via Apify Console
• HOW_TO_UPLOAD_FILES.md - Detailed file upload instructions
• INPUT_EXAMPLE.md - Input format examples for all methods
• SETUP_TEST_SCRIPTS.md - Setup guide for test scripts

Support

For issues, questions, or feature requests, please refer to the Apify documentation or community forums.

---

Built with ❤️ using Apify SDK