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

# Introduction

> AI-powered virtual staging API for real estate

# StagingSpaces API

Stage empty rooms with photorealistic furniture in seconds. Built for real estate platforms, property listing sites, and staging companies.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Stage your first image in under 2 minutes
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Complete endpoint documentation
  </Card>

  <Card title="Examples" icon="rectangle-terminal" href="/examples/python">
    Code examples in Python, JavaScript, and cURL
  </Card>

  <Card title="AI Agent Guide" icon="robot" href="/guides/using-with-ai-agents">
    Use with Claude, GPT, or any AI agent
  </Card>
</CardGroup>

## What You Can Do

| Feature               | Cost     | Description                                              |
| --------------------- | -------- | -------------------------------------------------------- |
| **Stage a room**      | 1 credit | Upload an empty room photo, get back a furnished version |
| **Choose styles**     | —        | 9 design styles from modern to farmhouse                 |
| **4K enhancement**    | 1 credit | Upscale to photorealistic 4096x3072                      |
| **Product placement** | Free     | Add branded furniture (you earn 50% of ad revenue)       |
| **Claim codes**       | —        | Transfer staged images to agent dashboards               |
| **Webhooks**          | —        | Get notified when staging completes                      |

## How It Works

```mermaid theme={null}
sequenceDiagram
    participant You as Your App
    participant SS as StagingSpaces API
    participant Agent as Estate Agent

    You->>SS: POST /api/v1/stage (image + style)
    SS-->>You: staged image URL + claim code
    You->>Agent: Share claim code "SS-7X9K2M"
    Agent->>SS: Redeem claim code
    SS-->>Agent: Images appear in dashboard
```

## Pricing

* **1 credit = \$1** (volume discounts available)
* **10 free credits** on first API key creation
* Auto top-up available to avoid interruptions
* Contact [sales@stagingspaces.app](mailto:sales@stagingspaces.app) for enterprise pricing