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/api/1.1/wf/request_v2Copy

Authentication

All requests must include an API key in the headers:

Authorization: Bearer YOUR_API_KEYCopy

HTTP Method & Headers

HTTP Method: POST

Required Headers:

Content-Type: application/json
Authorization: Bearer YOUR_API_KEYCopy

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
}Copy

Possible Values

Design

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

Swimming pool

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

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)
      Copy

Room Type

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

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"
  }
}Copy

Webhook Completion Response

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

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.