Przejdź do treści

BiRefNet V2 Background Removal

Integracja

Identyfikator modelu birefnet/v2
# 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?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

To żądanie: ≈0,002 $ 2 kredyty API · ≈ 0,21 ₽ Uruchom na tej stronie

Uzyskaj klucz API
BiRefNet Usuwanie tła #cutout#matting#open-weights

Usuwanie tła i matowanie obrazu do 2304 px, z opcjonalnym wyjściem maski.

BiRefNet · Obraz

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane image_url
Upuść plik lub

URL obrazu, którego tło zostanie usunięte.

Zaawansowane operating_resolution · output_format · model · output_mask · refine_foreground · mask_only
operating_resolution domyślnie 1024x1024

Rozdzielczość robocza; '2304x2304' jest dostępna wyłącznie dla modelu 'General Use (Dynamic)'. W przypadku danych wejściowych o wysokiej rozdzielczości wyższe ustawienia poprawiają dokładność wyniku.

output_format domyślnie png

Format wynikowego obrazu.

domyślnie General Use (Light)

Wybór modelu usuwania tła: 'General Use (Light)' wskazuje BiRefNet, oryginalny model z repozytorium BiRefNet, zalecany do większości zastosowań. 'General Use (Light 2K)' wskazuje BiRefNet_lite-2K, oryginalny model trenowany na obrazach 2K. 'General Use (Heavy)' wskazuje BiRefNet_lite i zapewnia większą dokładność kosztem wolniejszego przetwarzania. 'Matting' wskazuje BiRefNet-matting, trenowany specjalnie do matowania obrazów. 'Portrait' wskazuje BiRefNet-portrait, trenowany specjalnie na obrazach portretowych. 'General Use (Dynamic)' wskazuje BiRefNet_dynamic i obsługuje rozdzielczości od 256x256 do 2304x2304.

POST /run/birefnet/v2?wait=20 wycena → 0,002 $
# 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?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o BiRefNet V2 Background Removal

BiRefNet V2 oddziela obiekt od tła za pomocą kilku wariantów modelu (light, heavy, matting, portrait, dynamic) oraz rozdzielczości roboczych do 2304x2304. Zwraca wycięty obiekt i opcjonalnie maskę w formatach PNG, WebP lub GIF.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
modelopcjonalne
Typenum
DomyślneGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Wybór modelu usuwania tła: 'General Use (Light)' wskazuje BiRefNet, oryginalny model z repozytorium BiRefNet, zalecany do większości zastosowań. 'General Use (Light 2K)' wskazuje BiRefNet_lite-2K, oryginalny model trenowany na obrazach 2K. 'General Use (Heavy)' wskazuje BiRefNet_lite i zapewnia większą dokładność kosztem wolniejszego przetwarzania. 'Matting' wskazuje BiRefNet-matting, trenowany specjalnie do matowania obrazów. 'Portrait' wskazuje BiRefNet-portrait, trenowany specjalnie na obrazach portretowych. 'General Use (Dynamic)' wskazuje BiRefNet_dynamic i obsługuje rozdzielczości od 256x256 do 2304x2304.
operating_resolutionopcjonalne
Typenum
Domyślne1024x1024
1024x10242048x20482304x2304
Rozdzielczość robocza; '2304x2304' jest dostępna wyłącznie dla modelu 'General Use (Dynamic)'. W przypadku danych wejściowych o wysokiej rozdzielczości wyższe ustawienia poprawiają dokładność wyniku.
output_maskopcjonalne
Typboolean
Domyślnefalse
Określa, czy maska usuwania tła jest dołączana do wyniku.
refine_foregroundopcjonalne
Typboolean
Domyślnetrue
Określa udoskonalanie pierwszego planu na podstawie oszacowanej maski.
image_urlwymagane image
Typurl · image
URL obrazu, którego tło zostanie usunięte.
output_formatopcjonalne
Typenum
Domyślnepng
webppnggif
Format wynikowego obrazu.
mask_onlyopcjonalne
Typboolean
Domyślnefalse
Przełącznik wyniku zawierającego wyłącznie maskę: `True` pomija udoskonalanie pierwszego planu i pozostawia obraz bez zmian, zwracając tylko jego maskę segmentacji. Gdy potrzebna jest sama maska, ogranicza to obliczenia i ilość przesyłanych danych.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
image
object {url, content_type, file_name, file_size, width, height}Obraz po usunięciu tła lub maska segmentacji, gdy `mask_only` ma wartość `True`.
mask_image
object {url, content_type, file_name, file_size, width, height} | nullMaska zastosowana podczas usuwania tła.

Więcej modeli: Usuwanie tła

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/birefnet/v2.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt