AI Floor Planner Actor

An Apify Actor that generates custom floor plans using AI-powered floor plan generation technology. Simply provide a text description of the floor plan you want, and the Actor will create a professional floor plan image for you.

What This Tool Does

This Actor connects to the MultipleWords floor plan generation API to create custom floor plans based on text prompts. It accepts a descriptive prompt about the floor plan you want to generate, processes the request through the API, and returns a high-quality floor plan image along with detailed metadata including AutoCAD commands.

Key Features:

• 🏠 Generate floor plans from text descriptions
• 🚀 Fast and automated floor plan creation
• 📦 Structured output with image URLs and metadata
• 🔄 Reliable error handling and validation
• 📊 Complete generation details and timestamps
• 🛠️ AutoCAD commands included for technical implementation

Purpose & Use Cases

This tool is designed to help individuals, businesses, and developers automate floor plan creation for various purposes:

Architecture & Design

• Rapid floor plan prototyping for architectural projects
• Generate multiple layout variations for design exploration
• Create floor plans for residential and commercial spaces
• Quick visualization of space layouts and room arrangements

Real Estate

• Generate floor plans for property listings
• Create virtual staging layouts
• Design renovation proposals
• Visualize property layouts for marketing materials

Interior Design

• Plan furniture arrangements and room layouts
• Design space-efficient solutions
• Create multiple design variations for clients
• Generate floor plans for home staging

Development & Automation

• Integrate floor plan generation into automated workflows
• Batch generate floor plans for multiple projects
• Create floor plans programmatically via API integration
• Automate architectural documentation processes

Construction & Planning

• Quick initial floor plan concepts for construction projects
• Generate layout alternatives for planning approval
• Streamline the architectural design workflow
• Create technical drawings with AutoCAD commands

Input Parameters

The Actor requires the following input:

prompt (Required)

Type: String
Description: A text description of the floor plan you want to generate. Be as specific as possible about the design, layout, rooms, dimensions, or elements you want included.

Example: "Generate a simple 2-bedroom apartment with a living room, kitchen, and bathroom."

Best Practices:

• Include specific details about room types and count (bedrooms, bathrooms, kitchen, etc.)
• Mention layout preferences (open concept, separate rooms, etc.)
• Specify approximate dimensions if you have requirements
• Describe the intended use case (residential, commercial, office, etc.)
• Include any special requirements (accessibility, storage, etc.)

userId (Optional)

Type: Integer
Description: User identifier for the API request. Defaults to 1 if not provided.

isPro (Optional)

Type: Integer
Description: Pro version flag (0 = free, 1 = pro). Defaults to 0.

Output Structure

The Actor returns structured data containing the generated floor plan information:

{
  "status": 1,
  "details": {
    "id": 506170,
    "imageUrl": "https://demo.example.com/floor-plans/example-floor-plan.png",
    "imageDescription": "2-bedroom apartment floor plan",
    "imageName": "floor plan generation",
    "imageCreatedAt": "2026-01-23T12:55:52.106684Z",
    "imageUpdatedAt": "2026-01-23T12:55:52.106712Z",
    "engine": 21,
    "urlSlug": "",
    "sourceImageUrl": "",
    "rating": 0,
    "feedback": "",
    "jobKey": "0",
    "jobStatus": 0,
    "originalPrompt": "Generate a simple 2-bedroom apartment...",
    "detailedDescription": "Detailed floor plan description...",
    "autocadCommands": "LINE 0,0 100,0\nRECTANGLE 0,0 100,80...",
    "summary": "Floor plan summary...",
    "autocadCommandsAlt": "Alternative AutoCAD commands...",
    "extra6": "",
    "attempts": 3,
    "isPublic": true,
    "isIndexed": false,
    "isActive": true,
    "userId": 12763,
    "imageCategoryId": 17,
    "languageId": 49,
    "dreamboothsProjectId": 1,
    "dreamboothInferenceCategoryId": 4
  },
  "timestamp": "2026-01-23T12:55:52.000Z"
}

Output Fields Explained

• status: Success indicator (1 = success)
• details.imageUrl: Direct URL to download the generated floor plan image
• details.id: Unique identifier for the generated floor plan
• details.imageCreatedAt: Timestamp when the floor plan was created
• details.engine: AI engine used for generation
• details.jobStatus: Status of the generation job
• details.originalPrompt: Echo of your input prompt
• details.detailedDescription: Detailed description of the generated floor plan
• details.autocadCommands: AutoCAD commands for technical implementation
• details.summary: Summary of the floor plan design
• timestamp: Timestamp when the Actor processed the request

How to Use

Running Locally

1. Install dependencies:

$npm install

2. Run the Actor:

$apify run

3. Provide input when prompted, or create an input file in storage/key_value_stores/default/INPUT.json:

{
  "prompt": "Generate a modern 3-bedroom house with an open-plan kitchen and living area, two bathrooms, and a home office."
}

Deploy to Apify Platform

1. Login to Apify:

$apify login

2. Deploy the Actor:

$apify push

3. Run on Apify Console:

• Go to Actors -> My Actors
• Select your AI Floor Planner Actor
• Enter your prompt in the input form
• Click "Start" to generate your floor plan

Using via API

Once deployed, you can call the Actor via Apify API:

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~ai-floor-planner/run-sync" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create a floor plan for a small studio apartment with a kitchenette and bathroom"
  }'

Integration Examples

With Make (Integromat)

• Connect the Actor to your Make workflows
• Automatically generate floor plans when new projects are created
• Send generated floor plans to storage services or email
• Integrate with CRM systems for real estate workflows

With Zapier

• Trigger floor plan generation from form submissions
• Automatically add floor plans to Google Drive or Dropbox
• Send floor plan notifications via Slack or email
• Connect to real estate listing platforms

With Custom Applications

• Integrate via Apify API into your web applications
• Batch generate floor plans for multiple clients
• Create automated architectural workflows
• Build custom floor plan generation interfaces

Technical Details

• Runtime: Node.js 18+
• Dependencies: Apify SDK v3.5.2+
• API Endpoint: https://shorts.multiplewords.com/mwvideos/api/prompt_to_autocad
• Request Method: POST
• Content Type: application/x-www-form-urlencoded

Error Handling

The Actor includes comprehensive error handling:

• Validates input parameters before processing
• Handles API errors gracefully
• Provides detailed error messages in logs
• Returns appropriate exit codes for debugging

Resources

• Apify SDK Documentation
• Apify Platform Documentation
• Apify Academy - Node.js Tutorials
• Join Apify Developer Community

Support

For issues, questions, or feature requests, please refer to the Apify documentation or community forums.

---

Built with ❤️ using Apify SDK