Virtual Staging API
Stage empty-room photos from your own tools: a listing system, a photo delivery pipeline or a script. Send one photo, get a staged photo back in about 30 seconds, for 1 credit — from $0.28 an image.
curl https://stagehq.ai/api/v1/stagings \
-H "Authorization: Bearer $STAGEHQ_API_KEY" \
-F [email protected] \
-F room_type="living room" \
-F style=japandi
# → 202 { "id": "…", "status": "processing", "status_url": "…" }How it works
Step 1
Create a key
Buy any credit pack, then open Account → Developers and create an API key.
Step 2
Send a photo
POST the photo with a room type and a style. The response gives you a job id.
Step 3
Get the result
Poll the job until it is completed, then download the staged image from result_url.
What you get
The studio engine
The same model and prompts as the StageHQ studio. In Precise mode, walls, floors, windows and fixtures stay as photographed.
32 room types, 35 styles
Living rooms to hotel lobbies, Modern to Japandi. Four modes: Precise, Creative, Renovation and Remove furniture.
Same credits, no subscription
Each staged image costs 1 credit, the same as in the studio. Credits never expire. A failed job refunds its credit.
Safe retries
Send an Idempotency-Key header and a retried request returns the first job instead of charging twice.
Want to see the output first? Browse before and after examples or compare credit packs.
API questions
How much does the virtual staging API cost?
1 credit per staged image, the same price as the studio: $19 for 20 images, $39 for 100, or $69 for 250 ($0.28 an image). There is no monthly fee and credits never expire.
Is there a free tier for the API?
No. API keys come with any credit pack. The 3 free credits on a new account work in the studio, so you can check the results before you buy.
How long does one image take?
About 30 seconds. The API answers right away with a job id; poll the job every 5 seconds until its status is completed or failed.
Do API results have a watermark?
No. API keys are for paid accounts, and paid accounts get the clean, full-resolution render.
Is there a rate limit?
12 stagings per minute per account, shared with the studio. A request over the limit gets HTTP 429 with a Retry-After header.
Can I call the API from a website or mobile app?
Call it from your server. The API key gives access to your credits, so it must not be in code that other people can open.
Try the engine before you write code.
Stage 3 photos free in the studio. When the results work for you, buy a pack and create a key.
No credit card required · 3 free images included