Decor Copilot API: AI Virtual Staging & Room Redesign
Decor Copilot

Decor Copilot API

Stage, redesign and fix listing photos from your own software. Upload a photo, call one endpoint and get the result URL in about 20 seconds. The API uses the same plan as the web app.

Authentication

  1. Sign in and open Settings → API keys.
  2. Create a key and copy it. It is shown once.
  3. Send it as Authorization: Bearer <key> with Accept: application/json.

Base URL: https://decorcopilot.com/api/mobile/v1. Rate limit: 10 generations per minute. A 402 response means the account has no designs left on its plan.

Endpoints

GET/me/credits

Your plan and remaining usage.

curl https://decorcopilot.com/api/mobile/v1/me/credits \
  -H "Authorization: Bearer $DECOR_KEY" -H "Accept: application/json"

POST/uploads/room-image

Upload a room photo (JPG, PNG, WebP or HEIC, up to 15 MB). Returns its url.

curl https://decorcopilot.com/api/mobile/v1/uploads/room-image \
  -H "Authorization: Bearer $DECOR_KEY" -H "Accept: application/json" \
  -F "image=@living-room.jpg"

POST/transform

Redesign or virtually stage the uploaded photo. Returns the room, the variation and its image URLs. Counts toward your plan's usage.

curl https://decorcopilot.com/api/mobile/v1/transform \
  -H "Authorization: Bearer $DECOR_KEY" -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "<url from upload>",
    "mode": "decoration",
    "roomName": "123 Main St - living room",
    "roomType": "living-room",
    "designStyle": "scandinavian",
    "transformationIntensity": "moderate",
    "customPrompt": "Stage for a listing, keep the floors",
    "numImages": 1
  }'

POST/rooms

Create a room from an uploaded photo, for photo fixes without a redesign.

curl https://decorcopilot.com/api/mobile/v1/rooms \
  -H "Authorization: Bearer $DECOR_KEY" -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name": "Front exterior", "original_image_url": "<url from upload>", "mode": "decoration"}'

POST/rooms/{room}/photo-fix

Apply a one-tap fix such as day_to_dusk, blue_sky, empty_room or declutter. Set "upscale": true instead of "fix" for a 4x upscale.

curl https://decorcopilot.com/api/mobile/v1/rooms/<room id>/photo-fix \
  -H "Authorization: Bearer $DECOR_KEY" -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"source_image_url": "<image url>", "fix": "day_to_dusk"}'

GET/rooms/{room}/variations

Every version of a room with its image URLs.

curl https://decorcopilot.com/api/mobile/v1/rooms/<room id>/variations \
  -H "Authorization: Bearer $DECOR_KEY" -H "Accept: application/json"

Allowed values

roomType

  • living-room
  • bedroom
  • kitchen
  • bathroom
  • dining-room
  • office
  • nursery
  • garden
  • laundry-room
  • garage
  • basement
  • attic
  • gym
  • library
  • playroom
  • gaming-room
  • streaming-room
  • mudroom
  • closet
  • hallway
  • balcony
  • patio
  • house-exterior
  • multi-functional

designStyle

  • modern
  • minimalist
  • scandinavian
  • contemporary
  • transitional
  • coastal
  • farmhouse
  • industrial
  • midcentury
  • traditional
  • japandi
  • bohemian
  • art-deco
  • mediterranean
  • french-country
  • tropical
  • asian-zen
  • feng-shui
  • eclectic
  • shabby-chic
  • hollywood-glam
  • southwestern
  • nautical
  • rustic
  • luxury
  • maximalist
  • vintage
  • cottagecore
  • gothic
  • steampunk
  • botanical
  • english-garden
  • japanese-garden
  • desert-garden
  • formal-garden
  • wild-garden

fix

  • blue_sky
  • golden_hour
  • day_to_dusk
  • brighten
  • cozy_evening
  • green_lawn
  • fill_pool
  • summer_refresh
  • curb_appeal
  • landscaping
  • wood_floors
  • marble_counters
  • white_cabinets
  • fresh_walls
  • declutter
  • straighten
  • expand_view
  • autumn_colors
  • winter_snow
  • spring_bloom
  • night_to_day
  • empty_room
  • tile_floors
  • herringbone_floors
  • sage_cabinets
  • tile_backsplash
  • exterior_paint
  • new_roof
  • mood_board
  • morning_light
  • night_lamps_on
  • warm_white_balance
  • cool_white_balance
  • finish_construction
  • new_siding
  • front_door_color
  • garage_door
  • new_fence
  • paver_driveway

transformationIntensity

  • subtle
  • moderate
  • complete