Удалить фон API

Удаляет фон с изображения и возвращает результат с прозрачным фоном. Цена — от 0,5 до 6 ₽ за изображение, зависит от выбранной модели.

Нейросеть

Удалить фон API — Братуха.ру

Удалить фон API

Удаляет фон с изображения и возвращает результат с прозрачным фоном. Цена — от 0,5 до 6 ₽ за изображение, зависит от выбранной модели.

Нейросеть

API документация

Общая документация Public API · API-ключ можно создать в настройках аккаунта

Удалить фон API

Инструмент вырезает объект с фотографии и возвращает PNG с прозрачным фоном. Внутри пять моделей на выбор - от самой дешёвой для простых предметов на однородном фоне до самой точной для волос, меха и полупрозрачных краёв. Типичные задачи: карточки товаров для маркетплейсов, стикеры, аватарки, подготовка вырезок для коллажей и презентаций.

На вход - одна ссылка на изображение и название модели, на выходе - вырезанный объект. Каждый вызов создаёт асинхронную операцию: вы получаете id, а результат забираете отдельным запросом статуса.

Создание операции

Endpoint: POST /api/v1/operations
Авторизация: Authorization: Bearer brth_...
Запрос создаёт операцию и сразу возвращает id и стартовый статус queued.
Выполнение асинхронное: обычно 10-40 секунд.

Тело запроса

{
  "tool": "remove-background",
  "input": {
    "...": "..."
  }
}

tool - slug нейросети, здесь всегда "remove-background".
input - параметры конкретного запуска.
Все поля передаются напрямую внутри input, без дополнительного вложенного объекта input.

Параметры

Параметр	Тип	Обязательный	Описание
`image_url`	`string (url)`	Да	Фото, с которого убираем фон. Только `http/https`, форматы `.jpg`, `.jpeg`, `.png`.
`background_remove_model`	`enum`	Нет	Какой моделью вырезать: `feynobg` (0,5 ₽, простые предметы), `powerful_ai` (1 ₽), `ideogram` (2 ₽), `pixelcut` (3 ₽, используется, если не передать; хорошо справляется с людьми и товарами), `bria` (6 ₽, самая аккуратная на волосах, мехе и сложных краях).

Примеры запросов

Сценарий 1. Товар для маркетплейса

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "pixelcut"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "pixelcut"
    }
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        "tool": "remove-background",
        "input": {
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "background_remove_model": "pixelcut"
        }
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Сценарий 2. Сложные края: волосы и мех

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "bria"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "bria"
    }
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        "tool": "remove-background",
        "input": {
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "background_remove_model": "bria"
        }
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Сценарий 3. Дёшево и быстро для простого предмета

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "feynobg"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "feynobg"
    }
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        "tool": "remove-background",
        "input": {
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "background_remove_model": "feynobg"
        }
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Примеры ответов

Ответ после создания

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "remove-background",
  "cost": 3,
  "balance_after": 495,
  "created_at": "2026-09-17T12:00:00Z"
}

Ответ после завершения

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "remove-background",
  "cost": 3,
  "created_at": "2026-09-17T12:00:00Z",
  "completed_at": "2026-09-17T12:01:15Z",
  "result": {
    "type": "image",
    "urls": [
      "https://storage.bratuha.ru/results/remove-background/image-1.png"
    ]
  },
  "error_message": null
}

Ответ с ошибкой

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "remove-background",
  "cost": 3,
  "created_at": "2026-09-17T12:00:00Z",
  "completed_at": "2026-09-17T12:00:20Z",
  "result": null,
  "error_message": "Произошла ошибка, сервис временно недоступен. Попробуйте повторить запрос позже."
}

Проверка статуса

После создания операции сохраните id и проверяйте её статус запросом:

GET /api/v1/operations/{id}

cURL

curl -H "Authorization: Bearer brth_ваш_ключ" \
  https://bratuha.ru/api/v1/operations/op_uuid-123

JavaScript / TypeScript

const response = await fetch(
  'https://bratuha.ru/api/v1/operations/op_uuid-123',
  {
    headers: {
      Authorization: 'Bearer brth_ваш_ключ',
    },
  }
)

const data = await response.json()

Пока операция выполняется, status будет queued или processing. Опрашивайте статус раз в 5-10 секунд.

Формат результата

После успешного завершения result содержит одно изображение с прозрачным фоном:

{
  "type": "image",
  "urls": [
    "https://storage.bratuha.ru/results/remove-background/image-1.png"
  ]
}

type всегда равен "image".
urls содержит одну ссылку на PNG с альфа-каналом. Если вам нужен белый фон, подложите его сами при сохранении.

Ценообразование

Цена зависит только от выбранной модели background_remove_model:

Модель	Цена за изображение
`feynobg`	0,5 ₽
`powerful_ai`	1 ₽
`ideogram`	2 ₽
`pixelcut`	3 ₽
`bria`	6 ₽

Если модель не передана, используется pixelcut за 3 ₽.
Сумма списывается при создании операции и видна в поле cost ответа. Если операция завершилась с ошибкой, деньги возвращаются на баланс автоматически.

Ограничения и практические заметки

POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию и списывает деньги.
Операция выполняется асинхронно: после queued проверяйте статус по id.
Для файлов подходят только внешние http/https ссылки, без localhost и приватных адресов. HEIC/HEIF принимаются только при загрузке через форму сайта, по URL в API - нет.
Через API в одном запросе обрабатывается одно изображение. Для пакета фото отправляйте по запросу на файл.
Форматы .webp по URL инструмент не принимает: сконвертируйте файл в JPG или PNG перед запросом.
Начинайте с pixelcut: для большинства товаров и портретов этого достаточно. bria берите для волос, кружева, стекла и дыма, feynobg - для простых предметов на ровном фоне, где важна цена.
В поле tool ответа операции может стоять внутреннее имя модели, а не remove-background: это нормально, id и статус проверяются как обычно.

API документация

Общая документация Public API · API-ключ можно создать в настройках аккаунта

Удалить фон API

Инструмент вырезает объект с фотографии и возвращает PNG с прозрачным фоном. Внутри пять моделей на выбор - от самой дешёвой для простых предметов на однородном фоне до самой точной для волос, меха и полупрозрачных краёв. Типичные задачи: карточки товаров для маркетплейсов, стикеры, аватарки, подготовка вырезок для коллажей и презентаций.

На вход - одна ссылка на изображение и название модели, на выходе - вырезанный объект. Каждый вызов создаёт асинхронную операцию: вы получаете id, а результат забираете отдельным запросом статуса.

Создание операции

Endpoint: POST /api/v1/operations
Авторизация: Authorization: Bearer brth_...
Запрос создаёт операцию и сразу возвращает id и стартовый статус queued.
Выполнение асинхронное: обычно 10-40 секунд.

Тело запроса

{
  "tool": "remove-background",
  "input": {
    "...": "..."
  }
}

tool - slug нейросети, здесь всегда "remove-background".
input - параметры конкретного запуска.
Все поля передаются напрямую внутри input, без дополнительного вложенного объекта input.

Параметры

Параметр	Тип	Обязательный	Описание
`image_url`	`string (url)`	Да	Фото, с которого убираем фон. Только `http/https`, форматы `.jpg`, `.jpeg`, `.png`.
`background_remove_model`	`enum`	Нет	Какой моделью вырезать: `feynobg` (0,5 ₽, простые предметы), `powerful_ai` (1 ₽), `ideogram` (2 ₽), `pixelcut` (3 ₽, используется, если не передать; хорошо справляется с людьми и товарами), `bria` (6 ₽, самая аккуратная на волосах, мехе и сложных краях).

Примеры запросов

