> ## 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.

# Quickstart

> Stage your first image in under 2 minutes

# Quickstart

Get a staged image in three steps.

## Step 1: Get an API Key

<Steps>
  <Step title="Create an account">
    Sign up at [studio.stagingspaces.app](https://studio.stagingspaces.app) with Google or email.
  </Step>

  <Step title="Generate a key">
    Go to **Settings → API** and click **Generate API Key**.

    You'll receive 10 free credits (\$10 value) on your first key.

    <Warning>
      Save your API key immediately — it's only shown once.
    </Warning>
  </Step>
</Steps>

## Step 2: Stage an Image

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://stagingspaces-production-6fb7.up.railway.app/api/v1/stage \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -F "image=@empty_room.jpg" \
    -F "style=modern"
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://stagingspaces-production-6fb7.up.railway.app/api/v1/stage",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      files={"image": open("empty_room.jpg", "rb")},
      data={"style": "modern"}
  )

  result = response.json()
  print(f"Staged image: {result['image_url']}")
  print(f"Claim code: {result['claim_code']}")
  ```

  ```javascript JavaScript theme={null}
  const form = new FormData();
  form.append('image', fs.createReadStream('empty_room.jpg'));
  form.append('style', 'modern');

  const response = await fetch(
    'https://stagingspaces-production-6fb7.up.railway.app/api/v1/stage',
    {
      method: 'POST',
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
      body: form,
    }
  );

  const result = await response.json();
  console.log(`Staged: ${result.image_url}`);
  ```
</CodeGroup>

## Step 3: Get Your Result

The response includes everything you need:

```json theme={null}
{
  "success": true,
  "image_url": "https://storage.googleapis.com/.../staged_modern.jpg",
  "image_id": 4521,
  "claim_code": "SS-7X9K2M",
  "claim_code_expires": "2026-04-24T12:00:00Z",
  "credits_used": 1,
  "credits_remaining": 9,
  "room_type": "living_room",
  "style": "modern"
}
```

<Check>
  **That's it!** You've staged your first image.
</Check>

## What's Next?

<CardGroup cols={2}>
  <Card title="Try all 9 styles" icon="palette" href="/concepts/styles">
    From scandinavian to eclectic glamour
  </Card>

  <Card title="Enhance to 4K" icon="up-right-and-down-left-from-center" href="/api-reference/staging/enhance-image">
    Photorealistic upscaling
  </Card>

  <Card title="Set up webhooks" icon="bell" href="/guides/webhook-integration">
    Get notified when staging completes
  </Card>

  <Card title="Batch staging" icon="layer-group" href="/guides/batch-staging">
    Stage multiple rooms at once
  </Card>
</CardGroup>