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.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.