# AI Home Tour Creator (`peaceful_pushpins/ai-home-tour-creator`) Actor Transform property photos into professional real estate video tours. AI analyzes, scores, selects, and enhances images before generating cinematic video clips and merging them into a complete property tour. Ideal for real estate agents, agencies, and property marketers. - **URL**: https://apify.com/peaceful_pushpins/ai-home-tour-creator.md - **Developed by:** [Wasim Safdar](https://apify.com/peaceful_pushpins) (community) - **Security:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $750.00 / 1,000 standard video generation attempts This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## 🏠 AI Home Tour Creator AI Home Tour Creator is an AI-powered tool designed to help **real estate** professionals and property owners prepare their properties for sale. It enhances, cleans up, and visually improves property images to make them more appealing to potential buyers. Beyond **image enhancement**, it transforms property photos into an **AI-generated virtual home tour** video, helping viewers explore a property through a more engaging visual experience. Whether you're a **real estate agent**, **homeowner**, or **apartment** owner, AI Home Tour Creator helps you present your property professionally, **attract potential buyers**, and make your property listings stand out. ### Intelligent AI-Powered Editing and Video Creation Instead of editing images individually, It takes a zip file. This tool than performs these tasks. - **Extact images from zip file.** - **Fetch user instructions from input such as "Property Type", "Transformation Level", "AI Editing Options", "Highlight Priority Areas", "Target Buyer", "Property Goal" and "Additional user intructions".** - **Performs AI Visual Analysis on each image using special AI agent. It combines user instructions with AI generated instructions.** - **Generate a zip file of enhanced images for user to download.** - **If user selects "Generated AI Video Tour", then it also generates an AI virtual tour of property using enhanced images.** - **If user selects "Generate AI Summary", then it generates HTML report of Property image analysis, AI enhancements, and home tour results.** ### πŸš€ AI Models for Tour Creation For AI tour video generation, it supports 2 qualities. - **Standard Video Tour** - **Luxury Video Tour** ### Actor's Input | Input | Type | Description | | ---------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `imageZipFile` | string | Upload a ZIP file containing images to edit (JPG, JPEG, PNG). Supports up to **12 images**. | | `noOfImages` | integer | Number of highest-quality images to process. Maximum 12 images allowed. | | `propertyType` | string | Select the type of property. Options: `"Apartment"`, `"House"`, `"Villa"`, `"Office"`, and `"Commercial Property"`. | | `transformationLevel` | string | Three transformation levels. Options include `"Light Touch"`, `"Moderate"`, and`"Complete Makeover"`. | | `allowedEdits` | array | What kind of editing you want to do? Select multiple options Example: `["Remove Clutter"]`, `["Remove Clutter","Enhance Image Quality", "Replace Furniture"]`, etc. | | `highlightAreas` | array | Select one or mulitple areas you wanted to highlight in the video. Example: `["Living Room"]`, `[Living Room, Kitchen, Exterior, Garden]`, etc. | | `targetAudience` | string | Select your target audience. Options: `"Families"`, `"Young Professionals"`, `"Luxury Buyers"`,`"Investors"` and `Vacation Rental Guests`. | | `propertyGoal` | string | Select the property goal for listing. Options: `"Sell Fast"`, `"Luxury Marketing"`, `"Rental Listing"`, and `"Airbnb Listing"`. | | `customInstructions` | string | Additional instructions for editing and video creation. | | `generateAIVideo` | boolean | Do you want to generate a Video Tour with edits?. `True` or `False`. | | `videoGenerationModel` | string | It supports 2 types of video quality `"Standard Video Tour"` and `Luxury Video Tour`. | | `videoStyle` | string | Select the style of the virtual tour video. Options: `"Luxury Real Estate"`, `"Cinematic"`, `"Modern Showcase"`, `"Drone Style"`, and `"Social Media Reel"`. | | `aspectRatio` | string | Select the aspect ratio for video generation. Example: `"9:16"` or `"16:9"`. Good for posting on social media such as Facebook, Instagram or TikTok. | | `aiSummary` | boolean | Generate an AI summary report in HTML of AI edits. | ### Actor's Output | Output | Type | Description | | --------------------- | ------------- | ------------------------------------------------------------------------------------------ | | `propertyType` | string | Selected property type. | | `propertyGoal` | string | Selected property goal. | | `targetAudience` | string | Selected target audience. | | `transformationLevel` | string | Selected transformation level. |\ | `videoStyle` | string | Selected video style. | | `videoGenerationModel`| string | Return the selected video generation model. | | `aspectRatio` | string | Return the selected aspect ratio for video generation. | | `generateAIVideo` | boolean | Return true, if selected. | | `aiSummary` | boolean | Return true, if selected. | | `totalImagesAnalyzed` | integer | Total number of images analyzed by AI. Maximum 12 images can be analyzed at one run. | | `totalImagesSelected` | integer | No of images user want to be selected for AI video generation and edits. | | `videoUrl` | string | Return the url of generated video. | | `enhancedImagesUrl` | string | Return the url of enhanced images. | | `htmlReportUrl` | string | Return the url of generated HTML summary report. | #### Example Inputs ```json { "aiSummary": true, "allowedEdits": [ "Enhance Image Quality", "Replace Furniture" ], "aspectRatio": "16:9", "customInstructions": "Please focus on highlighting living room and bathrooms", "generateAIVideo": true, "highlightAreas": [ "Living Room", "Garden", "Balcony" ], "imageZipFile": "https://api.apify.com/v2/key-value-stores/Piwhbn6IxsFf95FT0/records/HouseImages-01.zip", "noOfImages": 5, "propertyGoal": "Luxury Marketing", "propertyType": "House", "targetAudience": "Vacation Rental Guests", "transformationLevel": "Light Touch", "videoGenerationModel": "Standard", "videoStyle": "Drone Style" } ``` ### πŸ“Š Professional HTML Report The **AI Home Tour Creator** generates a detailed HTML report that provides a clear overview of the **property image analysis**, **AI enhancements**, and **generated results**. Instead of checking each image individually or reviewing Actor logs, you can use a single, organized report to understand what the AI analyzed and how it processed your property images. ### Key Benefits - **Original vs. Enhanced Images:** Compare original property photos with their AI-enhanced versions to see the visual improvements. - **AI Image Quality Scores:** Review average, highest, and lowest AI image quality scores to understand the quality assessment of the selected images. - **Detailed AI Analysis:** Explore room classifications, visual descriptions, quality factors, and AI reasoning for individual images. - **Editing Transparency:** Review the AI-recommended edits, final editing instructions, and prompts used to enhance each image. - **Generated Results in One Place:** Access the generated home tour video and enhanced-images ZIP file directly from the report when available. - **Convenient Documentation:** Keep a shareable HTML document containing image comparisons, analysis details, and links to the generated outputs. The HTML report is especially useful for real estate agents and property owners who want to review the AI's work, compare property images, and keep the results organized in one place. **Note:** The report is generated when you enable the Generate Summary option. ### πŸ’° Estimated Run Costs AI Home Tour Creator uses a transparent **Pay-Per-Event pricing model**. You only pay for the AI operations performed during your run. Your total cost depends on: - The number of uploaded images analyzed. - The number of images successfully edited. - The number of video generations requested. - The selected video generation tier (Basic or Luxury). - Whether an AI summary report is generated. #### Image Processing Costs | Event | Price | |---|---:| | AI Visual Analysis | **$0.10 / image** | | AI Image Editing | **$0.40 / image** | | AI Summary Report | **$1.00 / report** | #### Video Generation Costs Each video generation produces an 8-second clip. Multiple clips are merged into one final property tour. **Basic Tier** | Event | Price | |---|---:| | Video Generation Attempt | **$0.75 / clip** | | Successful Video Generation | **$2.75 / clip** | | **Total per successful clip** | **$3.50** | **Luxury Tier** | Event | Price | |---|---:| | Video Generation Attempt | **$2.00 / clip** | | Successful Video Generation | **$8.00 / clip** | | **Total per successful clip** | **$10.00** | **Failed Generation:** If the video generation API accepts a request but fails to produce a video, only the generation attempt fee is charged. #### Example Costs | Video Tier | 1 Successful Clip | 2 Successful Clips | 3 Successful Clips | |---|---:|---:|---:| | Basic | $3.50 | $7.00 | $10.50 | | Luxury | $10.00 | $20.00 | $30.00 | Image analysis, image editing, and optional summary report charges are additional. **Note:** Video charges are calculated per generated 8-second clip, not per final merged tour. Actual costs depend on the number of images processed and successful video generations. Pricing may change as AI provider costs are updated. ### πŸ“Έ Image Upload Guidelines To ensure the best editing quality, upload images that meet the following recommendations: - Use **high-resolution images** whenever possible. - Images should be **well-lit, sharp, and in focus**. - Avoid heavily compressed, blurry, or pixelated photos. - Upload images in **JPG, JPEG, or PNG** format. - Place all images inside a **single ZIP file** before uploading. - The actor supports **up to 1,000 images** in a single run. ### πŸ’Έ Payment Structure During the initial launch period (14 days), this Actor uses a **Pay-Per-Result (PPR)** pricing model. ### Workflow automation Integrate **AI Home Tour Creator** with any app and automate your workflow such as "Make" \[https://www.make.com/en], "Zapier" \[https://zapier.com/], "n8n" \[https://n8n.io/], etc." If you’re looking to weave this into a larger tech stack or automate your content pipeline, you can bypass the manual interface and interact with the **AI Bulk Image Editor** via the Apify API. ### Developer Integration You can get started quickly by installing the official client libraries for your preferred environment: Node.js: Add the apify-client package via NPM. Python: Grab the apify-client package from PyPI. Check this API documentation: \[https://docs.apify.com/api/v2] ### What kind of data can be collected? We do not collect any personal user data. All inputs, uploaded and generated images, and metadata belong to the user running the actor. Each user only has access to their own dataset. # Actor input Schema ## `imageZipFile` (type: `string`): Upload a ZIP file containing 6–18 property images (JPEG/PNG). The AI will analyze, enhance, and generate a virtual tour video. ## `noOfImages` (type: `integer`): Choose a number between 3 and 18. The AI will select the best images based on quality and relevance to the property type. If you select a specific number, the AI will prioritize selecting that many images for editing and inclusion in the virtual tour video. ## `propertyType` (type: `string`): Select the type of property you want to create a virtual tour for. ## `transformationLevel` (type: `string`): Select the level of transformation you want the AI to apply to the images. ## `allowedEdits` (type: `array`): Select one or more editing options. If empty, AI will choose the best edits based on the uploaded images and property type. If empty, AI will automatically apply the most suitable enhancements based on the property type and image quality. ## `highlightAreas` (type: `array`): Select the areas of the property you want the AI to prioritize when creating the virtual tour. If empty, AI will determine the best areas to highlight based on the uploaded images and property type. ## `targetAudience` (type: `string`): Select the target buyer for your property. This will help the AI tailor the virtual tour to appeal to the selected audience. ## `propertyGoal` (type: `string`): Select the primary goal for your property. This will help the AI focus on the most important aspects of the virtual tour to achieve your desired outcome. ## `customInstructions` (type: `string`): Provide any specific instructions or preferences for the AI to consider when creating the virtual tour. This can include details about the property's unique features, desired style, or any specific elements you want to highlight or avoid. ## `generateAIVideo` (type: `boolean`): Generate AI video clips according to video style for the selected property images. Additional charges apply per generated image. ## `videoGenerationModel` (type: `string`): Choose the AI model for generating cinematic real-estate video clips. ## `videoStyle` (type: `string`): Select the style of the virtual tour video. This will influence the overall look and feel of the video, including transitions, music, and pacing. ## `aspectRatio` (type: `string`): Select the aspect ratio for video generation ## `aiSummary` (type: `boolean`): If selected, it generates a lightweight summary of image selection, edits applied, and video structure. May increase processing time. Additional charges apply ## Actor input object example ```json { "imageZipFile": "https://api.apify.com/v2/key-value-stores/eMCiOHDBvbCdVhBy4/records/HouseImages-01.zip", "noOfImages": 3, "propertyType": "House", "transformationLevel": "Moderate", "allowedEdits": [ "Remove Clutter" ], "highlightAreas": [ "Living Room", "Kitchen", "Exterior" ], "targetAudience": "Investors", "propertyGoal": "Sell Fast", "customInstructions": "Please focus on highlighting the spacious living room and modern kitchen. Avoid making significant changes to the exterior of the property.", "generateAIVideo": true, "videoGenerationModel": "Standard", "videoStyle": "Luxury Real Estate", "aspectRatio": "9:16", "aiSummary": true } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "imageZipFile": "https://api.apify.com/v2/key-value-stores/eMCiOHDBvbCdVhBy4/records/HouseImages-01.zip", "videoGenerationModel": "Standard" }; // Run the Actor and wait for it to finish const run = await client.actor("peaceful_pushpins/ai-home-tour-creator").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "imageZipFile": "https://api.apify.com/v2/key-value-stores/eMCiOHDBvbCdVhBy4/records/HouseImages-01.zip", "videoGenerationModel": "Standard", } # Run the Actor and wait for it to finish run = client.actor("peaceful_pushpins/ai-home-tour-creator").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "imageZipFile": "https://api.apify.com/v2/key-value-stores/eMCiOHDBvbCdVhBy4/records/HouseImages-01.zip", "videoGenerationModel": "Standard" }' | apify call peaceful_pushpins/ai-home-tour-creator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,peaceful_pushpins/ai-home-tour-creator" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/tNel3AmOjbceShwK0/builds/olUDhDPK9lH4faTIF/openapi.json