Fal.AI를 통해 제공되는 Bria의 크로마키 배경 제거 모델입니다. 그린스크린으로 촬영된 영상의 배경을 제거하고 그린 스필(초록 번짐)을 자동 억제해, 알파 지원 코덱에서는 투명 배경으로 깔끔하고 전문적인 엣지의 결과물을 출력합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"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
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
video_url | string | Yes | - | 그린스크린으로 촬영된 입력 비디오. MP4/MOV는 실측 길이로 과금, 그 외 컨테이너(webm 등)는 15초 고정 가정으로 과금됩니다 |
output_container_and_codec | string | No | webm_vp9 | 출력 컨테이너·코덱. 투명 배경은 알파 지원 코덱(webm_vp9, mov_proresks)이 필요하며, 미지원 코덱은 검정 배경으로 대체되고 warning이 반환됩니다 mp4_h265mp4_h264webm_vp9mov_h265mov_proresksmkv_h265mkv_h264mkv_vp9gif |
preserve_audio | boolean | No | true | true면 출력 비디오에 오디오가 보존됩니다 |
spill_suppression | number | No | 1 | 그린 스필 억제 강도 (0~1). 높을수록 피사체 주변 초록 번짐을 강하게 제거하며 0이면 비활성화됩니다 |
이 모델의 video_url 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "bria/video/background-removal/green-screen-despill",
"input": {
"prompt": "your prompt here",
"video_url": "https://example.com/image.jpg"
}
}POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 없는 대신, 파일이 API 서버를 거치므로 요청 전체 10MB 제한이 적용됩니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=bria/video/background-removal/green-screen-despill" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:video_url=@your_file.png"POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
그린스크린을 제거하고 투명 배경을 유지
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"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
}
}'전문 편집 툴을 위한 알파 지원 MOV 출력
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"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
}
}'