AI Virtual Staging API
& White Label Solution

Overview

This API allows users to request virtual staging transformations for property images. Requests are processed asynchronously; when the processing is complete, a webhook callback returns the final image.

Base URL

https://app.instantdeco.ai/********

Authentication

All requests must include an API key in the headers:

Authorization: Bearer YOUR_API_KEY

HTTP Method & Headers

HTTP Method: POST

Required Headers:

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Example Request Body (JSON)

{
  "design": "scandinavian",
  "room_type": "living_room",
  "transformation_type": "furnish",
  "block_element": "wall,floor,ceiling,windowpane,door",
  "high_details_resolution": true,
  "img_url": "https://example.com/image.jpg",
  "webhook_url": "https://your-webhook.com",
  "num_images": 2
}

Possible Values

Design

modern, scandinavian, industrial, bohemian, french, midcentury, 
coastal, rustic, artdeco, minimalist

Swimming pool

rectangular, oval, circular, natural, greek, mediterranean, 
modern, tropical 

Transformation Type

furnish     (Adds furniture without modifying the original picture: blocked elements remain unchanged)

renovate    (For empty rooms needing renovation; applies an extra AI model to enhance the result)

redesign    (For rooms that already have furniture (kitchen or bathroom); retains layout while applying a new design)

outdoor     (Adds furniture to outdoor pictures for terrace, pergola or swimming pool)

blue_sky    (Enhances lighting and adds a blue sky effect)

day_to_dusk   (Darkens the image, turns on interior lights, and changes the sky to dusk)

empty         (Removes all furniture from the room)


enhance         (Improve lighting and details of the picture)
      

Room Type

bathroom, bedroom, dining_room, home_office, kid_bedroom, 
kitchen, living_room, shower, pool, terrace, pergola

Block Elements

⚠️ Works only with furnish, redesign and outdoor transformation types.

All the elements mentioned here won't be modified by the AI

High Details Resolution

⚠️ Works only with furnish, renovate, and redesign transformation types.

Recommended for low-resolution images; slightly adjusts even the blocked elements for improved clarity.

Number of images

⚠️ Works only with furnish, renovate, redesign and outdoor transformation types.

Maximum value: 4. Correspond to the number of images returned in one request

Example Responses

Initial Request Response

{
  "status": "success",
  "response": {
    "status": "success",
    "message": "Request initiated successfully",
    "request_id": "8e5d1817-8e5b-4426-8e3c-c2884489b3d2-u1"
  }
}

Webhook Completion Response

{
  "output": "https://ai-result.png",
  "status": "succeeded",
  "request_id": "8e5d1817-8e5b-4426-8e3c-c2884489b3d2-u1"
}

Notes

• The webhook returns the processed image as a link.
• Ensure the API key is included in the Authorization header.
• Use a valid image URL to avoid errors.
• Transformation type guidelines:
  • furnish – Best for adding furniture only (keeps block elements unchanged).
  • renovate – Ideal for rooms needing significant work; an extra AI model is applied.
  • redesign – For rooms with existing furniture; retains layout while applying a new design.