Search docs

Search the TryOnCloud API docs

API reference

Limits

Rate limits, image limits, timeouts and speed.

Rate limits

EndpointLimitWhen exceeded
POST /generate300 requests per minute per API key, 600 per minute per account429 RATE_LIMITED with Retry-After
Test mode (mock=true)30 requests per minute and 500 per day per account429 RATE_LIMITED with Retry-After
GET /credits60 requests per minute per API key429 RATE_LIMITED
MCP tool calls60 per minute per API keyError result
DELETE /results/:id, DELETE /customers/:id, DELETE /batches/:id120 requests per minute per API key429 RATE_LIMITED
GET /results/:id, GET /generations/:id, GET /batches/:id300 requests per minute per API key429 RATE_LIMITED
POST /generations, POST /batchesCount toward the 300 per minute generate limit429 RATE_LIMITED
Async jobs running at once50 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

LimitValue
FormatsJPEG, PNG, WebP, HEIC (checked by content, not file name)
Maximum size15MB per image
garment_urlPublic https URL on port 443 or 80. Internal, private and cloud-metadata addresses are blocked, including through redirects
OutputOne PNG per request, about 1 megapixel (the "1K" class), shaped to the person photo. Higher resolutions are not offered yet

Time

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

Credits

PurchaseAny amount from 50 to 100,000 per order
ExpiryNever
Failed try-onsRefunded automatically
Per-key monthly limitOptional, set when you create the key. Counts this calendar month (UTC); past it the key gets 402 KEY_LIMIT_REACHED until the 1st
Key expiryOptional date; the key stops working after that day (UTC)

Async jobs and batches

Batch sizeUp to 500 items (10 in test mode)
ResultsKept 7 days, then deleted
Webhook replyAnswer 2xx within 8 seconds; other replies are retried for up to a day
Webhook URLsPublic https on the standard port; redirects are not followed
Test webhookUp to 5 per minute from the dashboard