API remove.bg закрывается. Измените одну строку — код останется прежним.
Отдельный сайт remove.bg и его self-serve API прекращают работу . API переходит в Leonardo.Ai (компания Canva), и интеграцию придётся переделать (объявление Leonardo.Ai). removebackground.dev принимает те же запросы: направьте код на наш URL, используйте наш ключ — и всё готово.
Self-serve API remove.bg прекращает работу
Одна строка, которая меняется
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebgТот же заголовок X-Api-Key, но с вашим ключом removebackground.dev. Те же названия параметров, те же заголовки ответа, тот же формат ошибок {"errors": [...]}.
До и после
Типичная интеграция на четырёх языках. Ключ берётся из REMOVEBG_API_KEY, поэтому менять нужно только выделенный URL.
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://api.remove.bg/v1.0/removebg
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://removebackground.dev/v1.0/removebg
Используете Zapier, Make или n8n?
Откройте шаг HTTP-запроса, который вызывает remove.bg (Zapier Webhooks, Make HTTP, n8n HTTP Request), замените URL на https://removebackground.dev/v1.0/removebg, а значение X-Api-Key — на ваш ключ removebackground.dev. Все остальные поля оставьте как есть.
Совместимость параметров
Всё, что отправляет ваш запрос к remove.bg, принимается. Несколько параметров здесь ни на что не влияют — это указано ниже.
| Параметр | Статус | Примечания |
|---|---|---|
image_file / image_file_b64 / image_url | Поддерживается | Тело запроса multipart, urlencoded или JSON. JPG, PNG или WebP до 25 MB. |
size | Поддерживается | auto, full, 4k и 50MP дают исходное разрешение (до 25 MP); preview, small и regular ≈ 0,25 MP; medium 1,5 MP; hd 4 MP. Всегда 1 кредит. |
format | Поддерживается | auto (PNG при наличии прозрачности, иначе JPG), png, jpg, webp и zip (color.jpg + alpha.png). |
crop / crop_margin | Поддерживается | px или % от объекта, 1–4 значения в стиле CSS ("10% 20%" = по вертикали, по горизонтали); не более 500px или 50% с каждой стороны. |
roi | Поддерживается | "x1 y1 x2 y2" в px или %: сохраняется только объект внутри области. |
scale / position | Поддерживается | scale от 10% до 100% или original; position center, original или "x% y%". |
channels | Поддерживается | rgba (вырезанный объект) или alpha (маска в оттенках серого). |
bg_color | Поддерживается | Hex с # или без (81d4fa) либо название цвета. 8-значный hex сохраняет цвет и отбрасывает его альфа-канал. |
bg_image_url / bg_image_file | Поддерживается | Вырезанный объект накладывается на ваше фоновое изображение, растянутое по размеру вывода (cover). |
Accept: application/json | Поддерживается | Возвращает { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }. |
type / type_level | Принимается, игнорируется | Объект определяется автоматически; X-Type всегда "other". |
semitransparency | Принимается, игнорируется | Мягкие края и полупрозрачные области берутся из маски модели как есть. |
shadow_type / shadow_opacity / add_shadow | Принимается, игнорируется | Тени не добавляются. |
Долгие запросы | Отличие | Мы ждём до 110 секунд; если изображение к этому моменту не готово, вы получите 503, который можно повторить (без списания, если обработка не завершилась). |
Заголовки ответа
Успешный вызов возвращает байты изображения (image/png, image/jpeg, image/webp или application/zip) и эти заголовки. Отправьте Accept: application/json, чтобы вместо этого получить result_b64.
| Заголовок | Значение |
|---|---|
X-Width / X-Height | Размер результата в пикселях. |
X-Credits-Charged | Сколько кредитов потрачено на изображение: всегда 1 (неудачные — 0). |
X-Type | Всегда "other" (объект определяется автоматически). |
X-Foreground-Top / -Left / -Width / -Height | Ограничивающая рамка объекта на результате, в пикселях. |
X-Request-ID | Возвращает ваш X-Request-ID или сгенерированный id. Дополнительно. |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | Насколько чистая маска (0–1) и доля мягких пикселей. Дополнительно: полезно, чтобы отмечать изображения для проверки. |
Ошибки
| Статус | Значение |
|---|---|
400 | Неверный параметр или изображение (коды вроде invalid_size, invalid_crop_margin, missing_source, file_too_large, unknown_foreground). |
402 | insufficient_credits: пополните баланс на странице цен. |
403 | auth_failed: X-Api-Key отсутствует или недействителен. |
429 | rate_limit_exceeded. |
500 / 503 | Обработка не удалась, истекло время ожидания или сервис ненадолго недоступен. Повторите запрос; неудачные изображения бесплатны. |
Проверить баланс можно через GET https://removebackground.dev/v1.0/account: ответ имеет формат аккаунта remove.bg. Подробности — в справочнике API.
Кредиты: 1 за изображение, и они не сгорают
Каждое успешное изображение стоит 1 кредит, независимо от размера и параметров. Неудачные изображения бесплатны. Новые аккаунты получают бесплатные кредиты для тестов: 50.
- Кредиты не сгораютПополните один раз — используйте через неделю или через год.
- Без подпискиРазовые наборы. Ничего не продлевается.
- Неудачные изображения бесплатныКредит списывается, только если фон удалён.
Чек-лист перехода
- Получите API-ключ removebackground.devЗарегистрируйтесь (50 бесплатных кредитов) и создайте ключ на странице аккаунта.
- Измените одну строкуНаправьте код на https://removebackground.dev/v1.0/removebg и передайте новый ключ в том же заголовке X-Api-Key.
- Протестируйте одно изображениеОтправьте один реальный запрос и сравните результат с тем, что получаете сейчас.
- Переключите трафикВыполните деплой до 1 декабря 2026 г. в 09:00 CET. Пополните кредиты один раз — они не сгорают.
Вопросы о переходе с remove.bg
remove.bg закрывается?
Отдельный сайт remove.bg и его self-serve API прекращают работу 1 декабря 2026 г. в 09:00 CET. API переходит в Leonardo.Ai (компания Canva), и интеграцию придётся переделать. Источник: объявление Leonardo.Ai по адресу https://www.leonardo.ai/news/removebg-api-leonardo.
Какая самая простая замена API remove.bg?
У removebackground.dev есть эндпоинт, совместимый с remove.bg. Замените https://api.remove.bg/v1.0/removebg на https://removebackground.dev/v1.0/removebg, передайте ключ removebackground.dev в том же заголовке X-Api-Key и оставьте остальной код без изменений: названия параметров, заголовки ответа и формат ошибок совпадают.
Нужно ли переписывать интеграцию до декабря 2026 года?
Нет. Запросы используют те же параметры (image_file, image_url, size, format, crop, bg_color…) и получают такой же ответ: байты изображения с заголовками X-Width, X-Height и X-Foreground-* или JSON с result_b64. Меняются только URL и ключ.
Это работает с Zapier, Make или n8n?
Да. В шаге HTTP-запроса (Zapier Webhooks, Make HTTP, n8n HTTP Request) замените URL на https://removebackground.dev/v1.0/removebg, а значение X-Api-Key — на ваш ключ removebackground.dev. Больше ничего менять не нужно.
Сколько это стоит?
1 кредит за каждое успешное изображение, независимо от размера и параметров. Без подписки: разовые пополнения на 17 $, 49 $ или 99 $, а кредиты не сгорают. Неудачные изображения бесплатны. Новые аккаунты получают бесплатные кредиты: 50.
Какие параметры remove.bg поддерживаются?
image_file, image_file_b64, image_url, size, format (auto, png, jpg, webp, zip), crop, crop_margin, roi, scale, position, channels, bg_color, bg_image_url и bg_image_file. type, type_level, semitransparency и параметры теней принимаются и игнорируются, поэтому запросы с ними продолжают работать.
Можно ли проверять баланс, как раньше?
Да. GET https://removebackground.dev/v1.0/account с вашим ключом возвращает кредиты в формате аккаунта remove.bg.
removebackground.dev связан с remove.bg?
Нет. remove.bg — товарный знак его владельца. removebackground.dev — независимый сервис, который принимает те же API-запросы.
Перейдите до 1 декабря 2026 г. в 09:00 CET
Self-serve API remove.bg прекращает работу
Создайте ключ, измените одну строку, протестируйте одно изображение. Бесплатные кредиты в подарок: 50.
remove.bg — товарный знак его владельца; removebackground.dev с ним не связан.