← PixelAPI · Real-estate staging · All docs · Pricing

Real-Estate Virtual Staging API

Furnish empty room photos and declutter listing photos through two REST endpoints. Staging keeps the walls, windows and camera angle of your photo and adds furniture in the style you choose.

Available operations: virtual staging (/v1/real-estate/stage) and declutter cleanup (/v1/real-estate/cleanup with cleanup_type=declutter). Sky replacement, day-to-dusk and perspective correction are not offered.

Pricing

OperationPriceNotes
Virtual staging200 credits per photo≈ $0.20 on Starter
Declutter cleanup12 credits per photoBilled as object removal. ≈ $0.012 on Starter

Failed jobs are refunded automatically.

POST/v1/real-estate/stage

Multipart form.

FieldTypeRequiredDescription
room_imagefileyesRoom photo (JPG/PNG/WEBP, max 20 MB). Works best on empty or sparsely furnished rooms.
room_typestringnoliving_room (default), bedroom, kitchen, bathroom, office, dining_room.
design_stylestringnoDefault modern_indian. One of: modern_indian, vastu_compliant, minimalist, scandinavian, industrial, bohemian, traditional_indian, kerala_style, rajasthani_luxury, contemporary.
color_schemestringnoOptional colour preference, e.g. warm neutrals, gold accents.

Example

curl -X POST https://api.pixelapi.dev/v1/real-estate/stage \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "room_image=@empty_living_room.jpg" \
  -F "room_type=living_room" \
  -F "design_style=scandinavian" \
  -F "color_scheme=warm neutrals"

curl https://api.pixelapi.dev/v1/image/GENERATION_ID -H "Authorization: Bearer YOUR_API_KEY"

The response contains generation_id, status and credits_used. Staging usually takes a few minutes.

POST/v1/real-estate/cleanup

Multipart form. Declutter only. Give either a mask or a prompt.

FieldTypeRequiredDescription
imagefileyesProperty photo (JPG/PNG/WEBP, max 20 MB).
cleanup_typestringnodeclutter (the only operation).
maskfileone ofMask image, white = area to remove.
promptstringone ofDescribe what to remove instead of a mask, e.g. the boxes and the ladder.

Example

curl -X POST https://api.pixelapi.dev/v1/real-estate/cleanup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@bedroom.jpg" \
  -F "cleanup_type=declutter" \
  -F "prompt=the cardboard boxes and the ladder"

GET/v1/image/{generation_id}

Poll every few seconds until status is completed (or failed), then download output_url.

curl https://api.pixelapi.dev/v1/image/GENERATION_ID -H "Authorization: Bearer YOUR_API_KEY"

Tips

Get an API keyStep-by-step tutorialTool overview

FAQ

How much does virtual staging cost?

200 credits per staged photo. Declutter cleanup is 12 credits per photo. 1 credit = $0.001 on the Starter plan.

Will it change my room?

Staging furnishes the room but keeps the walls, windows and camera angle of your photo.

How long does staging take?

Usually a few minutes. Poll GET /v1/image/{generation_id}.

Can it replace the sky or turn day into dusk?

No. Only virtual staging and declutter cleanup are available.