Мазмұнға өту

BiRefNet V2 Background Removal

Интеграциялау

Модель идентификаторы 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 моделіне сәйкес келеді және көп жағдайда ұсынылады. '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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана 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 моделіне сәйкес келеді және көп жағдайда ұсынылады. '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 — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 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/kk/developers/models/birefnet/v2.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt