Sky Replacement

Replace overcast or dull skies with bright, sunny blue skies in real estate photos. Photorealistic results that preserve all architectural details.

How it works

1. Upload assets — POST /v1/assets/upload with each image file. Returns a sha256:... hash.
2. Run the workflow — POST /v1/workflows/sky-replacement/run with asset hashes and parameters. Returns a jobId.
3. Get results — Poll GET /v1/jobs/:jobId or stream via GET /v1/jobs/:jobId/events (SSE).
4. 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('sky-replacement', {
  input: {
    image: await readFile('image.jpg'),
  },
})

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

Endpoint

Requires X-API-Key header. See Authentication.

Inputs

Outputs

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

Before / After

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

BEFORE

AFTER

010203

Request

{
  "inputs": {
    "image": "sha256:<hash_image>"
  }
}

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