Developer API
Bring room redesign into your products. One request, one transformed image. Each request is charged to the account that owns the key: 30 credits for an HD render (1 render), 15 for a fast render (½ render), 120 for a video (4 renders).
What you can build
Real estate portals
Stage empty or dated properties: on-the-fly virtual staging on every listing.
Furniture e-commerce
Let your customers see your furniture in a real room before they buy.
Architects & interior designers
Generate several moods for the same space in seconds for your clients.
Apps & SaaS
Add an AI redesign feature to your product without training a model.
Authentication
Create a key in your account (API tab), then send it in the header Authorization.
Authorization: Bearer rd_live_yourKey
Start a render
POST /v1/redesign — from an image URL or a file. Use style or prompt, whichever you prefer.
curl -X POST https://aroomdesigner.com/v1/redesign \
-H "Authorization: Bearer rd_live_yourKey" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/room.jpg",
"style": "scandinave",
"prompt": "cosy living room, light wood, plants"
}'Or as multipart:
curl -X POST https://aroomdesigner.com/v1/redesign \ -H "Authorization: Bearer rd_live_yourKey" \ -F image=@room.jpg -F style=japandi
Generate from text
POST /v1/generate — create an image from a simple description, no photo needed.
curl -X POST https://aroomdesigner.com/v1/generate \
-H "Authorization: Bearer rd_live_yourKey" \
-H "Content-Type: application/json" \
-d '{ "prompt": "bright Scandinavian living room, light wood, plants" }'
# 30 credits (1 HD render) · ?engine=flux-schnell: 15 credits (½ render)Merge images
POST /v1/merge — combine two or more images following an instruction.
curl -X POST https://aroomdesigner.com/v1/merge \
-H "Authorization: Bearer rd_live_yourKey" \
-H "Content-Type: application/json" \
-d '{
"image_urls": ["https://example.com/room.jpg", "https://example.com/sofa.jpg"],
"prompt": "put this sofa in this room"
}'
# 30 credits (1 HD render) · also accepts -F images=@a.jpg -F images=@b.jpgAnimate into a video
POST /v1/animate — turn an image into a short video. The job returns an mp4 video.
curl -X POST https://aroomdesigner.com/v1/animate \
-H "Authorization: Bearer rd_live_yourKey" \
-H "Content-Type: application/json" \
-d '{ "image_url": "https://example.com/render.jpg", "prompt": "slow dolly shot" }'
# 120 credits (4 renders) · the result is an mp4 video (result_url)Get the result
GET /v1/jobs/:id — poll until the status is done.
curl https://aroomdesigner.com/v1/jobs/JOB_ID \
-H "Authorization: Bearer rd_live_yourKey"
# -> { "status": "done", "result_url": "https://..." }Render balance
GET /v1/me returns the email and remaining credits (30 credits = 1 HD render).
Available styles
scandinave (Scandinavian), minimal, japandi, contemporain (contemporary), industriel (industrial), boheme (boho), art-deco, mediterraneen (Mediterranean), mid-century, wabi-sabi, classique-chic (classic chic), campagne (farmhouse), cotier (coastal), tropical, maximaliste (maximalist), haussmannien (Haussmann), eclectique (eclectic). Can be combined with a free-form prompt, which takes priority.
Room types
room parameter (redesign and generate): salon (living room), chambre (bedroom), cuisine (kitchen), salle-de-bain (bathroom), bureau (home office), salle-a-manger (dining room), chambre-enfant (kids' room), entree (entryway). It tells the model what the room is for; walls, windows, doors and perspective stay unchanged.
Variants
variants parameter, from 1 (default) to 4, on /v1/redesign, /v1/generate and /v1/merge (JSON field, multipart field or ?variants=). The engine produces several proposals in a single request. The cost is the engine's cost multiplied by the number of variants, charged at launch (cost field in the response); variants that aren't produced are credited back automatically. Once the job is done, /v1/jobs/JOB_ID returns result_url (the first one) and result_urls (all variants).