> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akool.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clothing Swap V5 API Overview

> Models, workflow, input limits, and billing for Clothing Swap V5.

<Info>
  Replace clothing in images or videos using reference outfit images.

  Analyze the source material first. `Auto` selects the clothing region automatically; it is not a vehicle category. Supply a reference outfit image for each selected person.
</Info>

## API Endpoints

* [List Models](/ai-tools-suite/swap-studio/clothing-swap-v5/models) — `GET`
* [Create Task](/ai-tools-suite/swap-studio/clothing-swap-v5/create) — `POST`
* [Get Task Result](/ai-tools-suite/swap-studio/clothing-swap-v5/get-result) — `GET`
* [Analyze Source Material](/ai-tools-suite/swap-studio/clothing-swap-v5/analyze) — `POST`
* [Get Analysis Result](/ai-tools-suite/swap-studio/clothing-swap-v5/analysis-result) — `GET`

## Getting Started

1. List the models available for this feature.
2. If required by your model, analyze the source and wait for the analysis to complete.
3. Create a task using the model-specific parameters.
4. Poll task results or receive the final webhook notification.

## Billing

Generation is priced using the selected model configuration and your account/team pricing. Image generation is charged per task; video pricing also depends on duration and resolution. Credits are reserved before queueing and finalized through the existing generation billing flow. Creation errors do not produce a billable task. Read `deduction_credit` per created task rather than treating the sample value as a price quotation. AIGC website membership discounts do not automatically apply to OpenAPI; account and team pricing can change the final credit amount.

## Response Code Description

<Note>A business code other than 1000 indicates that the API request failed. For batch creation, also check data.errors.</Note>

| **Code** | **Description** |
| - | - |
| 1000 | Request succeeded. Inspect task status for generation results. |
| 1003 | Invalid input, unsupported model/parameters, unavailable feature, or task/analysis not found. |
| 1008 | Content does not exist (general platform error). |
| 1009 | Permission denied. |
| 1101 | Invalid or expired authorization. |
| 1102 | Authorization is missing. |
| 1104 | Insufficient credits. |

See the [Webhook guide](/ai-tools-suite/webhook) for callback verification and the [complete error list](/ai-tools-suite/error-code) for other account errors.

## Callback

If `webhookUrl` is supplied, final task notifications follow the existing encrypted and signed [Webhook format](/ai-tools-suite/webhook). After verification and decryption, read `_id`, `status`, `type`, and `url`. Fetch task detail to obtain operation-specific fields, including additional hairstyle views. Return HTTP 200 to acknowledge delivery.

## Input limits

Video clothing replacement supports 1–120 seconds. Image and video mappings must select distinct IDs from a completed analysis of the same URL and media type. `clothing_area` defaults to `Top`. `resolution` defaults to `480p`; `480p` and `720p` are accepted.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.