Nodes/BRIA AI API nodes/Bria Video Remove Background
ComfyUI Node

Bria Video Remove Background

Cut the background out of a video without touching a GPU — Bria Video Remove Background

By Bria-AI·Created 2 years ago·Updated 3 months ago· 95
Bria Video Remove Background
    • result_video_url
    api_keyBRIA_API_TOKEN
    video_url
    preserve_audiotrue
    output_container_and_codecwebm_vp9
    background_colorBlack

    Removing a background from a video is where local tools quietly fall over: BiRefNet and friends are great on a single frame, but doing it for 300 frames and keeping the subject stable is a whole different job. This node skips the problem entirely by handing the clip to BRIA's cloud. You feed it a video, it returns a URL to a version with the background gone.

    It's part of the official BRIA AI API nodes pack, which is exactly what it sounds like - every node in it calls BRIA's hosted endpoints at engine.prod.bria-api.com rather than running a model locally. Your GPU does nothing, nothing gets downloaded to your models folder, and the trade-off is that you need a BRIA API token from platform.bria.ai. BRIA's whole pitch is that their models are trained on 100% licensed data, so if you're building a commercial product around cutouts, that licensing story is the reason you'd reach for this over a free local model.

    How it works

    The node takes a video_url - a public URL or a local file path. Local paths get uploaded to S3 through a presigned URL first, then the clip is POSTed to BRIA's /v2/video/edit/remove_background endpoint. The response gives you a status_url, and the node polls it every few seconds until the job says COMPLETED (video jobs can take a while, so the timeout is generous). The one output is result_video_url, a string pointing at the finished clip.

    Because the result is a URL and not a local file, you'll want to wire it into the Bria Preview Video node from the same pack to actually see it in ComfyUI.

    The inputs that matter

    • api_key - your BRIA token. The default is the literal placeholder BRIA_API_TOKEN, which the node rejects with "Please insert a valid API key." Change it before your first run.
    • video_url - the clip. Drag-and-drop works: a dropped file resolves to a path the node can upload.

    The two options worth touching:

    • background_color - defaults to Black, which trips people up. Set it to Transparent if you want an RGBA/transparent result instead of a solid color. The other choices are the usual suspects (White, Gray, the rainbow).
    • output_container_and_codec - defaults to webm_vp9. mp4_h264 is the safer bet for editing software and most pipelines; gif is there if you want an animated GIF.

    preserve_audio (on by default) keeps the sound track, which matters more than you'd think for real footage.

    Install and setup

    The pack installs normally - it has no requirements file and no model downloads, because there's nothing local to install. Either search "BRIA API" in ComfyUI Manager and hit install, or:

    cd path_to_comfyui/custom_nodes
    git clone https://github.com/Bria-AI/ComfyUI-BRIA-API.git
    

    Restart ComfyUI, grab a token at platform.bria.ai, and paste it into the node's api_key field.

    Gotchas

    The two failure modes people actually hit are the placeholder key (the error message tells you exactly what's wrong, so it's not hard to fix) and the default black background - if your output looks like a silhouette on a black void, you didn't pick Transparent. Also remember this is a paid API: every run costs a credit, so batch your experiments instead of tweaking one frame at a time. There's a ready-made workflow in the pack's workflows/ folder (Bria Video RMBG workflow.json) that wires Load Video → this node → Preview Video, which is the fastest way to see it working end to end.

    CategoryAPI Nodes

    Inputs (5)

    NameTypeDefaultDescription
    api_keySTRINGBRIA_API_TOKEN
    video_urlSTRINGURL of video to process (provide either frames or video_url)
    preserve_audiooptBOOLEANtrue
    output_container_and_codecoptCOMBOwebm_vp99 options: mp4_h264, mp4_h265, webm_vp9, mov_h265, mov_proresks, mkv_h264, +3
    background_coloroptCOMBOBlack11 options: Transparent, Black, White, Gray, Red, Green, +5

    Outputs (1)

    NameTypeDescription
    result_video_urlSTRING