---
title: "Create a fashion lookbook"
method: POST
path: "/v2/lookbook"
tags: ["lookbook"]
---

# Create a fashion lookbook

`POST /v2/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.

## Request body

- LookbookRequest
  - `product_asset_identifiers` AssetIdentifier[], required — Product images whose appearance must be preserved in the generated looks.
    - `asset_type` 'ASSET' | 'CANVAS_ASSET' | 'LAYERED_ASSET' | 'RESPONSE' | 'UPLOAD', required
    - `asset_id` string, required
  - `style_reference_asset_identifier` AssetIdentifier, required — An identifier for an ideogram asset.
    - `asset_type` 'ASSET' | 'CANVAS_ASSET' | 'LAYERED_ASSET' | 'RESPONSE' | 'UPLOAD', required
    - `asset_id` string, required
  - `category` 'dresses' | 'jeans' | 'pants' | 'tops', required — The product category used to tailor the lookbook presentation.
  - `aspect_ratio` string — 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_shoots` integer — Number of four-image lookbook shoots to create.
  - `private` boolean — If true, the user is requesting private generation. If omitted, this defaults to the user's plan entitlement. Enterprise generations are always private.

## Response `200`

Lookbook accepted for asynchronous processing.

- LookbookResponse — Acknowledgement that the Lookbook workflow was accepted. Poll `GET /v1/generations/{generation_id}` for status and results.
  - `generation_id` string, required — URL-safe base64 ID accepted by the generation polling endpoint.

## Other responses

- `400` — Invalid input provided.
- `401` — Unauthorized.
- `402` — Insufficient credits or quota.
- `403` — Not authorized to create a lookbook.
- `429` — Too many requests.

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/4918f84cbfd7/schema)