Backbone LabDocs
Base pipelinev1.0.0

Enhancer

The standard develop for a listing photo: automatic HDR-quality development, perspective correction, and the Backbone signature tone. The base pipeline (normalization, resolution cap, delivery encode) runs on every order; perspective and tone are toggles you turn on.

Enhancer preview

Ordering

Submit an order with POST /v1/orders — or one call of SDK. The snippets below are complete: upload, order, live progress, download.

POST/v1/orders
import { 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],
  perspective: true,
  tonecraft: true,
})

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.

OptionTypeDescription
perspectivebooleanStraighten verticals and correct lens distortion. Default: false.
perspective_strengthnumberHow aggressively the correction is applied (0-1). Default: 1.
tonecraftbooleanApply the Backbone signature tone. Default: false.
alignbooleanAlign brackets before the HDR merge. Default: true.
formatenumDelivery format. Options: jpeg, png, webp. Default: jpeg.

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.

BEFORE
AFTER

Versioning

This page documents recipe develop@1.0.0. The live catalog — every feature, its version and parameters — is public at GET /v1/features. Minor bumps improve quality without changing the interface.

See also

  • Batches — run a whole shoot in one call, with per-scene overrides.
  • Streaming — WebSocket and SSE progress in detail.