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

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 15 seconds. The API uses the same plan and credits 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 is out of credits.

Endpoints

GET/me/credits

Your plan and remaining credits.

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. Uses 1 credit per image.

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

transformationIntensity

  • subtle
  • moderate
  • complete