RoomVisualization

A room visualization. The same shape is returned on creation, by polling and in the history list.

bestEffort
Type: boolean

True when the result was accepted although not every product could be verified in the image
createdAt
Type: stringFormat: date-time

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
error
Type: object | null

Set when status is failed

Properties: 2
id
Type: stringFormat: uuid

Visualization ID. Use it to poll for the result.
preparedRoomImageUrl
Type: string | nullFormat: uri

The emptied room photo the products were placed into. Null without a photo, or until cleanup has finished.
products
Type:

Products placed in the room. With styles this is empty until the products are chosen; with productIds it is filled from creation.

Properties: 11
resultImageUrl
Type: string | nullFormat: uri

The furnished room. Null until the job completes.
roomImageUrl
Type: string | nullFormat: uri

The stored room photo. Null when the room was created without a photo.
roomType
Type: enumnullable
values
living-roombedroomdining-roomkitchenbathroomoffice
selection
Type: object | null

Why these products were chosen. Only for styles requests.

Properties: 2
status
Type: stringenum
values
queuedprocessingcompletedfailed
step
Type: string | nullenum

The step the job is in. null until the first step starts; after the job has finished or failed, it keeps the last step reached (finish for completed jobs). cleanup only happens for a room photo.

values
preparecleanuparrangefurnishfinish
styles
Type: array of string

The one or two styles used, sorted alphabetically. Empty when the request used productIds.
updatedAt
Type: stringFormat: date-time

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

Examples

{
  "id": "0b9f3c52-6f1e-4c63-9a77-3f5a2d1c8e10",
  "status": "completed",
  "step": "finish",
  "roomType": "living-room",
  "styles": [
    "modern",
    "scandinavian"
  ],
  "roomImageUrl": null,
  "preparedRoomImageUrl": null,
  "resultImageUrl": "https://cdn.youzu.ai/generated/0b9f3c52.jpg",
  "products": [
    {
      "index": 0,
      "productId": "sofa-123",
      "variantId": "sofa-123-grey",
      "sku": "SOFA-123-GR",
      "name": "Three-seater sofa, grey",
      "imageUrl": "https://cdn.example.com/sofa-123.jpg",
      "url": "https://shop.example.com/products/sofa-123",
      "price": {
        "amount": 899,
        "currency": "EUR"
      },
      "dimensions": {
        "widthCm": 220,
        "heightCm": 85,
        "lengthCm": 95
      },
      "category": "sofa",
      "box": {
        "x1": 18.5,
        "y1": 52.1,
        "x2": 61.2,
        "y2": 81.7
      }
    }
  ],
  "selection": {
    "rationale": "A light grey sofa and oak coffee table anchor the seating area.",
    "warnings": []
  },
  "bestEffort": false,
  "error": null,
  "createdAt": "2026-10-30T09:12:44.000Z",
  "updatedAt": "2026-10-30T09:13:58.000Z"
}

RoomVisualizationProduct

RoomVisualizationRoomType