Image to Video

Turn any real-estate photo into a cinematic 8-second walkthrough video. The camera smoothly zooms and pans through the scene with warm, golden-hour lighting.

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/image-to-video/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('image-to-video', {
  input: {
    image: await readFile('image.jpg'),
  },
})

// Download output video
await bkbnlab.download(result.outputs.video, 'result.mp4')

Endpoint

Requires X-API-Key header. See Authentication.

Inputs

Outputs

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

Request

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

Response — queued

{
  "jobId": "job_abc123",
  "status": "queued"
}

Response — completed

{
  "jobId": "job_abc123",
  "status": "completed",
  "outputs": {
    "video": "sha256:..."
  }
}

Download an output

curl -o result.mp4 \
  -H "X-API-Key: $BKBNLAB_API_KEY" \
  https://api.bkbnlab.ai/v1/assets/$VIDEO_HASH/raw