​
Get Your API Key

First, you’ll need an API key to authenticate your requests.
1

Sign up for an account

Visit videobgremover.com and create an account.
2

Purchase credits

Buy credits for video processing. Each second of video costs 1 credit.
3

Create an API key

Go to API Management and create your first API key.

​
Choose Your Workflow

The API supports two ways to process videos:

📁 File Upload

Upload video files directly from your device or server.

🌐 URL Download

Process videos from public URLs (S3, CDN, direct links).

​
File Upload Workflow

Perfect when you have video files locally or on your server.
1

Create a job

curl -X POST https://api.videobgremover.com/v1/jobs \
  -H "X-Api-Key: vbr_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "my-video.mp4",
    "content_type": "video/mp4"
  }'
2

Upload your video

Use the upload_url from step 1 to upload your video file:
curl -X PUT "UPLOAD_URL_FROM_STEP_1" \
  -H "Content-Type: video/mp4" \
  --data-binary @my-video.mp4
3

Start processing

curl -X POST https://api.videobgremover.com/v1/jobs/YOUR_JOB_ID/start \
  -H "X-Api-Key: vbr_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'
4

Check status and download

curl -X GET https://api.videobgremover.com/v1/jobs/YOUR_JOB_ID/status \
  -H "X-Api-Key: vbr_your_api_key_here"

​
URL Download Workflow

Perfect when your videos are already hosted online.
1

Create job from URL

curl -X POST https://api.videobgremover.com/v1/jobs \
  -H "X-Api-Key: vbr_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://your-s3-bucket.amazonaws.com/video.mp4"
  }'
The video downloads automatically - no upload step needed!
2

Start processing

curl -X POST https://api.videobgremover.com/v1/jobs/YOUR_JOB_ID/start \
  -H "X-Api-Key: vbr_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'
3

Check status and download

curl -X GET https://api.videobgremover.com/v1/jobs/YOUR_JOB_ID/status \
  -H "X-Api-Key: vbr_your_api_key_here"

​
What’s Next?

Background Options

Learn about color backgrounds, transparent formats, and pro workflows.

Error Handling

Handle insufficient credits, rate limits, and other common scenarios.

Code Examples

See complete examples in JavaScript, Python, and other languages.

API Reference

Explore the complete API documentation with all endpoints.