1 кредит за вызов
API удаления фона
Убирайте фон с изображений программно одним POST-запросом. Один ключ API, прозрачный PNG на выходе и сервис без состояния, который никогда не хранит отправленные изображения.
- REST · JSON
- Без водяного знака
- Ничего не хранится
POST /v1/remove-background
Что такое API удаления фона?
API удаления фона ImgGen AI — это REST-эндпоинт, который отделяет объект на переднем плане от фона фотографии и возвращает прозрачный PNG. Вы загружаете изображение по HTTPS, ИИ определяет объект автоматически, и вырезанный результат приходит в JSON-ответе в кодировке base64. Ни маска, ни ручное выделение не нужны.
Это один из семи эндпоинтов API редактирования изображений ImgGen AI: у всех общий ключ API, общий базовый URL и одинаковый формат запроса и ответа. Если эта возможность нужна вам ещё и в браузере, а не только из кода, — та же модель ИИ работает в инструменте Background Remover.
Параметры запроса
Отправьте POST-запрос на https://app.imggen.ai/v1/remove-background с аутентификацией по ключу API в заголовке Authorization.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
| image | file | ОБЯЗАТЕЛЬНЫЙ | — | The input image to process. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
Как встроить API удаления фона?
Создайте ключ API в аккаунте ImgGen, сохраните его в переменной окружения и вызовите эндпоинт. Вот один и тот же запрос на cURL, Node.js и Python.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))Ответ
Успешный вызов возвращает JSON. Результат приходит в кодировке base64 — декодируйте его перед записью на диск или в объектное хранилище. Каждый успешный ответ также содержит заголовок X-Credit-Remaining с вашим балансом после вызова.
{
"success": true,
"message": "Background removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}Ограничения и поведение, о которых стоит знать
Эндпоинт принимает JPEG (JPG), PNG и WebP с максимальным размером файла 25 МБ и отвечает синхронно в пределах 60 секунд — не нужно опрашивать задачу и настраивать вебхук.
Прозрачный PNG на выходе
Результат возвращается с настоящим альфа-каналом, поэтому его можно наложить на любой фон, цвет или шаблон без второго запроса.
Маска не нужна
Объект определяется автоматически — передний план отделяется от фона за вас. Ничего не нужно закрашивать, обводить или передавать вторым параметром: отправьте исходное изображение и прочитайте результат.
Ничего не хранится
Исходник лежит во временном объекте только на время вызова и удаляется после. Удобно, когда вы обрабатываете фотографии клиентов, которые не имеете права хранить.
Для чего используют API удаления фона?
Где команды используют этот эндпоинт в продакшене, чтобы обрабатывать изображения программно и в больших объёмах.
Каталоги интернет-магазинов
Убирайте фон с товарных изображений поставщиков прямо при загрузке, чтобы в каждой карточке был чистый и однородный вырез — без ручного этапа редактирования.
Маркетплейсы и объявления
Приводите фотографии продавцов к единому виду автоматически. Пропускайте каждую загрузку через эндпоинт и сохраняйте прозрачный PNG рядом с оригиналом.
Печать по требованию
Выделяйте макеты и объекты до наложения на мокапы, чтобы превью корректно отрисовывались при любом размере товара.
SaaS для дизайна и редактирования
Дайте пользователям удаление фона в один клик внутри вашего продукта, не обучая модель, не размещая её и не запуская собственный инференс в AWS или где-либо ещё.
Сколько стоит API удаления фона?
Каждый успешный вызов стоит 1 кредит, поэтому фактическая стоимость изображения зависит от вашего тарифа. Кредиты берутся из вашего тарифа и общие для всех эндпоинтов и веб-редактора, так что отдельную квоту на каждый инструмент покупать не нужно. Неудачный вызов возвращается автоматически. Все подробности — на странице тарифов.
| Тариф | Цена | Кредиты | API |
|---|---|---|---|
| Free | $0 | 50 бесплатных кредитов единоразово | Без доступа к API |
| Starter | $9.99 / month | 400 кредитов / месяц | Доступ к API включён |
| Pro | $29.99 / month | 1 400 кредитов / месяц | Доступ к API + приоритетная поддержка |
| Enterprise | Custom | Индивидуальный объём | Выделенная инфраструктура |
Стоимость в кредитах и лимиты последний раз проверены 2026-08-27.
Связанные эндпоинты и инструменты
Команды, которые используют API удаления фона, обычно следом берут эти.
Также доступны: Увеличение разрешения, Реставрация фотографий, Колоризация фотографий, Генерация изображений.
Вопросы об API удаления фона
- Это HTTP-эндпоинт, который принимает фотографию и возвращает её же с удалённым фоном и сохранённым объектом на прозрачном слое. Поскольку это API, а не редактор, вызывать его можно из фоновой задачи, воркера очереди или обработчика пользовательских загрузок и обрабатывать тысячи изображений без того, чтобы кто-то открывал браузер.
- Создайте ключ API в аккаунте ImgGen и отправьте POST-запросом multipart-форму с полем image на https://app.imggen.ai/v1/remove-background с заголовком Authorization: Bearer. Ответ придёт в JSON; декодируйте поле image из base64 и запишите его на диск или в объектное хранилище. Рабочие примеры на cURL, Node.js и Python есть на этой странице.
- Один кредит за успешный вызов — самый дешёвый эндпоинт в API. В Starter входит 400 кредитов в месяц за 9,99 $, то есть примерно 400 удалений фона, а в Pro — 1 400 за 29,99 $. Неиспользованные кредиты переносятся, пока подписка активна, а неудачные вызовы возвращаются автоматически, так что вы платите только за изображения, которые вернулись.
- Вы можете создать аккаунт и попробовать ИИ-инструменты с 50 бесплатными кредитами без привязки карты. Доступ к API входит в платные тарифы Starter и Pro; постоянного бесплатного уровня API нет, и мы предпочитаем сказать это прямо, а не рекламировать тот, который затем незаметно ограничит вас.
- API принимает файлы JPEG (JPG), PNG и WebP размером до 25 МБ на изображение. Результат возвращается в JSON-ответе в виде изображения в кодировке base64.
- Нет. API не хранит состояние: он не создаёт проект, не сохраняет файл и не оставляет у себя ваше изображение. Загруженный файл записывается во временный объект, обрабатывается и удаляется сразу после отправки ответа. Сохраняется только запись в журнале использования о том, что вызов состоялся и сколько кредитов он стоил. Ваши изображения никогда не используются для обучения моделей.
- Да. Все тарифы, включая бесплатный, дают полные коммерческие права на использование, и ни один результат не содержит водяного знака. Всё, что возвращает API, вы можете продавать, печатать или публиковать.
- Эндпоинт возвращает прозрачный PNG, поэтому наложение нового цвета, градиента или задника вы делаете в своём конвейере — второй вызов API не нужен. В веб-редакторе ImgGen также есть генератор фонов, если вам нужны задники, созданные ИИ, а не собственные материалы.
Начать
Начните вызывать API удаления фона
Один ключ открывает все семь эндпоинтов. Без водяного знака, с полными коммерческими правами, и ничто из отправленного вами не сохраняется после возврата ответа.
Получить ключ API