Skip to main content
POST
/
v1
/
video
/
remove-background
Remove Video Background
curl --request POST \
  --url https://api.developer.pixelcut.ai/v1/video/remove-background \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "video_url": "https://example.com/video.mp4",
  "background_color": "#000000",
  "output_format": "mp4_h264"
}
'
{
  "job_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
}

Authorizations

​
X-API-KEY
string
header
required

All API requests require a valid api key. Include your token as a HTTP request header in the following format: X-API-Key: skXXXXXXXXXXXXXXXX. You can obtain an api key by signing up for developer access in your Pixelcut account.

Body

application/json
​
video_url
string<url>
required

URL of the video to be processed. Must be a publicly accessible URL.

Example:

"https://example.com/video.mp4"

​
background_color
string
default:#000000

The background color to use after removal.

  • Use "transparent" for transparent background (requires webm_vp9, mov_proresks, or gif output format)
  • Use hex code (e.g., "#000000", "#FF5733") for solid color
Pattern: ^(transparent|#[0-9A-Fa-f]{3}|#[0-9A-Fa-f]{6})$
​
output_format
enum<string>
default:mp4_h264

Output video format with codec specification. Defaults to mp4_h264 if not specified.

Formats:

  • mp4_h264: MP4 with H.264 codec
  • mp4_h265: MP4 with H.265/HEVC codec
  • webm_vp9: WebM with VP9 codec (supports transparency)
  • mov_h265: QuickTime with H.265 codec
  • mov_proresks: QuickTime with ProRes 4444 codec (supports transparency)
  • mkv_h264: Matroska with H.264 codec
  • mkv_h265: Matroska with H.265 codec
  • mkv_vp9: Matroska with VP9 codec
  • gif: Animated GIF (supports transparency)
Available options:
mp4_h264,
mp4_h265,
webm_vp9,
mov_h265,
mov_proresks,
mkv_h264,
mkv_h265,
mkv_vp9,
gif

Response

Accepted - processing has started

​
job_id
string

A unique identifier for this job that can be used to check status.

Example:

"6ba7b810-9dad-11d1-80b4-00c04fd430c8"