Сценарий 1. Товар для маркетплейса

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "pixelcut"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "pixelcut"
    }
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        "tool": "remove-background",
        "input": {
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "background_remove_model": "pixelcut"
        }
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Сценарий 2. Сложные края: волосы и мех

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "bria"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "bria"
    }
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        "tool": "remove-background",
        "input": {
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "background_remove_model": "bria"
        }
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Сценарий 3. Дёшево и быстро для простого предмета

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "feynobg"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "tool": "remove-background",
    "input": {
      "image_url": "https://cdn.example.com/source-image-1.jpg",
      "background_remove_model": "feynobg"
    }
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        "tool": "remove-background",
        "input": {
            "image_url": "https://cdn.example.com/source-image-1.jpg",
            "background_remove_model": "feynobg"
        }
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Примеры ответов

Ответ после создания

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "remove-background",
  "cost": 3,
  "balance_after": 495,
  "created_at": "2026-09-17T12:00:00Z"
}

Ответ после завершения

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "remove-background",
  "cost": 3,
  "created_at": "2026-09-17T12:00:00Z",
  "completed_at": "2026-09-17T12:01:15Z",
  "result": {
    "type": "image",
    "urls": [
      "https://storage.bratuha.ru/results/remove-background/image-1.png"
    ]
  },
  "error_message": null
}

Ответ с ошибкой

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "remove-background",
  "cost": 3,
  "created_at": "2026-09-17T12:00:00Z",
  "completed_at": "2026-09-17T12:00:20Z",
  "result": null,
  "error_message": "Произошла ошибка, сервис временно недоступен. Попробуйте повторить запрос позже."
}

Проверка статуса

После создания операции сохраните id и проверяйте её статус запросом:

GET /api/v1/operations/{id}

cURL

curl -H "Authorization: Bearer brth_ваш_ключ" \
  https://bratuha.ru/api/v1/operations/op_uuid-123

JavaScript / TypeScript

const response = await fetch(
  'https://bratuha.ru/api/v1/operations/op_uuid-123',
  {
    headers: {
      Authorization: 'Bearer brth_ваш_ключ',
    },
  }
)

const data = await response.json()

Пока операция выполняется, status будет queued или processing. Опрашивайте статус раз в 5-10 секунд.

Формат результата

После успешного завершения result содержит одно изображение с прозрачным фоном:

{
  "type": "image",
  "urls": [
    "https://storage.bratuha.ru/results/remove-background/image-1.png"
  ]
}

type всегда равен "image".
urls содержит одну ссылку на PNG с альфа-каналом. Если вам нужен белый фон, подложите его сами при сохранении.

Ценообразование

Цена зависит только от выбранной модели background_remove_model:

Модель	Цена за изображение
`feynobg`	0,5 ₽
`powerful_ai`	1 ₽
`ideogram`	2 ₽
`pixelcut`	3 ₽
`bria`	6 ₽

Если модель не передана, используется pixelcut за 3 ₽.
Сумма списывается при создании операции и видна в поле cost ответа. Если операция завершилась с ошибкой, деньги возвращаются на баланс автоматически.

Ограничения и практические заметки

POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию и списывает деньги.
Операция выполняется асинхронно: после queued проверяйте статус по id.
Для файлов подходят только внешние http/https ссылки, без localhost и приватных адресов. HEIC/HEIF принимаются только при загрузке через форму сайта, по URL в API - нет.
Через API в одном запросе обрабатывается одно изображение. Для пакета фото отправляйте по запросу на файл.
Форматы .webp по URL инструмент не принимает: сконвертируйте файл в JPG или PNG перед запросом.
Начинайте с pixelcut: для большинства товаров и портретов этого достаточно. bria берите для волос, кружева, стекла и дыма, feynobg - для простых предметов на ровном фоне, где важна цена.
В поле tool ответа операции может стоять внутреннее имя модели, а не remove-background: это нормально, id и статус проверяются как обычно.