Skip to content

v0.11.0 — /video/remove: video background removal with real alpha

Choose a tag to compare

@TroyJLorents-GH TroyJLorents-GH released this 10 Jul 08:21
· 22 commits to main since this release

Added

  • POST /video/remove — video background removal, frame by frame, using the same BiRefNet engine as images, plus temporal alpha smoothing so the matte doesn't flicker between frames. Async: submit a clip, get a job_id, poll for the result.

    • ProRes 4444 (default) — MOV with a real 10-bit alpha channel. Drops straight into DaVinci Resolve, Premiere Pro, After Effects, and Final Cut. No green chroma key.
    • WebM (VP9 alpha) — transparent video for the web.
    • MP4 + bg_color — composite every frame onto a solid color (linear-light blending, no edge halos).
    • Accepts mp4, mov, avi, webm, mkv. Audio is preserved. smoothing 0–100 tunes the temporal filter.
  • GET /jobs/{job_id} — job status, progress %, and a signed result URL (valid 1 hour). Jobs are visible only to the key that created them.

Billing & limits

Paid tiers only. $0.05 per output second (10s clip = $0.50), billed only when the job succeeds. v1 caps: 30 seconds per clip, 30fps processing, 200MB upload, 1080p frame processing.

Demo

# submit
curl -X POST "https://useknockout--api.modal.run/video/remove" \
  -H "Authorization: Bearer kno_YOUR_KEY" \
  -F "file=@product-clip.mp4" \
  -F "format=prores4444"

# poll
curl "https://useknockout--api.modal.run/jobs/JOB_ID" \
  -H "Authorization: Bearer kno_YOUR_KEY"

Verified end to end on release: 96-frame clip → prores / 4444 / yuva444p12le with a clean alpha matte.