For Developers · REST API

Interior design AI,
from your own code.

The HouseKraft API runs the same tools as the website: virtual staging, unstaging, wall paint, flooring, materials, lighting, panoramas and walkthrough videos. Same results, same prices, one credit balance.

For accounts with a paid plan or bought credits
17
Design tools over one REST API
50
Rooms in one bulk staging job
1 balance
Same credits as the website
Auto refunds
On every failed run
What You Can Build

Put HouseKraft
inside your product.

Listing platforms

Stage or empty a whole listing in one job as photos are uploaded.

Real estate photo workflows

Add staging, twilight and weather edits to your delivery pipeline.

Paint & flooring visualizers

Let shoppers see your colours and floors, or a photo of your product, in their own room.

Design & proptech apps

Offer photorealistic redesigns, panoramas and walkthrough videos without training models.

Quick Start

Three calls
to a result.

Send your key in the Authorization header. Quick tools answer with the finished image. Slower ones (videos, bulk jobs, En Masse) answer with a job you check until status is done.

1. Upload a photo (or pass an https:// image URL instead)
curl -s -X POST https://app.housekraft.co/api/v1/uploads \
  -H "Authorization: Bearer $HOUSEKRAFT_KEY" \
  -F image=@room.jpg
2. Run a tool
curl -s -X POST https://app.housekraft.co/api/v1/tools/walls/run \
  -H "Authorization: Bearer $HOUSEKRAFT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "<asset id>", "color_id": "sage green"}'
3. If it says "running", fetch the job
curl -s https://app.housekraft.co/api/v1/jobs/<job id> \
  -H "Authorization: Bearer $HOUSEKRAFT_KEY"

The finished file is at job.output.url. Results also appear in your HouseKraft Library, just like runs on the website.

The Tools

17 tools,
priced per run.

Each tool is priced exactly as on the website. Run POST /api/v1/tools/<endpoint>/run.

ToolEndpointWhat it doesCredits
Wall PaintwallsRepaint the walls any colour, or match a paint sample.1 credit
FlooringflooringLay a new floor: wood, tile, marble, vinyl or a brand sample.1 credit
MaterialmaterialSwap the material on a surface, or on several marked areas.2 credits
Object PlacementfurnitureAdd, replace or remove a piece of furniture.2 credits
Time of DaylightingChange the light to any time of day.1 credit
WeatherweatherChange the weather and the view outside the windows.1 credit
StagestageFurnish an empty room.2 credits
UnstageunstageEmpty a room back to its shell.1 credit
POVpovRe-shoot the room from another camera angle.2 credits
AI AnnotateeditorMark part of the photo and say what to change there.3 credits
Floor Plan to DollhousedollhouseTurn a floor plan into a top-down 3D render.1 credit
360° PanoramapanoramaTurn 1–6 photos of a room into a 360° panorama.3 credits
Walkthrough VideowalkthroughTurn a room photo into a walkthrough video.10 credits / 6 s
Walkthrough Video (multiple photos)walkthrough_multiOne continuous walkthrough across several photos of a property.from 2 credits
Bulk Stagingbulk_stageStage up to 50 empty rooms in one job, in one style.2 credits / photo
Bulk Unstagingbulk_unstageEmpty up to 50 furnished rooms in one job.1 credit / photo
En MasseenmasseTry many colours, floors and themes on one room at once.1 credit / option

Credits & refunds

  • ✓ Same price table as the website, one shared balance.
  • ✓ Failed runs are refunded automatically.
  • ✓ Bulk jobs charge photo by photo and refund any photo that fails.
  • ✓ En Masse only charges once its results are ready.
  • ✓ Free: uploads, option lists, help, rejected requests, and job checks.
LimitValue
Requests a minute120
Runs a minute10
Jobs running at once3
Largest image16 MB
Photos per bulk job50
En Masse references2–52
Also For AI Assistants

One key,
API and MCP.

The same API key connects HouseKraft to Claude Code, Cursor, VS Code and Claude Desktop through our MCP server. Ask in plain words and the assistant runs the tools for you.

FAQ

Questions,
answered.

Who can use the HouseKraft API?

Any HouseKraft account with an active paid plan, or that has bought credits. Sign in and create a key on the Developers page.

How is the API priced?

Each run uses credits from your HouseKraft account, at the same price as on the website. The API and the website share one balance.

What happens if a run fails?

The credits are refunded automatically. Bulk jobs refund each photo that fails, and En Masse only charges once its results are ready.

Is the API synchronous or asynchronous?

Quick tools answer with the finished image. Slower tools, such as videos and bulk jobs, answer with a job you check until its status is done.

Can I stage a whole listing with one call?

Yes. Bulk Staging and Bulk Unstaging take up to 50 photos in one job.

Can AI assistants use the API?

Yes. The same key works with HouseKraft's MCP server, so Claude Code, Cursor, VS Code and Claude Desktop can run the tools for you.

Start buildingtoday.

Create your key, upload a photo, and get your first result in three calls.