Ai Floor Planner

---

TL;DR

• Input: One text prompt (floor plan description)
• Output: Floor plan image URL + metadata + AutoCAD commands
• Use it for: Architecture, real estate, interior design, automation, construction
• Result time: Usually 1–2 minutes (generation is done by external API)

---

Table of contents

• Try it now
• Overview
• Usage examples
• Features
• Configuration
• Usage
• Output
• For bloggers & tutorial writers
• Grow your user base
• Integration
• Technical details
• FAQ
• Resources

---

Try it now

Action	Link
Run in Apify Console	Open Actor → Start
API (sync)	POST https://api.apify.com/v2/acts/YOUR_USERNAME~ai-floor-planner/run-sync

Replace YOUR_USERNAME with your Apify username.

---

Overview

The AI Floor Planner creates floor plans from plain text using the MultipleWords floor plan generation API. You describe the layout, rooms, and style; the Actor returns a generated floor plan image URL, structured metadata, and AutoCAD commands for technical implementation.

This Actor is useful when you need floor plans on demand, at scale, or as part of an automated workflow.

Common use cases

Category	Examples
Architecture & design	Rapid prototyping, layout variations, residential/commercial plans
Real estate	Property listings, virtual staging, renovation proposals
Interior design	Furniture layouts, space planning, client presentations
Development & automation	Batch generation, API integration, automated documentation
Construction & planning	Initial concepts, approval alternatives, technical drawings

Note: Usage rights depend on the upstream API and your Apify plan. Review terms before commercial use.

---

Usage examples

Paste these into the Prompt field or API input.

Scenario	Prompt
Small apartment	Generate a simple 2-bedroom apartment with a living room, kitchen, and bathroom.
Modern house	Modern 3-bedroom house with open-plan kitchen and living area, two bathrooms, and a home office.
Studio	Create a floor plan for a small studio apartment with a kitchenette and bathroom.
Commercial	Office layout with open workspace, 4 meeting rooms, and reception area.
Renovation	2-bedroom flat with separate kitchen, combined living-dining, and one bathroom.

---

Features

• Text-to-floor-plan generation from a single prompt
• Clean JSON output with image URL, metadata, and AutoCAD commands
• Works in bulk via API or standby HTTP mode
• Input validation and retries with exponential backoff
• Runs fully on Apify (Console, API, automation tools)
• Dataset views: overview table and detailed view for easy reading in Output tab

---

Configuration

All settings are provided via the Actor input.

Input parameters

Parameter	Type	Required	Default	Description
prompt	string	Yes	—	Text description of the floor plan to generate

Prompt tips

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

Example input

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

---

Usage

Apify Console

1. Open the Actor in Apify Console.
2. Enter a prompt in the Prompt field (or use the default).
3. Click Start and check the Output tab for the floor plan URL, metadata, and AutoCAD commands.

API (run-sync)

Replace YOUR_USERNAME with your Apify username and YOUR_API_TOKEN with your Apify API token.

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~ai-floor-planner/run-sync?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Generate a simple 2-bedroom apartment with a living room, kitchen, and bathroom."}'

Response includes runId, status, and dataset items with imageUrl, imageLink, details (including autocadCommands, summary, originalPrompt), and timestamp.

---

Output

Each run writes one or more items to the default dataset. The Output tab shows organized views (overview and detailed) thanks to the output schema. Each item looks like:

Field	Description
status	Success indicator (1 = success)
imageUrl	Direct URL of the generated floor plan image
imageLink	Same URL for link display in Console
details	Full API response (id, timestamps, engine, originalPrompt, detailedDescription, autocadCommands, summary, etc.)
timestamp	ISO timestamp when the result was saved

Example output (dataset item)

{
  "status": 1,
  "imageUrl": "https://example.com/floor-plans/generated.png",
  "imageLink": "https://example.com/floor-plans/generated.png",
  "details": {
    "id": 506170,
    "imageUrl": "https://example.com/floor-plans/generated.png",
    "imageDescription": "2-bedroom apartment floor plan",
    "imageName": "floor plan generation",
    "imageCreatedAt": "2026-01-23T12:55:52.106684Z",
    "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..."
  },
  "timestamp": "2026-01-23T12:55:52.000Z"
}

In the Apify Console Output tab you can open Floor Plan Image or Image Link and copy the URL for use in listings, CAD tools, or automation.

---

For bloggers & tutorial writers

You can use this Actor in tutorials, blog posts, or videos without running it first:

• Input: Use the Example input or Usage examples table.
• Output: Use the Example output above to show what users get.
• API: Use the API (run-sync) curl example; remind readers to replace YOUR_USERNAME and YOUR_API_TOKEN.

For promotion ideas, copy-paste posts, and where to share, see PROMOTION.md in this repo.

---

Grow your user base

Promote your Actor to reach more users. Share it where your audience is active:

Action	Where
Share	Relevant communities, forums, and social media (e.g. Apify Discord, Reddit r/architecture, r/RealEstate, LinkedIn)
Content	Blog posts, tutorials, or videos showing use cases (e.g. "From text to floor plan in 5 minutes", Make/Zapier automation)
Store visibility	Keep actor.json strong: title, description, and readme affect how you appear in the Apify Store and search

Quick links: Copy-paste posts, channels, and a weekly checklist → PROMOTION.md.

---

Integration

• Make (Integromat) — Use the Apify module and select this Actor; map your prompt to the Prompt input.
• Zapier — Use the Apify Zapier app and choose "Run Actor"; select this Actor and pass the prompt.
• Custom apps — Call the Apify API (/run or /run-sync) with the same input JSON.

---

Technical details

• Runtime: Node.js (see Dockerfile).
• Input: Validated against the input schema; invalid input returns a clear error.
• External API: Uses MultipleWords floor plan API (prompt_to_autocad); failures are retried with exponential backoff.
• Output schema: Defined in .actor/output_schema.json so the Output tab shows organized tables and links.

---

FAQ

How long does a run take?
Usually 1–2 minutes for a single prompt; the external API performs the actual generation.

Can I run multiple prompts in one go?
Yes. Send one prompt per run, or trigger multiple runs via API or automation tools for batch generation.

Where is the image stored?
The image is hosted by the upstream API. The Actor returns the URL; you can download or hotlink it.

Do I need an API key for the floor plan API?
The Actor uses its own integration; you only need your Apify account and (for API calls) your Apify API token.

What is the output schema?
The output schema defines how results appear in the Apify Console Output tab (overview table, detailed view, full dataset), so users see clear field names and types instead of raw JSON.

---

Resources

• Apify Console — Run the Actor and view datasets
• Apify API — Run actors programmatically
• Actor output schema — Define and present Actor output
• PROMOTION.md — How to promote this Actor and grow your user base