Skip to main content
v1 is stable since 2026-05-12. New versions only add things. Deprecated fields keep working until announced otherwise. Coming from the alpha? See Migrating from the alpha.

1.12.0 (2026-11-16)

Added
  • Idempotency-Key header on POST /try-on, /try-on/sync and POST /batches: a retry with the same key and body within 24 hours returns the first response and is never charged twice. New errors IDEMPOTENCY_IN_PROGRESS (409) and IDEMPOTENCY_KEY_REUSED (422).
  • X-RateLimit-Limit and X-RateLimit-Remaining on 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/api 0.8.0: try-ons and batches are sent with an Idempotency-Key and are now retried on 5xx and network errors. Pass idempotencyKey to retry a call yourself.
Changed
  • POST /try-on/sync answers 200 when the result is ready, as documented. It used to answer 201.

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) and NO_PERSON_DETECTED.
  • person.requirePerson on POST /try-on, /try-on/sync and batch items, and requirePerson on POST /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/api 0.7.0: person.requirePerson on try-ons and batch items, requirePerson on images.upload, and the new codes thrown as ValidationError. It also carries ApiKeyLimitReachedError, account.usage and account.iterateUsage from 1.10.0.
Changed
  • A person photo under 500 x 625 px is now refused with PERSON_IMAGE_TOO_SMALL and its sizes in details, still with status 400. It used to come back as INVALID_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 /usage and GET /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)

Added
  • person.keepHeadCovering on POST /try-on, /try-on/sync and 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/api 0.6.0: tryOnCreditCost follows the new price, and MULTI_PRODUCT_CREDITS is 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/api 0.5.0: TWO_K_EXTRA_CREDITS and tryOnCreditCost(productCount, resolution). TWO_K_CREDIT_MULTIPLIER is 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" on POST /try-on, /try-on/sync and 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/api 0.4.0: output.resolution on try-ons and batch items, plus the OutputResolution type and TWO_K_CREDIT_MULTIPLIER.

1.7.0 (2026-10-08)

Added
  • Multiple products: POST /try-on and /try-on/sync take up to 4 clothing items in products, worn together in one result. Only those garments change, the rest of the outfit stays.
  • productExternalIds on 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.
Deprecated
  • productExternalId on the try-on responses: use productExternalIds. Still returned, nothing to change right away.

1.6.1 (2026-10-01)

Fixed
  • POST /images/upload: crop=false sent as a form field was read as true, so the photo was always cropped. It now keeps the original framing.
Added
  • Every error response carries an x-request-id header. Quote it to support.
  • Failed POST /try-on/sync calls include the generation in details.generationId.
  • @genlook/api 0.2.0: try-ons and uploads are no longer retried after a server error or dropped connection (only on 429), so a request can’t be charged twice. createSync failures throw GenerationFailedError like waitFor. Per-call signal / timeoutMs / maxRetries on every method. Upload options renamed to externalUserId / keepForDays (old names still work). Runs on edge runtimes without Node built-ins.

1.6.0 (2026-09-30)

Added
  • POST /try-on/sync: same body as /try-on, returns the result in the same request. 202 with the generationId if it takes longer than 90 seconds.
Changed
  • POST /products analyzes 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)

Removed
  • autoClassifyImages on 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
  • imageUrls on products (deprecated since 1.0.0). Use images: [{ source: { url } }].

1.3.0 (2026-06-17)

Changed
  • Product images moved under source: images: [{ source: { url | fileKey }, classifications? }]. Flat images: [{ url }] still works (deprecated). The customer change of this release was replaced the same day by person in 1.4.0.

1.2.0 (2026-05-18)

Added
  • autoClassifyImages on products (removed in 1.5.0).
Changed
  • For some product types, the engine prefers an image of the product worn on a person over a flat packshot.
Removed
  • autoDetectImageRoles.

1.1.0 (2026-05-14)

Added

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, url or multipart fileKey.
  • Multipart product images on /try-on and /products.
  • crop on upload.
  • useWatermark on /try-on and the Watermark feature.
  • productExternalId in /try-on responses.
  • 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.
Removed
  • PATCH /products/:externalId, GET /generations (list), generation ratings, resultImageKey, productId in 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/v1 until its announced end date.
Release updates: support@genlook.app.