Skip to main content
POST
Same body as Create Try-On, but the request stays open until the result is ready, usually about 10 seconds. No polling. Use it for scripts, serverless functions and any client that prefers one call. Costs 1 credit, refunded if the generation fails. The request waits up to 90 seconds. Set your HTTP client timeout above that (100 seconds works).
First try-on of a product is a few seconds slower: the product gets analyzed. Register products ahead of time with Upsert Product and the analysis runs right away, before the first try-on.

Body

Identical to Create Try-On: products, person, externalUserId, output.

Response

string
required
The generation ID.
string
required
COMPLETED on 200. PENDING or PROCESSING on 202.
string
Temporary signed URL of the result. Present on 200. Display or download it right away, or fetch the generation again for a fresh URL.
string
Your externalId, or the generated ID of a one-shot product.
string
required
ISO timestamp.
string
required
ISO timestamp.

Errors

Everything from Create Try-On, plus the generation errors from Generation Status. See Errors for the full list.