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

# Rate limits

> How many try-ons can run at once, and how to read the limit from the response.

The Try-On API limits how many try-ons an account runs at the same time. Past that, what you can run depends on your credits.

| Limit | Value | Applies to |
| - | - | - |
| Try-ons running at once | 20 per account | [`POST /try-on`](https://docs.genlook.app/docs/tryon-api/endpoints/create-try-on) and [`POST /try-on/sync`](https://docs.genlook.app/docs/tryon-api/endpoints/create-try-on-sync) |
| Items per batch | 500 | [`POST /batches`](https://docs.genlook.app/docs/tryon-api/endpoints/create-batch) |
| Products per try-on | 4 | Try-ons and batch items |
| Image size | 10 MB | Every uploaded or fetched image |

A try-on counts from the moment it is created until it is `COMPLETED` or `FAILED`, about 10 seconds. Batch items and `mock` try-ons do not count.

## Headers

Every response to `POST /try-on` and `POST /try-on/sync` says where you stand:

| Header | Meaning |
| - | - |
| `X-RateLimit-Limit` | Try-ons the account may have running at once. |
| `X-RateLimit-Remaining` | Try-ons you can still start right now, this one counted. |
| `Retry-After` | On a `429` only: seconds to wait before retrying. |

## Over the limit

The call returns `429 RATE_LIMITED` and nothing is charged:

```json theme={null}
{
  "code": "RATE_LIMITED",
  "message": "Too many try-ons running at once for this account (limit 20). Wait for some to finish, or send bulk work through the batch endpoint (POST /tryon/v1/batches).",
  "status": 429,
  "details": { "reason": "CONCURRENCY_LIMIT", "limit": 20, "retryAfter": 10 }
}
```

Wait for `Retry-After` seconds and send the request again. The [SDK](https://docs.genlook.app/docs/tryon-api/sdk.md) does this for you.

## Bulk work

To run hundreds of try-ons, use [batches](https://docs.genlook.app/docs/tryon-api/batches.md): up to 500 items per call, half price, done within 4 hours, and outside the limit above.

Need a higher limit for live traffic? Write to [support@genlook.app](mailto:support@genlook.app) with your expected volume.


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