---
title: "Async Try On Generation Api"
method: POST
path: "/v1/image/ai-fashion-models"
tags: ["Image"]
---

# Async Try On Generation Api

`POST /v1/image/ai-fashion-models`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `token` scopes: `image_editing`
  - OAuth 2
    - Password
    - Token URL: `token`

AI Fashion Models generation

## Request body

- TryOnAPIRequest
  - `output` union: Customize output format, destination and number of images.
    - TryOnAPIRequestOutputObject
      - `number_of_images` integer: Number of output images.
      - `destination` string, uri: Customize the result output.
      - `format` 'jpeg' | 'png': An enumeration.
    - string, uri
  - `input` TryOnAPIRequestInputOptions, required
    - `model` string, uri: URL of the human model image. Image must be accessible by our system.
    - `clothing` string[], required: List of clothing images URLs. Images must be accessible by our system.
  - `options` TryOnAPIRequestOptionsObject, required
    - `pose` string: Pose prompt for the generation.
    - `background` string: Background prompt for the generation.
    - `aspect_ratio` '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '9:16' | '16:9' | '21:9' | '4:5' | '5:4': An enumeration.

## Response `200`

Successful Response

- ResponseTryOnAPIAcceptedResponse: Wrapper for responses
  - `data` TryOnAPIAcceptedResponse
    - `id` integer, required
    - `status` 'ACCEPTED' | 'WAITING' | 'PROCESSING' | 'DONE' | 'ERROR' | 'CANCELLED' | 'PAUSED', required: An enumeration.
    - `created_at` string, date-time, required
    - `request` object, required
    - `result_url` string, uri, required

## Other responses

- `401`: Authorization is required.
- `402`: No API calls left.
- `403`: Not enough permissions.
- `422`: Unprocessable Entity.
- `429`: Too many requests.

## Changes

- **2026-11-03** `18c907f76458`: 2 info
  - the endpoint scheme security `OAuth2PasswordBearer` was added to the API
  - the endpoint scheme security `OAuth2PasswordBearer` was added to the API

[Operation history](https://skmtc.dev/claid/apis/claid-rest-api/changes/v1/image/ai-fashion-models/post.md)

---

[API](https://skmtc.dev/claid/apis/claid-rest-api.md) - [All operations](https://skmtc.dev/claid/apis/claid-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/claid/apis/claid-rest-api/revisions/18c907f76458?raw)