# Bria Green Screen Background Removal

> Bria's chroma-key background removal via Fal.AI — removes the green-screen background from a video with automatic green-spill suppression, outputting on a transparent background (alpha-capable codecs) with clean, professional edges.

- **Provider**: fal
- **Model ID**: bria/video/background-removal/green-screen-despill
- **Category**: video_editing
- **Credits**: 1740 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `video_url` (string, **required**): Input video filmed on a green screen. MP4/MOV sources are billed by their measured length; other containers (e.g. webm) are billed at a flat 15-second assumption.
- `preserve_audio` (boolean, optional): If true, audio will be preserved in the output video. (Default: `True`)
- `spill_suppression` (number, optional): Strength of green-spill suppression. Higher values pull the green channel toward the red/blue average on green-dominant pixels, removing the green fringe around the subject. 0 disables it. (Default: `1`; Range: min: 0, max: 1)
- `output_container_and_codec` (string, optional): Output container and codec. Transparent (alpha) output requires an alpha-capable codec such as webm_vp9 or mov_proresks; codecs without alpha fall back to a black background (the response carries a warning). (Default: `webm_vp9`; Options: `mp4_h265`, `mp4_h264`, `webm_vp9`, `mov_h265`, `mov_proresks`, `mkv_h265`, `mkv_h264`, `mkv_vp9`, `gif`)

## Example Request

```json
{
  "model": "bria/video/background-removal/green-screen-despill",
  "input": {
    "video_url": "https://bria-datasets.s3.us-east-1.amazonaws.com/rmbg_tests/videos/green_screen_video.webm",
    "preserve_audio": true,
    "spill_suppression": 1,
    "output_container_and_codec": "webm_vp9"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

bria, video-editing, background-removal, green-screen, chroma-key

## Documentation

https://fal.ai/models/bria/video/background-removal/green-screen-despill