API v1 · Home builders
Virtual staging API for home builders
Sell new construction before it is furnished. Stage every room of an empty spec home or model unit programmatically, so buyers see a finished home the day it is photographed.
Free presigned uploads · 1 credit per staged room
# Your key, from the API dashboard. Never commit it.
export PICTASTIC_API_KEY="sk_live_..."
# Stage every room of an empty model home in one on-brand style.
# publicUrls and roomTypes are paired arrays you build after upload;
# valid roomType values are listed in the API reference.
for i in "${!publicUrls[@]}"; do
curl -X POST "https://app.pictastic.ai/api/v1/virtual-staging" \
-H "Authorization: Bearer $PICTASTIC_API_KEY" \
-H "Content-Type: application/json" \
-d "{ \"imageUrl\": \"${publicUrls[$i]}\", \"roomType\": \"${roomTypes[$i]}\", \"designStyle\": \"Modern\" }"
done
# Each call returns its own outputImageUrl — a finished model home to market.Overview
How do home builders use a virtual staging API?
Home builders use a virtual staging API to furnish photos of empty spec homes and model units programmatically, so new construction can be marketed as a finished home before anyone moves in. With Pictastic each room is one authenticated POST, so a whole model home can be staged in a single scripted pass.
How it works
Upload, call, collect
Image inputs live on Pictastic storage, so every job starts with a free presigned upload.
- 1
Get a presigned upload URL
Ask for as many slots as you need, then PUT your image bytes straight to storage. This call is free — no credits.
- 2
Call the endpoint you want
Pass the returned publicUrl as imageUrl. Staging, removal and upscaling all take the same input shape.
- 3
Read the output URL
The response carries outputImageUrl and a downloadUrl, plus a jobId you can re-fetch later from the jobs history.
Why developers pick it
Built for new construction
What a builder or new-home marketer evaluates staging on, stated as capabilities.
Sell before completion
Stage an empty spec home's photos so buyers see a furnished result while the home is still on the market unfurnished.
Every room, one pass
Loop staging over each room of a model home with its own roomType, so the whole home is marketed consistently from one script.
Reuse across identical plans
Builders repeat floor plans; apply the same style across matching rooms in every home you put up for sale.
1 credit, refunded on failure
You pay one credit per finished room from a shared balance, and any failed job is refunded automatically.
Part of one API
Home-builder staging runs on the virtual staging API
Staging, furniture removal and upscaling are all the same REST API — one key, one input shape, one credit balance. See the full API overview, or jump to a specific operation.
Virtual staging API for home builders FAQ
How do home builders use a virtual staging API?
Home builders use a virtual staging API to furnish photos of empty spec homes and model units programmatically, so new construction can be marketed as a finished home before anyone moves in. With Pictastic each room is one authenticated POST, so a whole model home can be staged in a single scripted pass.
Can I stage an empty new build before it is furnished?
Yes. As long as you have photos of the empty rooms, the staging endpoint furnishes them — no physical staging or model furniture required to market the home.
Can I stage exteriors as well as interior rooms?
The staging endpoint furnishes rooms; it also supports interior and exterior scenes via its style options. Full details of what each parameter accepts are in the API reference.
How much does it cost to stage a whole model home?
Each room is a flat 1 credit per successful image, from one shared balance, with free uploads and automatic refunds on failure — so a full home only bills for the rooms that come out.
Stage your first model home by API today
Create a key in the dashboard and stage an empty spec home in minutes.
Presigned uploads are free — you only spend credits on finished images.