Przejdź do treści

Birefnet Background Removal

Integracja

Identyfikator modelu birefnet
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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"

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

Uzyskaj klucz API
BiRefNet Usuwanie tła #background-removal#segmentation#high-res#utility

Usuwa tło z pojedynczego obrazu, oferując warianty Light, Heavy i Portrait oraz opcjonalne wyjście 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
operating_resolution domyślnie 1024x1024

Rozdzielczość przetwarzania wpływa na dokładność w przypadku obrazów źródłowych o wysokiej rozdzielczości; wyższa wartość ją zwiększa.

output_format domyślnie png

Format wynikowego obrazu.

domyślnie General Use (Light)

Wybór modelu usuwania tła: 'General Use (Light)' odpowiada BiRefNet-DIS_ep580.pth, czyli oryginalnemu modelowi z repozytorium BiRefNet, zalecanemu do większości zastosowań. 'General Use (Heavy)' odpowiada BiRefNet-massive-epoch_240.pth i zapewnia większą dokładność kosztem wolniejszego przetwarzania. 'Portrait' odpowiada BiRefNet-portrait-TR_P3M_10k-epoch_120.pth i jest trenowany specjalnie na obrazach portretowych.

POST /run/birefnet?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.com/v1/run/birefnet?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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"

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 Background Removal

Segmentuje pierwszy plan obrazu podanego przez `image_url` i zwraca go z usuniętym tłem. Opcja `model` udostępnia General Use (Light), General Use (Heavy) lub Portrait. `operating_resolution` może mieć wartość 1024x1024 lub 2048x2048 dla wejść o wyższej rozdzielczości. Maskę można również zwrócić za pomocą `output_mask`, wybierając wyjście 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 (Heavy)Portrait
Wybór modelu usuwania tła: 'General Use (Light)' odpowiada BiRefNet-DIS_ep580.pth, czyli oryginalnemu modelowi z repozytorium BiRefNet, zalecanemu do większości zastosowań. 'General Use (Heavy)' odpowiada BiRefNet-massive-epoch_240.pth i zapewnia większą dokładność kosztem wolniejszego przetwarzania. 'Portrait' odpowiada BiRefNet-portrait-TR_P3M_10k-epoch_120.pth i jest trenowany specjalnie na obrazach portretowych.
operating_resolutionopcjonalne
Typenum
Domyślne1024x1024
1024x10242048x2048
Rozdzielczość przetwarzania wpływa na dokładność w przypadku obrazów źródłowych o wysokiej rozdzielczości; wyższa wartość ją zwiększa.
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.
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",
  "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_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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"
  }
}
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.
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.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt