콘텐츠로 건너뛰기

BiRefNet V2 Background Removal

통합

모델 id birefnet/v2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/birefnet/v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청: ≈$0.002 2 API 크레딧 이 페이지에서 실행

API 키 받기
BiRefNet 배경 제거 #cutout#matting#open-weights

최대 2304 px 해상도의 오픈 배경 제거 및 매팅 모델이며 선택적으로 마스크를 출력합니다.

BiRefNet · 이미지

첫 번째 결과가 여기에 표시됩니다

아래에서 요청을 작성하고 API 키로 실행하세요. 출력은 스토리지에 복사되며, 영구 보관하거나 7일 동안 무료로 보관할 수 있습니다.

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

•필수 image_url
파일을 끌어다 놓거나

배경을 제거할 이미지를 식별하는 URL입니다.

고급 operating_resolution · output_format · model · output_mask · refine_foreground · mask_only
operating_resolution 기본값 1024x1024

작업 해상도입니다. '2304x2304'는 'General Use (Dynamic)' 모델에서만 사용할 수 있습니다. 고해상도 입력 이미지에서는 설정을 높일수록 출력 정확도가 향상됩니다.

output_format 기본값 png

결과 이미지의 형식입니다.

기본값 General Use (Light)

배경 제거 모델 선택입니다. 'General Use (Light)'는 BiRefNet에 해당하며 BiRefNet 저장소의 원본 모델로 대부분의 용도에 권장됩니다. 'General Use (Light 2K)'는 BiRefNet_lite-2K에 해당하며 2K 이미지로 학습된 원본 모델을 사용합니다. 'General Use (Heavy)'는 BiRefNet_lite에 해당하며 처리 속도는 느리지만 정확도가 더 높습니다. 'Matting'은 BiRefNet-matting에 해당하며 이미지 매팅에 특화되어 학습되었습니다. 'Portrait'는 BiRefNet-portrait에 해당하며 인물 이미지에 특화되어 학습되었습니다. 'General Use (Dynamic)'는 BiRefNet_dynamic에 해당하며 256x256~2304x2304 범위의 가변 해상도를 지원합니다.

POST /run/birefnet/v2?wait=20 견적 → $0.002
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/birefnet/v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

BiRefNet V2 Background Removal 정보

BiRefNet V2는 여러 모델 변형(light, heavy, matting, portrait, dynamic)과 최대 2304x2304의 처리 해상도로 주제와 배경을 분리합니다. 잘라낸 이미지와 선택적으로 마스크를 PNG, WebP 또는 GIF 형식으로 반환합니다.

매개변수

표준 이름이나 네이티브 이름 중 하나만 보내세요. 표준 이름

이름유형 기본값허용됨 설명
model선택 사항
유형enum
기본값General Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
배경 제거 모델 선택입니다. 'General Use (Light)'는 BiRefNet에 해당하며 BiRefNet 저장소의 원본 모델로 대부분의 용도에 권장됩니다. 'General Use (Light 2K)'는 BiRefNet_lite-2K에 해당하며 2K 이미지로 학습된 원본 모델을 사용합니다. 'General Use (Heavy)'는 BiRefNet_lite에 해당하며 처리 속도는 느리지만 정확도가 더 높습니다. 'Matting'은 BiRefNet-matting에 해당하며 이미지 매팅에 특화되어 학습되었습니다. 'Portrait'는 BiRefNet-portrait에 해당하며 인물 이미지에 특화되어 학습되었습니다. 'General Use (Dynamic)'는 BiRefNet_dynamic에 해당하며 256x256~2304x2304 범위의 가변 해상도를 지원합니다.
operating_resolution선택 사항
유형enum
기본값1024x1024
1024x10242048x20482304x2304
작업 해상도입니다. '2304x2304'는 'General Use (Dynamic)' 모델에서만 사용할 수 있습니다. 고해상도 입력 이미지에서는 설정을 높일수록 출력 정확도가 향상됩니다.
output_mask선택 사항
유형boolean
기본값false
배경 제거 마스크를 출력에 포함할지 제어합니다.
refine_foreground선택 사항
유형boolean
기본값true
추정된 마스크를 기반으로 전경을 보정할지 제어합니다.
image_url필수 image
유형url · image
배경을 제거할 이미지를 식별하는 URL입니다.
output_format선택 사항
유형enum
기본값png
webppnggif
결과 이미지의 형식입니다.
mask_only선택 사항
유형boolean
기본값false
마스크만 출력하는 전환 옵션입니다. `True`이면 전경 보정을 건너뛰고 이미지를 변경하지 않은 채 분할 마스크만 반환합니다. 마스크만 필요할 때 추가 계산을 방지하고 전송 데이터를 줄일 수 있습니다.
필수 표준 이름, 사용 가능

파일 매개변수에는 공개 https:// URL, 최대 10 MB의 data: URI 또는 업로드의 file_url을 사용할 수 있습니다. 파일

출력

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "birefnet/v2",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 2,
    "usd": "0.002",
    "charged": 2,
    "refunded": 0
  },
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    },
    "mask_image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
image
object {url, content_type, file_name, file_size, width, height}배경 제거 후의 이미지이거나, `mask_only`가 `True`일 때는 분할 마스크입니다.
mask_image
object {url, content_type, file_name, file_size, width, height} | null배경 제거 중 적용된 마스크입니다.

더 많은 모델: 배경 제거

AI 에이전트용: 이 페이지의 Markdown 버전: https://doitong.com/ko/developers/models/birefnet/v2.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt