Sign in
edit-workflow

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

When true or omitted, the output is kept private to your account. Set to false to publish the output to the public feed. Enterprise accounts always generate privately.

webhook_urlstring uri

HTTPS URL that Ideogram delivers the generated result to. Ideogram sends a JSON POST to this URL once all images for the request have finished generating. The body mirrors the synchronous generate response: request_id, created, and a data array containing every generated image (url, prompt, resolution, seed, is_image_safe). Each delivery is signed with Ed25519 and verifiable against the public keys at https://api.ideogram.ai/v1/.well-known/jwks.json. Must be HTTPS; private and loopback hosts and the cloud metadata service are rejected.

Example request

{
  "aspect_ratio": "aspect_ratio",
  "private": true,
  "webhook_url": "https://api.example.com/webhooks/ideogram",
  "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"
}

Changes

Changed in 4 of the 34 revisions of this API.10

  • 987f73fc82de4See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 1429d75daa362See the full diff
    • ○

      added the media type application/json for the response with the status

      response-media-type-added

    • ○

      added the media type application/json for the response with the status

      response-media-type-added

  • 898026c78d683See the full diff
    • ○

      api tag edit-workflow added

      api-tag-added

    • ○

      api tag lookbook removed

      api-tag-removed

    • ○

      added the new optional request property

      new-optional-request-property

  • 73707bc35f341See the full diff
    • ○

      endpoint added

      endpoint-added