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

# Introduction

Welcome to the Charp.ai API Reference. This section provides detailed endpoint documentation, request/response schemas, and interactive examples for every available API.

## Authentication

Before calling any API, you need to obtain an access token using your client credentials. The token is passed as a `Bearer` token in the `Authorization` header of all subsequent requests.

<Card title="Create Access Token" icon="key" href="/api-reference/authorization-api/get-authorization-token">
  Authenticate with your `client_id` and `client_secret` to receive a Bearer token
</Card>

***

## Available APIs

<CardGroup cols={2}>
  <Card title="Batch Media API" icon="layer-group" href="/api-reference/batch-media-api/create-batch-task">
    Create, manage, and monitor large-scale media generation tasks for batch campaigns
  </Card>

  <Card title="Realtime Media API" icon="bolt" href="/api-reference/realtime-media-api/create-realtime-task">
    Trigger on-the-fly personalized media generation from apps or chatbots in real time
  </Card>

  <Card title="Virtual Try-On API" icon="shirt" href="/api-reference/virtual-tryon-api/tryon-request">
    Enable AI-powered virtual garment try-on experiences with model and garment images
  </Card>
</CardGroup>

***

## Endpoint Overview

### Authorization API

| Method | Endpoint      | Description                                     |
| ------ | ------------- | ----------------------------------------------- |
| `POST` | `/auth/token` | Obtain an access token using client credentials |

### Batch Media API

| Method | Endpoint                      | Description                              |
| ------ | ----------------------------- | ---------------------------------------- |
| `POST` | `/media/task/create`          | Create a new batch media generation task |
| `POST` | `/media/task/cancel/{taskId}` | Cancel an in-progress batch task         |
| `GET`  | `/media/task/status/{taskId}` | Check the status of a batch task         |

### Realtime Media API

| Method | Endpoint                  | Description                                  |
| ------ | ------------------------- | -------------------------------------------- |
| `POST` | `/media/demo`             | Generate personalized media in real time     |
| `GET`  | `/status/{transactionId}` | Check the status of a realtime media request |

### Virtual Try-On API

| Method | Endpoint                   | Description                                                   |
| ------ | -------------------------- | ------------------------------------------------------------- |
| `POST` | `/vton/request`            | Submit a virtual try-on request with model and garment images |
| `GET`  | `/vton/status/{requestId}` | Retrieve the status and output of a try-on request            |

***

## Common Response Codes

| Code  | Description                                 |
| ----- | ------------------------------------------- |
| `200` | Request was successful                      |
| `400` | Bad request — invalid or missing parameters |
| `401` | Unauthorized — invalid or expired token     |

## Need Help?

If you need integration support, reach out to us at [support@whilter.ai](mailto:support@whilter.ai).