API reference
Limits
Rate limits, image limits, timeouts and speed.
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 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 |