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

Birefnet Background Removal

Интеграция

ID модели 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"

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

Получить API-ключ
BiRefNet Удаление фона #background-removal#segmentation#high-res#utility

Удаляет фон с одного изображения; доступны варианты light, heavy и portrait, а также необязательный вывод маски

BiRefNet · Изображение

Здесь появится ваш первый результат

Составьте запрос ниже и выполните его с помощью API-ключа. Результаты копируются в наше хранилище и хранятся навсегда или 7 дней бесплатно.

Сформировать запрос

Элементы управления сгенерированы из схемы модели. Код и цена обновляются при изменении параметров.

•обязательно image_url
Перетащите файл или

URL изображения, фон которого будет удалён.

Расширенные operating_resolution · output_format · model · output_mask · refine_foreground
operating_resolution по умолчанию 1024x1024

Разрешение обработки влияет на точность работы с исходными изображениями высокого разрешения; выбор большего разрешения повышает точность.

output_format по умолчанию png

Формат результирующего изображения.

по умолчанию General Use (Light)

Выбор модели удаления фона: 'General Use (Light)' соответствует BiRefNet-DIS_ep580.pth, является исходной моделью репозитория BiRefNet и рекомендуется для большинства задач. 'General Use (Heavy)' соответствует BiRefNet-massive-epoch_240.pth и обеспечивает более высокую точность при более медленной обработке. 'Portrait' соответствует BiRefNet-portrait-TR_P3M_10k-epoch_120.pth и обучена специально на портретных изображениях.

POST /run/birefnet?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?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"

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

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О Birefnet Background Removal

Выделяет передний план изображения, указанного через `image_url`, и возвращает его без фона. Параметр `model` поддерживает General Use (Light), General Use (Heavy) и Portrait. `operating_resolution` может быть 1024x1024 или 2048x2048 для изображений высокого разрешения. Маску можно вернуть через `output_mask`, выбрав формат png, webp или gif.

Параметры

Передавайте либо каноническое имя, либо исходное имя, но не оба. Канонические имена

ИмяТип По умолчаниюДопустимые значения Описание
modelнеобязательно
Типenum
По умолчаниюGeneral Use (Light)
General Use (Light)General Use (Heavy)Portrait
Выбор модели удаления фона: 'General Use (Light)' соответствует BiRefNet-DIS_ep580.pth, является исходной моделью репозитория BiRefNet и рекомендуется для большинства задач. 'General Use (Heavy)' соответствует BiRefNet-massive-epoch_240.pth и обеспечивает более высокую точность при более медленной обработке. 'Portrait' соответствует BiRefNet-portrait-TR_P3M_10k-epoch_120.pth и обучена специально на портретных изображениях.
operating_resolutionнеобязательно
Типenum
По умолчанию1024x1024
1024x10242048x2048
Разрешение обработки влияет на точность работы с исходными изображениями высокого разрешения; выбор большего разрешения повышает точность.
output_maskнеобязательно
Типboolean
По умолчаниюfalse
Определяет, включается ли маска удаления фона в выходные данные.
refine_foregroundнеобязательно
Типboolean
По умолчаниюtrue
Определяет уточнение переднего плана на основе рассчитанной маски.
image_urlобязательно image
Типurl · image
URL изображения, фон которого будет удалён.
output_formatнеобязательно
Типenum
По умолчаниюpng
webppnggif
Формат результирующего изображения.
обязательно Каноническое имя, также принимается

Параметры файлов принимают общедоступный https:// URL, data: URI размером до 10 MB или file_url загруженного файла. Файлы

Результат

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"
  }
}
Ваши файлы — ваш выборКаждый 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_image
object {url, content_type, file_name, file_size, width, height} | nullМаска, применённая при удалении фона.

Другие модели: Удаление фона

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/ru/developers/models/birefnet.md. Все модели и руководства: https://doitong.com/developers/llms.txt