# 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](/storage-connectors/overview.md) 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](/storage-connectors/overview.md): 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.claid.ai/ai-fashion-models-api/ai-fashion-models-i-o.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.