Sky Replacement
Replace overcast or dull skies with the sky the listing deserves. Pick the mood — crisp blue, soft clouds, dramatic, or sunset — and reflections and lighting stay photorealistic.
Ordering
Submit an order with POST /v1/orders — or one call of SDK. The snippets below are complete: upload, order, live progress, download.
/v1/ordersimport { BkbnClient } from '@bkbnlab/api'
const bkbn = new BkbnClient() // reads BKBNLAB_API_KEY
const photo = await bkbn.upload('living-room.jpg')
const order = await bkbn.order({
inputs: [photo],
sky: 'dramatic',
})
const result = await order.wait({
onProgress: (p) => console.log(p.stage, p.percent),
})
await result.save('result.jpg')Options
Options ride the order body next to inputs. Everything is optional — an order with no options runs the base develop.
| Option | Type | Description |
|---|---|---|
sky | boolean | Turn sky replacement on. Default: false. |
sky_style | enum | The sky mood to composite. Options: clear, soft_clouds, dramatic, sunset. Default: soft_clouds. |
Inputs and outputs
inputs takes 1-5 asset ids — the exposure brackets of one scene (most orders send a single image). The completed order carries one outputAssetId; download it with GET /v1/assets/:id.
Before / After
Drag the slider to compare input and output. Switch between examples below.
Versioning
This page documents recipe sky@1.5.0. The live catalog — every feature, its version and parameters — is public at GET /v1/features. Minor bumps improve quality without changing the interface.