Backbone LabDocs
Base pipelinev1.1.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 cover upload, order, live progress and download using SDK 1.5.0 or Bash with curl and jq. See the SDK installation notes.

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: { profile: 'signature', sharpen: true },
  quality: 92,
})

const result = await order.wait({
  onProgress: (p) => console.log(p.stage, p.percent),
})
await result.save('result.jpg')

Perspective modes

Both modes first level the horizon, up to 25 degrees, then correct the verticals. perspective_mode picks how far that second step goes. natural corrects the way a photo editor would and leaves near-level, extreme or ambiguous shots alone. absolute, the default, applies the full camera-based correction on every shot while keeping at least 60% of the levelled frame. perspective_strength (default 0.6) scales the vertical correction; the horizon is levelled in full at any strength above 0. In absolute the strength is a floor: near-straight photos are corrected further, up to the full correction.

Options

These are REST request fields, alongside inputs. Defaults apply when neither an explicit value nor a selected preset supplies that setting. Shared delivery options are documented under Enhancer.

OptionTypeDescription
perspectivebooleanEnable perspective correction. Default: false.
perspective_modeenumBoth modes level the horizon first, up to 25 degrees. 'natural' then corrects the verticals the way a photo editor would, and leaves near-level, extreme or ambiguous shots alone. 'absolute' applies the full camera-based correction on every shot while keeping at least 60% of the levelled frame; that frame budget can leave some residual tilt on strong tilts. Options: natural, absolute. Default: absolute.
perspective_strengthnumberCorrection strength. In 'absolute' it is the floor: a near-straight photo, cheap to straighten, is corrected further, up to the full correction; a strongly tilted one gets this strength. 1 is the full correction everywhere, 0 leaves the photo untouched. Range: 0–1. Default: 0.6.
tonecraftbooleanEnable the selected Tonecraft look. Default: false.
tonecraft_profilestringPreset key returned by GET /v1/presets?feature=tonecraft. Enable tonecraft to apply this look. Default: signature.
tonecraft_levelsbooleanOverride the preset: auto-levels finishing on/off. When omitted, the selected preset decides.
tonecraft_sharpenbooleanOverride the preset: calibrated sharpness boost on/off. When omitted, the selected preset decides.
alignbooleanAlign brackets before the HDR merge. Default: true.
formatenumDelivery format. Options: jpeg, png, webp. Default: jpeg.
qualityintegerJPEG/WebP encoding quality. This controls delivery compression, not the generation tier. Range: 1–100. Default: 92.

Presets and overrides

List the active public presets and presets available to your API key:

curl -fsS "https://api.bkbn.ai/v1/presets?feature=tonecraft" \
  -H "X-API-Key: $BKBNLAB_API_KEY" | jq '.data.presets'

Read data.presets and use a preset's key, rather than its display name or UUID. For a custom look, contact us.

With REST, set tonecraft: true and choose the look with tonecraft_profile. If the profile is omitted, the look is signature. Explicit tonecraft_levels and tonecraft_sharpen override the selected preset, including when set to false; omit them to use the preset's settings. JavaScript also accepts a preset key or an options object in tonecraft, as shown in the example.

In a batch, an omitted scene option inherits the batch value; an explicit scene value overrides it. Preset resolution then uses those merged options. See Batches.

SDK option names

These SDK options correspond to the REST fields below. Other options in the table above keep the same name. Dotted JavaScript names are properties of an options object.

RESTPythonJavaScriptKotlin
perspective_modeperspective_modeperspective.modeperspectiveMode
perspective_strengthperspective_strengthperspective.strengthperspectiveStrength
tonecraft_profiletonecraft_profiletonecraft.profiletonecraftProfile
tonecraft_levelstonecraft_levelstonecraft.levelstonecraftLevels
tonecraft_sharpentonecraft_sharpentonecraft.sharpentonecraftSharpen

Inputs and outputs

inputs takes 1-5 ready asset ids owned by your key, uploads or previous deliveries — the exposure brackets of one scene. Magic Eraser takes exactly one image plus a mask. The completed order carries one outputAssetId (an opaque uuid) and its outputFormat. Authenticated GET /v1/assets/:id returns data.url and data.expiresIn; fetch the signed URL without your API key to download the bytes. A delivery's id can be reused as the input of another order: iterate on a result without uploading it again.

Before / After

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

BEFORE
AFTER

Versioning

This page documents recipe develop@1.1.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.