Smart Room Composer

Fill empty rooms with your own furniture. Smart Room Composer intelligently arranges everything for a seamless and balanced design.

ENDPOINT

POST /smart_room_composer

An API URL would be like https://homedesigns.ai/api/v2/smart_room_composer

Use the smart_room_composer endpoint to automatically arrange furniture and decor, creating a perfectly balanced and visually appealing room layout.

Request

An API request must be in the form-data format.

Request

Parameters & Data Type	Value	Description
room_image file[ .jpg, .jpeg, .png] / base64 Image string	Input allows images, via file or Base64.	The image to be processed by the API. The image dimensions must be 512x512 pixels or greater for optimal results. (Required Parameter)
furniture_images[] file[ .jpg, .jpeg, .png] / base64 Image string	Input allows a minimum of 1 and a maximum of 4 images, via file or Base64.	Choose furniture images such as a sofa, table, or chair. Add up to 4 items to create your design. The image dimensions must be 512x512 pixels or greater for optimal results. (Required Parameter)
additional_instructions		Providing instructions is optional. You can guide furniture placement within the room. This improves the final design output.

Errors

Parameters & Errors

room_image

Error Messages	Reason
Room image field required	Image not provided
Invalid image size. The image width and height must be 512x512 or greater than 512x512 pixels.	Image Size Not Proper.
Invalid image format. Only PNG, JPEG and JPG images are allowed.	Image Format not valid.

furniture_images[]

Error Messages	Reason
Furniture image field required	Furniture image not provided
Invalid image size. The image width and height must be 512x512 or greater than 512x512 pixels.	Furniture image Size Not Proper.
Invalid image format. Only PNG, JPEG and JPG images are allowed.	Image Format not valid.

status_check

Error Messages	Reason
Please Enter a Valid Queue ID	Invalid queue ID.

Response

//Output should be in list of array depends on no of designs as shown below:

{
    "success": {
        "original_image": "https://storage.googleapis.com/generativeartbucket/UserGenerations/cristian/input-7b7e9196-79d3-41cf-adad-00964eb17632-2026-04-27-10-53-20.png",
        "generated_image": [
            "https://storage.googleapis.com/generativeartbucket/UserGenerations/cristian/output-7b7e9196-79d3-41cf-adad-00964eb17632-2026-04-27-10-53-20-1.png"
        ]
    }
}

Process for Using /smart_room_composer and /smart_room_composer/status_check Endpoints

GET https://homedesigns.ai/api/v2/smart_room_composer/status_check/ag61df25b20-e263-4bae-vbgbae8-ecccaafgbbd687-ugf1

1. Step 1: Pass Required Parameters to /smart_room_composer

   • When you send a request to the /smart_room_composerendpoint with all required parameters, it will generate a queue_id.

   • Example response from /smart_room_composer:

     {
         "id": "ag61df25b20-e263-4bae-vbgbae8-ecccaafgbbd687-ugf1",
         "status": "IN_QUEUE"
     }

   • The queue_id (id value) from this response will be used in subsequent requests.

---

1. Step 2: Use queue_id in /smart_room_composer/status_checkEndpoint

   • Append the generated queue_id to the /smart_room_composer/status_checkendpoint to check the processing status.

   • Example request:

     GET /smart_room_composer/status_check/ag61df25b20-e263-4bae-vbgbae8-ecccaafgbbd687-ugf1

---

1. Step 3: Review the Status Response

   • The /smart_room_composer/status_check endpoint will return the current status of the process. Initially, the status might indicate that the process is still in "starting" wait a few moments and send the request again.

   • Example response:

     {
         "created_at": "2025-05-26T12:39:19.094Z",
         "status": "starting"
     }

   • If the status is still pending "processing", wait a few moments and send the request again.

   • Example response:

   • {
         "created_at": "2026-03-31T09:54:38.303Z",
         "started_at": "2026-03-31T09:54:38.322847005Z",
         "status": "processing"
     }

   • Once all the statuses marked as IN_QUEUE , starting and processing are completed, after hitting the requests one by one, you will see the results as follows:

     //Output should be in list of array depends on no of designs as shown below:
     
     {
         "success": {
             "original_image": "https://storage.googleapis.com/generativeartbucket/UserGenerations/cristian/input-7b7e9196-79d3-41cf-adad-00964eb17632-2026-04-27-10-53-20.png",
             "generated_image": [
                 "https://storage.googleapis.com/generativeartbucket/UserGenerations/cristian/output-7b7e9196-79d3-41cf-adad-00964eb17632-2026-04-27-10-53-20-1.png"
             ]
         }
     }

---

1. Step 4: Get the Final Result

   • Continue checking the status by re sending the request to the /smart_room_composer/status_check endpoint until the status changes to "SUCCESS".

   • When the status is "SUCCESS", you will receive the final result in the response.