API & SDK Documentation for Video Background Removal with AI

What is Video Composition?

Video composition lets you layer transparent videos with custom backgrounds, effects, and positioning to create professional-looking videos. This happens locally on your machine using FFmpeg - no API calls or credits required.

💻 Local Processing

FFmpeg-powered: Runs on your machine, no internet required

🆓 No Credits Used

Free operations: Composition doesn’t consume API credits

🎬 Professional Quality

Production-ready: Export in H.264, ProRes, WebM, PNG sequences

🎯 Precise Control

Pixel-perfect: Position, scale, and time everything exactly

Prerequisites

Before you can create compositions, you need:

Transparent Videos

Videos with removed backgrounds (from background removal)

FFmpeg Installed

FFmpeg must be available in your system PATH (installation guide)

SDK Installed

Node.js or Python SDK (installation guide)

How It Works

Create Background

Choose from colors, images, or video backgrounds

Add Layers

Layer your transparent videos with precise positioning

Apply Effects

Control opacity, rotation, timing, and scaling

Export

Render locally using FFmpeg in your preferred format

Quick Example

Here’s a complete composition workflow:

import { 
  Background, 
  Composition, 
  Foreground, 
  EncoderProfile, 
  Anchor, 
  SizeMode 
} from '@videobgremover/sdk'

// 1. Create custom background
const background = Background.fromColor('#FF0000', 1920, 1080, 30)

// 2. Load transparent video (from background removal)
const transparent = Foreground.fromUrl('path/to/transparent.webm', {
  format: 'webm_vp9'
})

// 3. Create composition
const comp = new Composition(background)
comp.add(transparent, 'main_video')
  .at(Anchor.CENTER)
  .size(SizeMode.CONTAIN)
  .opacity(0.9)

// 4. Export final video
await comp.toFile('final_video.mp4', EncoderProfile.h264())

from videobgremover import (
    Background, 
    Composition, 
    Foreground, 
    EncoderProfile, 
    Anchor, 
    SizeMode
)

# 1. Create custom background
background = Background.from_color('#FF0000', 1920, 1080, 30)

# 2. Load transparent video (from background removal)
transparent = Foreground.from_webm_vp9('path/to/transparent.webm')

# 3. Create composition
comp = Composition(background)
comp.add(transparent, 'main_video') \
    .at(Anchor.CENTER) \
    .size(SizeMode.CONTAIN) \
    .opacity(0.9)

# 4. Export final video
comp.to_file('final_video.mp4', EncoderProfile.h264())

Key Concepts

Backgrounds

Create the foundation for your composition:

Color backgrounds: Solid colors using hex codes
Image backgrounds: Static images (automatically looped)
Video backgrounds: Dynamic video backgrounds
Empty backgrounds: Transparent canvas for overlays

Layers

Stack multiple transparent videos:

Positioning: Use anchors (CENTER, TOP_LEFT, etc.) with pixel offsets
Sizing: Fit, cover, exact pixels, or percentage of canvas
Effects: Opacity, rotation, cropping
Timing: Control when layers appear and disappear

Export Formats

Render your final video:

H.264 MP4: Universal compatibility, good compression
VP9 WebM: Web-optimized, excellent compression
ProRes MOV: Professional editing, highest quality
PNG Sequence: Frame-by-frame work, maximum quality

Composition Types

Simple Replacement

Replace video background with a solid color or image:

// Color background
const bg = Background.fromColor('#00FF00', 1920, 1080, 30)
const comp = new Composition(bg)
comp.add(transparent).at(Anchor.CENTER)

// Image background
const bg = Background.fromImage('background.jpg', 30)
const comp = new Composition(bg)
comp.add(transparent).at(Anchor.CENTER)

# Color background
bg = Background.from_color('#00FF00', 1920, 1080, 30)
comp = Composition(bg)
comp.add(transparent).at(Anchor.CENTER)

# Image background
bg = Background.from_image('background.jpg', fps=30)
comp = Composition(bg)
comp.add(transparent).at(Anchor.CENTER)

Multi-Layer Composition

Layer multiple videos with different positioning:

const comp = new Composition(background)

// Main video (full screen)
comp.add(video1, 'main')
  .at(Anchor.CENTER)
  .size(SizeMode.CONTAIN)

// Picture-in-picture (small, top-right)
comp.add(video2, 'pip')
  .at(Anchor.TOP_RIGHT, -50, 50)
  .size(SizeMode.CANVAS_PERCENT, { percent: 25 })
  .opacity(0.8)

comp = Composition(background)

# Main video (full screen)
comp.add(video1, 'main') \
    .at(Anchor.CENTER) \
    .size(SizeMode.CONTAIN)

# Picture-in-picture (small, top-right)
comp.add(video2, 'pip') \
    .at(Anchor.TOP_RIGHT, dx=-50, dy=50) \
    .size(SizeMode.CANVAS_PERCENT, percent=25) \
    .opacity(0.8)

Timed Sequences

Control when layers appear and disappear:

const comp = new Composition(background)

// Video appears at 2 seconds, lasts 5 seconds
comp.add(video1, 'intro')
  .start(2.0)
  .duration(5.0)
  .at(Anchor.CENTER)

// Video appears at 8 seconds, ends at 15 seconds  
comp.add(video2, 'outro')
  .start(8.0)
  .end(15.0)
  .at(Anchor.TOP_RIGHT)

comp = Composition(background)

# Video appears at 2 seconds, lasts 5 seconds
comp.add(video1, 'intro') \
    .start(2.0) \
    .duration(5.0) \
    .at(Anchor.CENTER)

# Video appears at 8 seconds, ends at 15 seconds
comp.add(video2, 'outro') \
    .start(8.0) \
    .end(15.0) \
    .at(Anchor.TOP_RIGHT)

Requirements

FFmpeg: Must be installed and available in PATH
Transparent videos: From background removal or other sources
System resources: Composition happens locally on your machine

What’s Next?

🎨 Create Backgrounds

Learn about color, image, and video backgrounds

📐 Position Layers

Master precise positioning and sizing

⏰ Control Timing

Create timed sequences and animations

🎬 Export Videos

Choose the right export format for your needs

Getting Started

Guides

API Reference

SDK Reference

Examples & Integrations

Video Composition Guide | Create Professional Video Layouts

What is Video Composition?

💻 Local Processing

🆓 No Credits Used

🎬 Professional Quality

🎯 Precise Control

Prerequisites

How It Works

Quick Example

Key Concepts

Backgrounds

Layers

Export Formats

Composition Types

Simple Replacement

Multi-Layer Composition

Timed Sequences

Requirements

What’s Next?

🎨 Create Backgrounds

📐 Position Layers

⏰ Control Timing

🎬 Export Videos

​What is Video Composition?

💻 Local Processing

🆓 No Credits Used

🎬 Professional Quality

🎯 Precise Control

​Prerequisites

​How It Works

​Quick Example

​Key Concepts

​Backgrounds

​Layers

​Export Formats

​Composition Types

​Simple Replacement

​Multi-Layer Composition

​Timed Sequences

​Requirements

​What’s Next?

🎨 Create Backgrounds

📐 Position Layers

⏰ Control Timing

🎬 Export Videos

What is Video Composition?

Prerequisites

How It Works

Quick Example

Key Concepts

Backgrounds

Layers

Export Formats

Composition Types

Simple Replacement

Multi-Layer Composition

Timed Sequences

Requirements

What’s Next?