Skip to main content

Overview

n8n is a visual workflow automation platform that lets you connect apps and automate tasks without code. By integrating VideoBGRemover with n8n, you can:
  • Batch process videos automatically from Google Drive, Airtable, or any connected app
  • Schedule video processing with cron triggers for off-peak hours
  • Chain workflows by connecting to 400+ apps (Slack notifications, database updates, etc.)
  • No coding required - visual workflow builder with drag-and-drop nodes
We provide two pre-built workflow templates to get you started instantly.

Template 1: Video Composition Workflow

What It Does

Removes the background from a video, composites it onto a custom background, and uploads the final result to Google Drive. Perfect for: AI-generated videos (Sora, HeyGen), product demos, talking head videos, social media content.

Workflow Steps

1. Trigger (Webhook or Manual)

2. Create Job (POST /v1/jobs with video URL)

3. Start Composition (POST /v1/jobs/{id}/start with background)

4. Poll Status (GET /v1/jobs/{id}/status every 20 seconds)

5. Download Processed Video

6. Upload to Google Drive

API Key Required

Processing Time

3-5 minutes per minute of video

Get the Template

Import Workflow from GitHub →

Template 2: AI UGC Ad Generator Workflow

What It Does

Complete AI pipeline that analyzes an app screen recording, generates a UGC-style ad script with AI actors, and composites everything into a final video. Perfect for: App developers, SaaS marketing teams, mobile app demos, feature announcements.

Workflow Steps

1. Upload App Screen Recording

2. Gemini AI Analysis
   - Analyzes app features
   - Generates ad script (hook, problem, solution, CTA)
   - Describes ideal AI actor

3. Sora 2 AI Video Generation
   - Creates AI actor video
   - Natural UGC-style delivery
   - 4-12 second duration

4. VideoBGRemover Composition
   - Removes actor background
   - Composites actor over app recording
   - Mixes audio (30% app + 100% actor)

5. Upload to Google Drive

API Keys Required

Processing Time

5-8 minutes total (Gemini: ~30s, Sora 2: ~2-4 min, VideoBGRemover: ~2-3 min)

Get the Template

Import Workflow from GitHub →

Quick Start

1. Import Workflow to n8n

In your n8n instance:
  • Go to Workflows → Import from URL
  • Paste the GitHub template URL (see above)
  • Click Import

2. Configure API Keys

Add your API keys to n8n environment variables:
Settings → Variables → Add new variable

For Template 1:
- Name: VIDEOBGREMOVER_KEY
- Value: vbr_your_key_here

For Template 2 (add all three):
- Name: GEMINI_KEY
- Value: your_gemini_key
- Name: FAL_KEY
- Value: your_fal_key
- Name: VIDEOBGREMOVER_KEY
- Value: vbr_your_key_here

3. Connect Google Drive

  • Click on the “Upload to Google Drive” node
  • Click “Create New Credential”
  • Follow the OAuth authorization flow
  • Select the folder where videos should be saved (optional)

4. Test the Workflow

For Template 1:
  • Update the video URLs in the “Sample Video URLs” node
  • Click “Execute Workflow”
  • Wait 3-5 minutes for processing
  • Check Google Drive for the final video
For Template 2:
  • Update the screenshot_video_url in the “Sample Input” node
  • Click “Execute Workflow”
  • Wait 5-8 minutes for processing
  • Check Google Drive for the UGC ad

How the Workflows Work

Both templates follow the same polling pattern used by our API:
  1. Create a job by uploading your video (POST /v1/jobs)
  2. Start processing with composition parameters (POST /v1/jobs/{id}/start)
  3. Poll the status every 20 seconds (GET /v1/jobs/{id}/status)
  4. Download the video when status is completed
  5. Upload to storage (Google Drive) and return the shareable link
The workflow handles:
  • ✅ Automatic status polling and retries
  • ✅ Error handling for failed jobs
  • ✅ Both webhook and manual triggers
  • ✅ Seamless Google Drive integration

Automation Options

Webhook Triggers

Activate the workflow and use the webhook URL to trigger processing from external applications:
curl -X POST https://your-n8n-instance.com/webhook/compose-video \
  -H "Content-Type: application/json" \
  -d '{
    "foreground_video_url": "https://example.com/video.mp4",
    "background_video_url": "https://example.com/background.mp4"
  }'

Batch Processing

Connect the workflow to:
  • Google Sheets - Process rows of video URLs
  • Airtable - Process database records
  • Google Drive Watch - Auto-process new uploads
  • Cron Schedule - Process videos at specific times

Notifications

Add nodes to send notifications when processing completes:
  • Slack - Post message with video link
  • Discord - Send webhook notification
  • Email - Send download link
  • SMS - Text notification via Twilio

Resources


Next Steps