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. Reuse its externalId and later try-ons skip that step.

Headers

string
Makes the call safe to retry: a retry with the same key and body waits on the same generation instead of starting and charging another. See Idempotency.

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[]
Every product’s ID, in the order you sent them: 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.