AI Fashion Models I/O

Intro

The API takes flat-lay or mannequin garment photos and generates images with fashion models wearing your products.

Cost

• 2 credits per 1 output image.

Rate limits

• 1 generation per 1 second.

• 60 generations per 1 minute.

Input

Clothing

Provide garment images as URLs; you can pass multiple URLs or submit a complete look as a full outfit. You can pass up to 5 garment images via input.clothing.

Swimwear and lingerie may be flagged by safety filters. Contact support if you experience issues.

    "input": {
        "clothing": [
            "https://images.claid.ai/photoshoot-templates/assets/images/f4945a28e9874eaa89fd43313f373040.png",
            "https://images.claid.ai/photoshoot-templates/assets/images/b63641ea19dd4dac8fdc02a6195873f0.jpeg"
        ]
    }
}

By default, we treat the input as a full outfit and render it as-is; if any part is missing, auto-completion applies. When a full outfit is provided, no defaults are added.

Auto-completion:

• Bottoms only → adds a plain white T-shirt.

• Top only → adds neutral blue jeans.

• No shoes → generates matching shoes.

Model

You can also specify a model image via URL.

By default, a random suitable model will be chosen.

{
    "input": {
        "model": "https://images.claid.ai/models/ai-fashion-model/d0ad3dafbd1d4fcfac4012ee810e7463.jpg",
        "clothing": [
            "https://images.claid.ai/photoshoot-templates/assets/images/f4945a28e9874eaa89fd43313f373040.png",
            "https://images.claid.ai/photoshoot-templates/assets/images/b63641ea19dd4dac8fdc02a6195873f0.jpeg"
        ]
    }
}

Storage URLs

You can connect Cloud Storage and use it as a source for images. Currently, our API supports AWS S3 and Google Cloud Storage.

After connecting your Cloud Storage, you can refer the storage name as an input.

{
    "input": {
        "model": "storage://storage-name/path/model.jpg",
        "clothing": [
            "storage://storage-name/path/clothing-top.jpg",
            "storage://storage-name/path/clothing-bottom.jpg"
        ]
    }
}

Input image file types

Our API supports the following image formats as inputs: JPEG, PNG, WEBP, AVIF and HEIC.

Output

Configuration of result output is optional.

By default, you may omit the output option from the request payload. In this case, our system stores the result in a temporary bucket with a lifespan of 24 hours and provides a public URL to the image.

Alternatively, you can use a connected Cloud Storage: just configure the path to the folder where you want to store results.

Output image file types

The following image formats are supported for the output: JPEG and PNG. Default is PNG.

Output number of images

The API supports from 1 to 4 output images. Default is 1 image per request.

Basic and advanced output options

Basic Usage

{
    "output": "storage://storage-name/result-path/image-name.jpg"
}

Advanced Usage