# 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`.

{% hint style="warning" %}
Swimwear and lingerie may be flagged by safety filters. Contact support if you experience issues.
{% endhint %}

```json
    "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.

```json
{
    "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](https://docs.claid.ai/storage-connectors) 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.

```json
{
    "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](https://docs.claid.ai/storage-connectors): 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

{% tabs %}
{% tab title="Basic Usage" %}

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

{% endtab %}

{% tab title="Advanced Usage" %}

<pre class="language-json"><code class="lang-json">{
    "output": {
<strong>        "destination": "storage://storage-name/result-path/image-name.jpg",
</strong>        "format": "jpeg",
        "number_of_images": 1
    }
}
</code></pre>

{% endtab %}
{% endtabs %}