Video API - technical reference

Getting started

1. Sign in at bscale.co.il (any BScale account works).
2. Activate the free Video API module: Settings → Services.
3. Create an API key in the Video Studio page - shown once, store it safely.
4. Fund your wallet (Settings → Billing → Top-up). Each generation charges the wallet at the same rates as the in-app studio.

Optional: connect Google Drive to keep every generated video in your Creative Library. Without Drive, finished videos are held for 7 days only - download them via the API.

Authentication

Every call except the signed file download sends the key as a Bearer token:

Authorization: Bearer bsk_live_...

Full example

Submit a generation, poll until it finishes, then download the file:

KEY=$BSCALE_API_KEY

# 1. Start a generation
JOB=$(curl -s -X POST https://bscale.co.il/api/v1/video/generations \
  -H "Authorization: Bearer $KEY" -H "content-type: application/json" \
  -d '{
    "prompt": "A ceramic coffee mug on a rustic wooden table, soft morning light, slow orbit",
    "engine": "ltx",
    "durationSeconds": 8
  }' | jq -r .id)

# 2. Poll every 5-10s until status is "succeeded" or "failed"
watch -n 8 "curl -s https://bscale.co.il/api/v1/video/generations/$JOB \
  -H 'Authorization: Bearer $KEY'"

# 3. Download the finished file (videoUrl is signed, no key needed)
URL=$(curl -s https://bscale.co.il/api/v1/video/generations/$JOB \
  -H "Authorization: Bearer $KEY" | jq -r .videoUrl)
curl -s "$URL" -o video.mp4