Skip to main content
POST
Create Look

Authorizations

Authorization
string
header
required

Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.

Body

application/json
productIds
string[]
required

Ordered OmniCommerce product UUIDs to use as visual references. The first item is the primary product; the rest are reference products.

Required array length: 1 - 9 elements
organizationId
string

Optional for API-key requests; required for session-authenticated requests across multiple organizations.

Maximum string length: 120
title
string
Maximum string length: 160
subject
string

Scene subject such as model, table setting, shelf, desk setup, or free text.

Maximum string length: 120
style
string
Maximum string length: 120
season
string
Maximum string length: 80
timeOfDay
string
Maximum string length: 80
city
string
Maximum string length: 160
additionalNotes
string

Additional one-look styling guidance for the AI.

Maximum string length: 1000
model
string

Optional image model override. Looks default to the organization's configured image model and optimize for faster preview generation.

Maximum string length: 120

Response

Look record created and preview image generation queued.

ok
boolean
required
apiVersion
string
default:developer_v1
required
operationId
string
required
status
enum<string>
required
Available options:
accepted
jobId
string
required

Async look generation job ID. Look jobs use the look_ prefix.

data
object
required
warnings
string[]
recommendations
string[]