Перейти к содержимому

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.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"

Этот запрос: ≈0,002 $ 2 API-кредита · ≈ 0,21 ₽ Запустить на этой странице

Получить 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.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"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в 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, data: URI размером до 10 MB или 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой модели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/ru/developers/models/birefnet/v2.md. Все модели и руководства: https://doitong.com/developers/llms.txt