Workflow

Indoor Staging

Virtually stage empty or furnished rooms — furniture is removed first, then replaced with your chosen style. Output preserves original image dimensions.

How it works

Upload assets — POST /v1/assets/upload with each image file. Returns a sha256:... hash.
Run the workflow — POST /v1/workflows/indoor-staging/run with asset hashes and parameters. Returns a jobId.
Get results — Poll GET /v1/jobs/:jobId or stream via GET /v1/jobs/:jobId/events (SSE).
Download outputs — GET /v1/assets/:hash/raw to download each output file.

Code examples

import { bkbnlab } from '@bkbnlab/api'
import { readFile } from 'node:fs/promises'

// export BKBNLAB_API_KEY=sk-...

const result = await bkbnlab.subscribe('indoor-staging', {
  input: {
    image: await readFile('image.jpg'),
    prompt: "Indoor staging with modern minimalist style. Add contemporary furniture, warm lighting, and tasteful decorations.",
  },
})

// Download output image
await bkbnlab.download(result.outputs.image, 'result.png')

Endpoint

POST/v1/workflows/indoor-staging/run

Requires X-API-Key header. See Authentication.

Inputs

Field	Type	Required	Description
`image`	`asset:image`		Interior photo to stage
`prompt`	`string`		Staging style description (e.g. 'modern minimalist with warm lighting') Default: `Indoor staging with modern minimalist style. Add contemporary furniture, warm lighting, and tasteful decorations`.

Outputs

Each output is a sha256:... asset hash. Download via GET /v1/assets/:hash/raw.

Field	Type	Description
`image`	`asset:image`	Virtually staged interior

Before / After

Drag the slider to compare input and output. Switch between examples below.

BEFORE

AFTER

Request

{
  "inputs": {
    "image": "sha256:<hash_image>",
    "prompt": "Indoor staging with modern minimalist style. Add contemporary furniture, warm lighting, and tasteful decorations."
  }
}

Response — queued

{
  "jobId": "job_abc123",
  "status": "queued"
}

Response — completed

{
  "jobId": "job_abc123",
  "status": "completed",
  "outputs": {
    "image": "sha256:..."
  }
}

Download an output

curl -o result.png \
  -H "X-API-Key: $BKBNLAB_API_KEY" \
  https://api.bkbnlab.ai/v1/assets/$IMAGE_HASH/raw