# Limits

## Rate limits

| Endpoint | Limit | When exceeded |
|---|---|---|
| `POST /generate` | 300 requests per minute per API key, 600 per minute per account | `429 RATE_LIMITED` with `Retry-After` |
| Test mode (`mock=true`) | 30 requests per minute and 500 per day per account | `429 RATE_LIMITED` with `Retry-After` |
| `GET /credits` | 60 requests per minute per API key | `429 RATE_LIMITED` |
| MCP tool calls | 60 per minute per API key | Error result |
| `DELETE /results/:id`, `DELETE /customers/:id`, `DELETE /batches/:id` | 120 requests per minute per API key | `429 RATE_LIMITED` |
| `GET /results/:id`, `GET /generations/:id`, `GET /batches/:id` | 300 requests per minute per API key | `429 RATE_LIMITED` |
| `POST /generations`, `POST /batches` | Count toward the 300 per minute generate limit | `429 RATE_LIMITED` |
| Async jobs running at once | 50 per account (batches are separate) | `429 TOO_MANY_JOBS` |

The generate limit is a safety backstop against leaked keys and runaway loops. Real integrations do not reach it. For very high sustained volume, [contact us](/contact) before launch so capacity is planned.

## Images

| Limit | Value |
|---|---|
| Formats | JPEG, PNG, WebP, HEIC (checked by content, not file name) |
| Maximum size | 15MB per image |
| `garment_url` | Public `https` URL on port 443 or 80. Internal, private and cloud-metadata addresses are blocked, including through redirects |
| Output | One PNG per request, about 1 megapixel (the "1K" class), shaped to the person photo. Higher resolutions are not offered yet |

## Time

| | |
|---|---|
| Typical generation | Median about 19 seconds, 90% within about 24 seconds (last 30 days of production traffic) |
| Maximum request time | 120 seconds. Set your client timeout to 120 seconds |
| Repeated garments | The garment analysis is cached for 30 days, so a repeat try-on of the same garment photo skips about 2 seconds of preparation |

## Credits

| | |
|---|---|
| Purchase | Any amount from 50 to 100,000 per order |
| Expiry | Never |
| Failed try-ons | Refunded automatically |
| Per-key monthly limit | Optional, set when you create the key. Counts this calendar month (UTC); past it the key gets `402 KEY_LIMIT_REACHED` until the 1st |
| Key expiry | Optional date; the key stops working after that day (UTC) |

## Async jobs and batches

| | |
|---|---|
| Batch size | Up to 500 items (10 in test mode) |
| Results | Kept 7 days, then deleted |
| Webhook reply | Answer `2xx` within 8 seconds; other replies are retried for up to a day |
| Webhook URLs | Public `https` on the standard port; redirects are not followed |
| Test webhook | Up to 5 per minute from the dashboard |
