AI Clothes Changer API

Overview

AI Clothes Changer lets you virtually try on different clothing items on a person in an image. The API uses advanced AI to realistically change outfits, styles, and clothing accessories while preserving the person’s pose, lighting, and background.

How It Works

Provide a person image - Upload an image of the person you want to dress
Provide a garment image - Upload an image of the clothing item you want to try on
Set the garment type to upper_body, lower_body, or entire_outfit.
API generates the result - AI applies the garment to the person realistically
Download the result - Retrieve your image with the new outfit

Use Cases

E-commerce virtual try-on - Let customers preview outfits before buying
Fashion design - Prototype clothing designs on models
Social media content - Create outfit inspiration posts
Personal styling apps - Build virtual wardrobe features
Marketing campaigns - Generate product variations efficiently

Best Practices

Image Quality

Use clear, full-body or half-body shots - The AI works best when the person’s clothing is clearly visible.

Good lighting - Well-lit images produce more realistic results
Visible clothing area - Ensure the clothing you want to change is fully visible
Minimal obstructions - Avoid crossed arms or objects covering clothing
Simple backgrounds - Solid or simple backgrounds work best

Garment Image Requirements

✅ Good garment images:

Clear, well-lit photos of the clothing item
Flat lay or on a mannequin works best
Minimal background distractions
Full view of the garment

Garment Types:

upper_body - Shirts, jackets, tops, blouses
lower_body - Pants, skirts, shorts
entire_outfit covers dresses, jumpsuits, and full outfits. This is the default.

dresses is deprecated; use entire_outfit instead.

Code Examples

Basic Clothes Change

from magic_hour import Client
import os

client = Client(token=os.getenv("MAGIC_HOUR_API_KEY"))

result = client.v1.ai_clothes_changer.generate(
    assets={
        "person_file_path": "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/freedom.jpg",
        "garment_file_path": "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/michael-jackson-red-jacket.png",
        "garment_type": "upper_body"
    },
    name="Clothes Changer image",
    wait_for_completion=True,
    download_outputs=True,
    download_directory="."
)

if result.status == "complete":
    print(f"✅ Clothes change complete!")
    print(f"Downloaded to: {result.downloaded_paths}")
    print(f"Credits charged: {result.credits_charged}")
else:
    print(f"❌ Job failed with status: {result.status}")
    if result.error:
        print(f"Error: {result.error.code}: {result.error.message}")

import { Client } from "magic-hour";

const client = new Client({ token: process.env.MAGIC_HOUR_API_KEY });

const result = await client.v1.aiClothesChanger.generate(
  {
    assets: {
      personFilePath:
        "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/rookiesteph.jpg",
      garmentFilePath:
        "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/bullsjersey.webp",
      garmentType: "upper_body",
    },
    name: "Clothes Changer image",
  },
  {
    waitForCompletion: true,
    downloadOutputs: true,
    downloadDirectory: ".",
  }
);

console.log(`Status: ${result.status}`);
console.log(`Downloaded to: ${result.downloadedPaths}`);

Different Garment

result = client.v1.ai_clothes_changer.generate(
    assets={
        "person_file_path": "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/rookiesteph.jpg",
        "garment_file_path": "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/bullsjersey.webp",
        "garment_type": "upper_body"
    },
    name="Clothes Changer image",
    wait_for_completion=True,
    download_outputs=True,
    download_directory="."
)

if result.status == "complete":
    print(f"✅ Clothes change complete!")
    print(f"Downloaded to: {result.downloaded_paths}")
    print(f"Credits charged: {result.credits_charged}")
else:
    print(f"❌ Job failed with status: {result.status}")
    if result.error:
        print(f"Error: {result.error.code}: {result.error.message}")

const result = await client.v1.aiClothesChanger.generate(
  {
    assets: {
      personFilePath:
        "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/rookiesteph.jpg",
      garmentFilePath:
        "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/bullsjersey.webp",
      garmentType: "upper_body",
    },
    name: "Clothes Changer image",
  },
  {
    waitForCompletion: true,
    downloadOutputs: true,
    downloadDirectory: ".",
  }
);

console.log(`✅ Downloaded to: ${result.downloadedPaths}`);

Pricing

Output	Credits
1 clothes change	25 credits

Resolution Limits

Clothes Changer has no API parameter for output resolution. Check the current endpoint and plan details when planning output sizes.

Try this in our Google Colab Cookbook: Run this API with sample code. Just add your API key.

API Reference