Migrating from the alpha

​

What changed

​

Before and after

{
  "productId": "shirt-42",
  "customerImageId": "..."
}

{
  "products": [{ "externalId": "shirt-42" }],
  "person": { "image": { "source": { "id": "..." } } }
}

​

New behavior to know

• Products expire. Products created inline on /try-on are deleted after 15 unused days, one-shot products after 7. Products created with POST /products never expire. On PRODUCT_NOT_FOUND, resend the product inline.
• Inline products. /try-on can create or update the product in the same call. See Create Try-On.
• Crop control. crop=false on /images/upload keeps the original framing. The alpha always cropped.
• Multipart. Product and person images can be sent as bytes with fileKey.

​

Checklist

• /try-on body uses products and person (see above).
• imageUrls replaced by images: [{ source: { url } }].
• PATCH /products calls replaced by POST /products.
• Generation IDs stored from /try-on responses, no more GET /generations.
• Code reads externalId and resultImageUrl, not productId or resultImageKey.
• Error handling switches on code.
• PRODUCT_NOT_FOUND handled by resending the product inline.