1.12.0 (2026-11-16)
AddedIdempotency-Keyheader onPOST /try-on,/try-on/syncandPOST /batches: a retry with the same key and body within 24 hours returns the first response and is never charged twice. New errorsIDEMPOTENCY_IN_PROGRESS(409) andIDEMPOTENCY_KEY_REUSED(422).X-RateLimit-LimitandX-RateLimit-Remainingon try-on responses: the try-ons the account may run at once and how many it can still start. See Rate limits.- An OpenAPI 3.1 description of the whole API at
api.genlook.app/tryon/v1/openapi.json, with every endpoint, error and webhook. Import it in Postman or generate a client from it. @genlook/api0.8.0: try-ons and batches are sent with anIdempotency-Keyand are now retried on5xxand network errors. PassidempotencyKeyto retry a call yourself.
POST /try-on/syncanswers200when the result is ready, as documented. It used to answer201.
1.11.0 (2026-11-15)
Added- Person photo checks, run before the try-on starts, so a refused photo is never charged. New errors, all 400:
PERSON_IMAGE_BLANK(an empty photo: a flat colour or a plain wall),PERSON_TOO_FAR(the person is too small in the photo) andNO_PERSON_DETECTED. person.requirePersononPOST /try-on,/try-on/syncand batch items, andrequirePersononPOST /images/upload: refuse a photo with no person in it. Off by default, so pet photos and close-ups of feet or hands keep working.@genlook/api0.7.0:person.requirePersonon try-ons and batch items,requirePersononimages.upload, and the new codes thrown asValidationError. It also carriesApiKeyLimitReachedError,account.usageandaccount.iterateUsagefrom 1.10.0.
- A person photo under 500 x 625 px is now refused with
PERSON_IMAGE_TOO_SMALLand its sizes indetails, still with status 400. It used to come back asINVALID_IMAGE, which now only means a corrupt file.
1.10.0 (2026-11-14)
Added- Several API keys per account. Create one key per app or environment on platform.genlook.app (API keys page), give each a name, an optional monthly credit limit and an optional expiry date, and see what each one spends. Your existing key keeps working as the “Default” key.
- New error
API_KEY_LIMIT_REACHED(402): the key spent its monthly credit limit. Raise the limit, use another key, or wait for the 1st of the month (UTC). GET /usageandGET /usage/export: the credits charged for each generation, with its ID, timestamps and status, as JSON or as one CSV file for a period. Use it to reconcile usage with your own logs and your invoice. The same CSV is on platform.genlook.app under Generations, Export CSV.
1.9.0 (2026-11-09)
Addedperson.keepHeadCoveringonPOST /try-on,/try-on/syncand batch items: the person keeps their own hijab, headscarf or hat, and nothing worn on the head comes from the product photos. For products sold without headwear, even when the model wears some.
1.8.2 (2026-10-27)
Changed- Multi-product try-ons cost 2 credits, whatever the number of products: a 4-product outfit is now 2 credits, not 4. In 2K, 3 credits. Single-product try-ons stay at 1 credit. Same for batch items, at half price.
@genlook/api0.6.0:tryOnCreditCostfollows the new price, andMULTI_PRODUCT_CREDITSis exported.
1.8.1 (2026-10-22)
Changed- 2K results cost 1 credit more per try-on instead of twice the price: a 2-product outfit in 2K is now 3 credits, not 4. Same for batch items.
@genlook/api0.5.0:TWO_K_EXTRA_CREDITSandtryOnCreditCost(productCount, resolution).TWO_K_CREDIT_MULTIPLIERis deprecated.- Inline products are now kept 30 days after their last use, up from 15. Existing inline products move to the new window.
- An inline product’s images live as long as the product. Genlook keeps its own copy after the first try-on, so a signed or short-lived image URL keeps working for the product’s whole lifetime.
1.8.0 (2026-10-20)
Added- 2K results:
output.resolution: "2k"onPOST /try-on,/try-on/syncand batch items returns a 4 megapixel image (2048 x 2048 px in area). The other value,"default", is what you get without the field: 1200 px on the long side. Same try-on, real high-resolution detail. 2 credits per product. @genlook/api0.4.0:output.resolutionon try-ons and batch items, plus theOutputResolutiontype andTWO_K_CREDIT_MULTIPLIER.
1.7.0 (2026-10-08)
Added- Multiple products:
POST /try-onand/try-on/synctake up to 4 clothing items inproducts, worn together in one result. Only those garments change, the rest of the outfit stays. productExternalIdson the try-on responses: every product’s ID, in request order.MULTI_PRODUCT_NOT_SUPPORTED: a try-on with several products where one is not clothing. Refunded.- Batches accept multi-product items.
- MCP
try_on: up to 3 more clothing items by link.
productExternalIdon the try-on responses: useproductExternalIds. Still returned, nothing to change right away.
1.6.1 (2026-10-01)
FixedPOST /images/upload:crop=falsesent as a form field was read astrue, so the photo was always cropped. It now keeps the original framing.
- Every error response carries an
x-request-idheader. Quote it to support. - Failed
POST /try-on/synccalls include the generation indetails.generationId. @genlook/api0.2.0: try-ons and uploads are no longer retried after a server error or dropped connection (only on429), so a request can’t be charged twice.createSyncfailures throwGenerationFailedErrorlikewaitFor. Per-callsignal/timeoutMs/maxRetrieson every method. Upload options renamed toexternalUserId/keepForDays(old names still work). Runs on edge runtimes without Node built-ins.
1.6.0 (2026-09-30)
AddedPOST /try-on/sync: same body as/try-on, returns the result in the same request.202with thegenerationIdif it takes longer than 90 seconds.
POST /productsanalyzes the product right away, so its first try-on returns faster.- New accounts get 10 free credits (was 3).
1.5.0 (2026-06-25)
RemovedautoClassifyImageson products. Image classification is now automatic.
1.4.0 (2026-06-17)
New/try-on and upload field names. The 1.0 body (product + customer: { id | url | fileKey }) still works, deprecated. Don’t mix old and new fields in one body.
Removed
imageUrlson products (deprecated since 1.0.0). Useimages: [{ source: { url } }].
1.3.0 (2026-06-17)
Changed- Product images moved under
source:images: [{ source: { url | fileKey }, classifications? }]. Flatimages: [{ url }]still works (deprecated). The customer change of this release was replaced the same day bypersonin 1.4.0.
1.2.0 (2026-05-18)
AddedautoClassifyImageson products (removed in 1.5.0).
- For some product types, the engine prefers an image of the product worn on a person over a flat packshot.
autoDetectImageRoles.
1.1.0 (2026-05-14)
AddedretentionDays(1, 3 or 7) on upload and try-on.customerIdon upload, to link uploads to a user.DELETE /customers/:externalUserIdfor GDPR erasure.errorCodeon Generation Status, including the newPRODUCT_IMAGE_FETCH_FAILED.
1.0.0 (2026-05-12)
First stable release. Added- Inline products on
/try-on: reference, create or update, or one-shot. - Person image by uploaded
id,urlor multipartfileKey. - Multipart product images on
/try-onand/products. cropon upload.useWatermarkon/try-onand the Watermark feature.productExternalIdin/try-onresponses.- Product stats.
- Product lifetimes: forever via
POST /products, 15 days inline, 7 days one-shot, refreshed on each use. - Partial updates on
POST /products. - Error shape
{ code, message, status, details? }. See Errors.
PATCH /products/:externalId,GET /generations(list), generation ratings,resultImageKey,productIdin product responses.
Versioning
- Minor and patch (
1.x): additions and fixes. Existing requests keep working. Deprecated or experimental fields can be removed after notice. - Major (
2.0): breaking changes, announced ahead with a migration window. v1 stays at/tryon/v1until its announced end date.

