Real Estate Photo API

Universal SDK for real estate photo enhancement - compatible with multiple providers. Drop-in replacement for common real estate AI APIs.

Installation

npm install real-estate-photo-api

Quick Start

import { RealEstatePhotoAPI } from 'real-estate-photo-api';

const api = new RealEstatePhotoAPI('your-api-key');

// Enhance a photo
const result = await api.enhance({
  imageUrl: 'https://example.com/room.jpg'
});

// Virtual staging
const staged = await api.furnish({
  imageUrl: 'https://example.com/empty-room.jpg',
  roomType: 'living-room',
  style: 'modern'
});

// Remove furniture
const empty = await api.empty_room({
  imageUrl: 'https://example.com/furnished-room.jpg'
});

Migration Guide

Switching from another real estate photo API? This SDK uses identical method names and parameters as common providers. Migration takes 2 minutes:

Step 1: Install the package

npm install real-estate-photo-api

Step 2: Replace your API calls

Before (direct fetch calls):

const response = await fetch('https://other-api.com/api/furnish', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apiKey: 'old-api-key',
    imageUrl: 'https://example.com/room.jpg',
    roomType: 'bedroom',
    style: 'modern',
    creativity: 'High'
  })
});
const result = await response.json();

After (this SDK):

import { RealEstatePhotoAPI } from 'real-estate-photo-api';

const api = new RealEstatePhotoAPI('your-new-api-key');

const result = await api.furnish({
  imageUrl: 'https://example.com/room.jpg',
  roomType: 'bedroom',
  style: 'modern',
  creativity: 'High'
});

Step 3: That's it!

All method names and parameters are compatible:

| Your existing code | Works with this SDK | |-------------------|---------------------| | furnish({ imageUrl, roomType, style }) | ✅ | | empty_room({ imageUrl }) | ✅ | | enhance({ imageUrl }) | ✅ | | renovation({ imageUrl, roomType, style, furnish }) | ✅ | | sky_blue({ imageUrl }) | ✅ | | edit_via_prompt({ imageUrl, prompt }) | ✅ | | remove_object({ imageUrl, maskUrl }) | ✅ | | blur({ imageUrl, objectsToBlur }) | ✅ | | create_video({ images, ... }) | ✅ |

Available Methods

| Method | Description | Response Time | |--------|-------------|---------------| | enhance() | Enhance quality, color, light and resolution | ~10s | | empty_room() | Remove furniture and clutter | ~15s | | furnish() | Add furniture to empty rooms (virtual staging) | ~20s | | renovation() | Renovate and restyle a room | ~20s | | sky_blue() | Make sky blue and vibrant | ~10s | | edit_via_prompt() | Edit using natural language | ~15s | | remove_object() | Remove objects with mask | ~10s | | blur() | Blur objects for privacy | ~10s | | create_video() | Create video from images | 2-5min |

Method Parameters

enhance / empty_room / sky_blue

{
  imageUrl: string;  // Image URL (https) or base64 data URI
}

furnish

{
  imageUrl: string;
  roomType: string;  // 'living-room', 'bedroom', 'kitchen', 'bathroom', 'dining-room', 'office'
  style: string;     // 'modern', 'scandinavian', 'minimalist', 'traditional', 'industrial', 'bohemian', 'mid-century', 'mediterranean'
  creativity?: 'Medium' | 'High';
}

renovation

{
  imageUrl: string;
  roomType: string;
  style: string;
  creativity?: 'Medium' | 'High';
  furnish?: boolean;  // Include furniture in renovation
}

edit_via_prompt

{
  imageUrl: string;
  prompt: string;  // Natural language instruction, e.g., "make the walls white"
}

remove_object

{
  imageUrl: string;
  maskUrl: string;  // Black/white mask image URL
}

blur

{
  imageUrl: string;
  objectsToBlur: string;  // Comma-separated: "faces, license plates, screens"
}

create_video

{
  images: Array<{
    imageUrl: string;
    effect?: 'zoom-in' | 'zoom-out' | 'transition';
    subtitle?: string;
    title?: string;
  }>;
  isVertical?: boolean;  // false = 16:9, true = 9:16
  music?: {
    enabled: boolean;
    track?: 'calm' | 'uplifting' | 'corporate' | 'piano'
  };
  endingTitle?: string;
  endingSubtitle?: string;
}

Why Switch?

• Faster processing - Most operations complete in under 15 seconds
• Better quality - State-of-the-art AI models
• Lower pricing - Competitive rates with volume discounts
• Same API - No code changes required

Get an API Key

Get your API key at bright-shot.com

Support

• API Documentation
• Brightshot Website
• Email: [email protected]