Reuse products and people - bitStudio

An asset groups reusable references for a product, avatar, or scene. A product with front and back photos is one outfit asset, not two try-on items.

1. Create the product

curl https://api.bitstudio.ai/v1/assets \
  -H "Authorization: Bearer $BITSTUDIO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"type":"outfit","alias":"White linen shirt","sku":"SHIRT-001"}'

Save the returned asset id.

2. Add its photos

curl "https://api.bitstudio.ai/v1/assets/$ASSET_ID/images" \
  -H "Authorization: Bearer $BITSTUDIO_API_KEY" \
  -F 'type=outfit' \
  -F '[email protected]'

Repeat for additional useful views of this same product. An asset needs actual reference images; setting display_image alone only supplies a thumbnail.

3. Use it in try-on

Send this body to POST /v1/images/virtual-try-on, replacing the IDs with your person image and outfit asset:

{
  "person_image_id": "11111111-1111-4111-8111-111111111111",
  "outfit_asset_ids": ["22222222-2222-4222-8222-222222222222"]
}

Add up to four outfit asset IDs to dress the person in multiple items with V6. Saved avatar or preset references for image generation go in asset_ids on /v1/images/generate. Store asset IDs in your own catalogue alongside product identifiers. Metadata and photos can be read through the asset reference.