Workflow

Outdoor Staging

Virtually stage outdoor spaces and gardens — existing furniture and clutter are removed first, then replaced with your chosen landscaping 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/outdoor-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('outdoor-staging', {
  input: {
    image: await readFile('image.jpg'),
    prompt: "Outdoor staging with modern landscaping. Add a well-maintained garden, green lawn, trimmed hedges, and outdoor furniture.",
  },
})

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

Endpoint

POST/v1/workflows/outdoor-staging/run

Requires X-API-Key header. See Authentication.

Inputs

Field	Type	Required	Description
`image`	`asset:image`		Exterior photo to stage
`prompt`	`string`		Staging style description (e.g. 'modern landscaping with green lawn and outdoor dining') Default: `Outdoor staging with modern landscaping. Add a well-maintained garden, green lawn, trimmed hedges, and outdoor furniture`.

Outputs

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

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

Before / After

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

BEFORE

AFTER

Request

{
  "inputs": {
    "image": "sha256:<hash_image>",
    "prompt": "Outdoor staging with modern landscaping. Add a well-maintained garden, green lawn, trimmed hedges, and outdoor furniture."
  }
}

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