콘텐츠로 건너뛰기

Birefnet

통합

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

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

실행당 최대 $2.07 실제 사용량에 따라 과금되며 나머지는 환불됩니다 이 페이지에서 실행

API 키 받기
BiRefNet 배경 제거 #utility#editing

6가지 모델 선택, 매팅, mp4, webm, mov 또는 gif 출력을 지원해 동영상 배경을 제거합니다

BiRefNet · 동영상

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

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

요청 만들기

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

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

배경을 제거할 동영상을 식별하는 URL입니다.

고급 operating_resolution · video_output_type · video_quality · video_write_mode · model · output_mask · refine_foreground
operating_resolution 기본값 1024x1024

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

video_output_type 기본값 X264 (.mp4)

결과 동영상의 출력 유형입니다.

video_quality 기본값 high

결과 동영상의 품질 수준입니다.

video_write_mode 기본값 balanced

결과 동영상의 기록 모드입니다.

기본값 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/video?wait=20 견적 → $2.07
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/birefnet/v2/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

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

이 요청 실행

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

Birefnet 정보

`video_url`의 동영상 각 프레임에 BiRefNet 세그멘테이션을 적용합니다. 모델에는 Light, Light 2K, Heavy, Matting, Portrait 및 Dynamic이 포함되며, 작동 해상도는 최대 2304x2304입니다(Dynamic 모델만 해당). 출력은 X264 mp4, VP9 webm, ProRes 4444 mov 또는 GIF로 지정할 수 있으며 `video_quality` 및 `video_write_mode` 설정을 지원합니다. 별도의 마스크 동영상도 요청할 수 있습니다.

매개변수

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

이름유형 기본값허용됨 설명
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
추정된 마스크를 기반으로 전경을 보정할지 제어합니다.
video_url필수 video
유형url · video
배경을 제거할 동영상을 식별하는 URL입니다.
video_output_type선택 사항
유형enum
기본값X264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
결과 동영상의 출력 유형입니다.
video_quality선택 사항
유형enum
기본값high
lowmediumhighmaximum
결과 동영상의 품질 수준입니다.
video_write_mode선택 사항
유형enum
기본값balanced
fastbalancedsmall
결과 동영상의 기록 모드입니다.
필수 표준 이름, 사용 가능

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

출력

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "birefnet/v2/video",
  "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": 2070,
    "usd": "2.07",
    "charged": 2070,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "mask_video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}배경 제거 후의 동영상입니다.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | null배경 제거 중 적용된 마스크입니다.

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