# Bria Green Screen Background Removal - Core.Today AI API

> 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**: Bria
- **Model ID**: bria/video/background-removal/green-screen-despill
- **Category**: Video Generation
- **Credits**: 1740 per 15s video — billed per second of the source video (116/s)
- **Speed**: Fast
- **Quality**: High

## Features
- Chroma-key background removal with transparent output on alpha-capable codecs
- Automatic green-spill suppression removes the green fringe around subjects
- Nine output container/codec options including webm_vp9, mov_proresks, mp4, mkv, gif
- Preserves the source audio track (optional)
- Adjustable spill-suppression strength (0-1)

## Use Cases
- Compositing green-screen footage over new backgrounds
- Transparent WebM/ProRes assets for video editors and motion graphics
- UGC and studio talking-head cutouts for ads
- Streaming overlays and virtual-set production
- Animated GIF cutouts from green-screen clips

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **video_url**: string - Input video filmed on a green screen. MP4/MOV sources are billed by measured length; other containers (e.g. webm) are billed at a flat 15-second assumption

### Optional
- **output_container_and_codec**: string (default: webm_vp9) - Output container and codec. Transparency requires an alpha-capable codec (webm_vp9, mov_proresks); others fall back to a black background with a warning
  Options: mp4_h265, mp4_h264, webm_vp9, mov_h265, mov_proresks, mkv_h265, mkv_h264, mkv_vp9, gif
- **preserve_audio**: boolean (default: true) - If true, audio will be preserved in the output video
- **spill_suppression**: number (default: 1) - Strength of green-spill suppression (0-1). Higher values remove the green fringe around the subject; 0 disables it

## Examples

### Transparent WebM Cutout
Remove the green screen and keep a transparent background
```json
{
  "model": "bria/video/background-removal/green-screen-despill",
  "input": {
    "video_url": "https://example.com/green_screen_video.webm",
    "output_container_and_codec": "webm_vp9",
    "preserve_audio": true,
    "spill_suppression": 1
  }
}
```

### ProRes for Editing Pipelines
Alpha-capable MOV output for professional NLEs
```json
{
  "model": "bria/video/background-removal/green-screen-despill",
  "input": {
    "video_url": "https://example.com/interview_take.mp4",
    "output_container_and_codec": "mov_proresks",
    "preserve_audio": true
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Keep webm_vp9 or mov_proresks for transparency — mp4/mkv codecs cannot carry alpha and fall back to a black background (the response includes a warning)
- Billing follows the source video's length — trim the source to the segment you need before uploading
- Prefer MP4/MOV sources so billing uses the measured length; other containers are billed at a flat 15-second assumption
- Lower spill_suppression if fine details (hair, translucent objects) lose color; raise it if a green fringe remains

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