> ## Documentation Index
> Fetch the complete documentation index at: https://docs.palazzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Analyze Multiple Images for Stageability

## Overview

Analyzes multiple images (up to 10) to determine if they are suitable for virtual staging. This endpoint provides detailed analysis for each image including room type detection, confidence scores, and a comprehensive summary of all analyzed images.

## Authentication

This endpoint requires Bearer token authentication. Include your API key in the Authorization header.

## Request Body

<ParamField body="imageUrls" type="string[]" required>
  Array of image URLs to analyze. Maximum of 10 images per request.
</ParamField>

## Response

The response includes detailed analysis for each image and an overall summary.

### Image Analysis Object

<ResponseField name="images" type="array">
  Array of individual image analysis results.

  <Expandable title="Image Object Properties">
    <ResponseField name="isStageable" type="boolean">
      Indicates whether the image is suitable for virtual staging.
    </ResponseField>

    <ResponseField name="roomType" type="string">
      Detected room type (e.g., "living\_room", "bedroom", "kitchen").
    </ResponseField>

    <ResponseField name="confidence" type="number">
      Confidence score for the analysis (0-1 scale).
    </ResponseField>

    <ResponseField name="details" type="string">
      Additional details about the analysis result.
    </ResponseField>

    <ResponseField name="imageUrl" type="string">
      The URL of the analyzed image.
    </ResponseField>
  </Expandable>
</ResponseField>

### Summary Object

<ResponseField name="summary" type="object">
  Overall summary of the batch analysis.

  <Expandable title="Summary Properties">
    <ResponseField name="totalImages" type="number">
      Total number of images analyzed.
    </ResponseField>

    <ResponseField name="stageableImages" type="number">
      Number of images suitable for staging.
    </ResponseField>

    <ResponseField name="nonStageableImages" type="number">
      Number of images not suitable for staging.
    </ResponseField>

    <ResponseField name="confidence" type="number">
      Average confidence score across all images.
    </ResponseField>

    <ResponseField name="roomTypes" type="string[]">
      List of unique room types detected across all images.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example Request

```bash theme={null}
curl -X 'POST' \
  'http://localhost:3001/analysis/stageability/multiple' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "imageUrls": [
    "https://example.com/image1.jpg"
  ]
}'
```

## Example Response

```json theme={null}
{
  "images": [
    {
      "isStageable": true,
      "roomType": "living_room",
      "confidence": 0.95,
      "details": "Clear room with good lighting",
      "imageUrl": "https://example.com/image1.jpg"
    }
  ],
  "summary": {
    "totalImages": 5,
    "stageableImages": 3,
    "nonStageableImages": 2,
    "confidence": 0.87,
    "roomTypes": [
      "living_room",
      "bedroom",
      "kitchen"
    ]
  }
}
```

## Error Responses

<ResponseExample>
  ```json 400 Bad Request theme={null}
  {
    "statusCode": 400,
    "message": "No images provided or more than 10 images",
    "error": "Bad Request"
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "statusCode": 401,
    "message": "Unauthorized - Invalid or missing authentication token",
    "error": "Unauthorized"
  }
  ```
</ResponseExample>

## Use Cases

* **Batch Image Validation**: Quickly validate multiple property images before processing
* **Quality Control**: Ensure images meet staging requirements
* **Room Classification**: Automatically categorize images by room type
* **Workflow Optimization**: Filter out unsuitable images early in the pipeline