Extract a mask from a video
Separate the foreground of a video from its background. On completion, the result contains two files:
matte_video_url: a grayscale mask (alpha matte) MP4. White is foreground, black is transparent, and shades of gray are partly transparent.cutout_video_url: the input video with the mask as its alpha channel, as a ProRes 4444.movwith straight (not premultiplied) alpha, ready to composite. ProRes files are large: roughly 42 MB per second of video at 1080p and 172 MB per second at 4K.
Both files have the same frames as the input, one for one. They have the input’s resolution (an odd width or height is rounded down to an even number) and the input’s frame rate, rounded to a whole number. They have no audio.
Responds immediately with the job id and created_at timestamp. Poll GET /v2/video-alpha-gen/{id} until the status is completed.
Requests that violate the content policy fail the job with content_filtered_error. An account without enough credit fails the same way, with insufficient_funds_error.
Billed per second of input video. See Pricing.
Authentication
Request
Input video in HTTPS URL or base64 data URI format. See Input Formats for supported formats and codecs.
Max 3,072 frames (e.g. about 2 minutes at 24fps, or about 1 minute 42 seconds at 30fps) and 200 MB (data URIs have a lower limit). The long side can be up to 3840 pixels and the short side up to 2160 pixels, so 4K video is accepted in landscape (3840×2160) or portrait (2160×3840). The long side can be at most 32:9 times the short side (e.g. 3840×1080). The frame rate must be at least 1 fps.