Video Background Removal

Submit a video background removal (fast) job

Start an asynchronous job that removes the background from a source video, keeping only the foreground subject. Faster generation; accepts source videos up to full HD (1080p).

Inputs

video_url — public URL of the source video
output_codec — optional; vp9 (the default) renders one WebM with an alpha channel, h264 renders two files (the RGB video and an alpha matte) and is recommended for better RGB quality
refine_foreground_edges — optional; improves the quality of the extracted subject's edges (defaults to true)
subject_is_person — optional; set to false when the subject is not a person (defaults to true)

What happens next

The job is accepted immediately — you get 202 Accepted with a job_id and status PROCESSING. Rendering runs in the background; poll GET /v1/video-background-removal-fast/{job_id} until the job is COMPLETED or FAILED.

post/v1/video-background-removal-fast

Headers

X-Veed-Store-IO'0' | '1'

Set to 0 to not store this request's and response's bodies. They will then not be available in your request logs for debugging. Defaults to 1 (stored).

X-Veed-Media-Expiration-Secondsinteger

Number of seconds before signed media URLs returned for this request expire. Defaults to 86400 (1 day).

Request body

$schemastring uri

A URL to the JSON Schema for this object.

output_codec'vp9' | 'h264'

Output encoding. vp9 (the default) yields a single webm video with an alpha channel; h264 yields two files (the RGB video and an alpha matte) and is recommended for better RGB quality.

refine_foreground_edgesboolean

Improves the quality of the extracted subject's edges.

subject_is_personboolean

Set to false when the subject is not a person.

video_urlstring uri required

URL of the source video to remove the background from.

Example request

{
  "$schema": "https://api.veed.io/schemas/VideoBackgroundRemovalInput.json",
  "output_codec": "vp9",
  "video_url": "https://media.veed.io/in.mp4"
}

Response

Accepted

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://api.veed.io/schemas/ResourceVideoBackgroundRemovalJob.json",
  "data": {
    "result": {
      "files": [
        {
          "content_type": "video/mp4"
        }
      ]
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.