Sign in
Video Background Removal

Submit a video background removal (green screen) job

Start an asynchronous job that keys the green screen out of a source video, keeping only the foreground subject. For footage shot against a green screen: the backdrop is keyed out rather than segmented, which is faster and cleaner than the segmenting models when a green screen is available.

Inputs

  • video_url — public URL of the source video, shot against a green screen
  • 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
  • spill_suppression_strength — optional; how strongly green cast is removed from the kept subject, between 0 and 1 (defaults to 0.8). Raise it when green spots remain, lower it when colours shift on the subject

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-green-screen/{job_id} until the job is COMPLETED or FAILED.

post/v1/video-background-removal-green-screen

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.

spill_suppression_strengthnumber double

How strongly green cast is removed from the kept subject. Raise it when green spots remain, lower it when colours shift on the subject.

video_urlstring uri required

URL of the source video, shot against a green screen.

Example request

{
  "$schema": "https://api.veed.io/schemas/VideoBackgroundRemovalGreenScreenInput.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.