latestOpenAPI 3.0.22026-08-19125272497.5 KB

73707bc35f34

lookbook

Create a fashion lookbook

Creates polished fashion product imagery from one or more product references and an aesthetic reference. Each generated shoot is returned as four individual lookbook images.

The request is processed asynchronously. Poll GET /v1/generations/{generation_id} with the returned generation_id until the generation is completed or failed.

post/v2/workflow/lookbook

Request body

category'dresses' | 'jeans' | 'pants' | 'tops' required

Selects the category-specific Lookbook presentation reference.

aspect_ratiostring

The aspect ratio of each generated 2x2 composite before it is split into images. Defaults to 1:1 when omitted. Supported values are 1:1, 3:4, and 9:16.

num_shootsinteger

Number of four-image lookbook shoots to create.

privateboolean

If true, the user is requesting private generation. If omitted, this defaults to the user's plan entitlement. Enterprise generations are always private.

Example request

{
  "aspect_ratio": "aspect_ratio",
  "private": true,
  "category": "dresses",
  "num_shoots": 1,
  "product_asset_identifiers": [
    {
      "asset_type": "RESPONSE",
      "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
    },
    {
      "asset_type": "RESPONSE",
      "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
    },
    {
      "asset_type": "RESPONSE",
      "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
    },
    {
      "asset_type": "RESPONSE",
      "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
    },
    {
      "asset_type": "RESPONSE",
      "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
    }
  ]
}

Response

Lookbook accepted for asynchronous processing.

generation_idstring required

URL-safe base64 ID accepted by the generation polling endpoint.

Example response

{
  "generation_id": "generation_id"
}