API v1 · Photographers
Virtual staging API for photographers
Add virtual staging to your delivery as a paid upsell. Script it across a whole shoot, give each agent a few style options per room, and bill for every finished image.
Free presigned uploads · 1 credit per staged image
# Your key, from the API dashboard. Never commit it.
export PICTASTIC_API_KEY="sk_live_..."
# Offer the agent several looks for the same room in one pass.
# Valid roomType / designStyle values are listed in the API reference.
for style in "Modern" "Scandinavian" "Farmhouse"; 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\": \"$publicUrl\", \"roomType\": \"Living Room\", \"designStyle\": \"$style\" }"
done
# Each call returns its own outputImageUrl — deliver the set to your client.Overview
How do real estate photographers use a virtual staging API?
Real estate photographers use a virtual staging API to furnish, declutter, and upscale the photos they deliver — programmatically, across an entire shoot — instead of restaging one image at a time in an editor. With Pictastic each finished image is one authenticated POST, so staging becomes a scriptable, billable step in your delivery pipeline.
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 your delivery pipeline
What a photographer running volume actually needs from a staging step, stated as capabilities.
Stage a whole shoot in a loop
Request many free upload slots at once, then fire one staging call per photo — a full gallery stages without touching an editor.
Deliver style options
Run the same room through several designStyle values to hand each agent a choice of looks, each its own finished image.
Bill per finished image
Each successful stage is a flat 1 credit, so your upsell price minus one credit is your margin on every photo.
MLS-ready on delivery
Upscale finished shots 2× or 4× so what you hand over already meets MLS resolution rules.
Part of one API
Photographer 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 photographers FAQ
How do real estate photographers use a virtual staging API?
Real estate photographers use a virtual staging API to furnish, declutter, and upscale the photos they deliver — programmatically, across an entire shoot — instead of restaging one image at a time in an editor. With Pictastic each finished image is one authenticated POST, so staging becomes a scriptable, billable step in your delivery pipeline.
Can I offer staging as a paid add-on to my clients?
Yes. You call the API at a flat credit cost per image and set your own delivery price, so staging becomes a margin line in your packages. Billing is on your side; the API just returns finished images.
How do I stage an entire gallery at once?
Request several presigned upload URLs with the count parameter, PUT each photo to its slot, then loop one staging POST per image. Each returns its own jobId and outputImageUrl so you can track every shot.
Can I remove a client's existing furniture first?
Yes. Run the photo through the furniture removal endpoint to get empty walls, then stage that result — the two endpoints take the same input shape, so they chain with no re-upload.
Add staging to your delivery today
Create a key in the dashboard and script staging across your next shoot in minutes.
Presigned uploads are free — you only spend credits on finished images.