PixMiller PixMiller
Главная / Интерфейс API / Руководство по переходу с API remove.bg
Руководство по переходу

Руководство по переходу с API remove.bg

Самообслуживаемый API remove.bg перестаёт принимать запросы 1 декабря 2026 года. Если вы вызываете его из собственного HTTP-кода, переход на PixMiller обычно сводится к смене базового URL и ключа — эта страница точно показывает, что переносится без изменений, что работает иначе и что не даёт эффекта.

Эндпоинт совместимости
POST api.pixmiller.com/v1.0/removebg
GET api.pixmiller.com/v1.0/account
Тот же заголовок X-Api-Key, что и в remove.bg. Прежде чем переключать трафик, прочитайте о различиях ниже.
1

Сначала прочитайте это

Четыре вещи, которые здесь не такие же.
  • size по умолчанию равен preview, как в remove.bg — но здесь preview это бесплатное изображение с водяным знаком до 640 px (remove.bg: 0.25 мегапикселя без водяного знака). Интеграция, которая никогда не задаёт size, будет получать превью с водяным знаком; передайте size=auto или платный уровень, чтобы получить результат без водяного знака.
  • Мы не заявляем о совместимости на уровне SDK. Три сторонних клиента — пакет removebg с PyPI, официальный npm-пакет remove.bg и removebg-cli — прошли наши тесты 22 сентября 2026 года, но мы не проводим для них регрессионное тестирование от релиза к релизу; мы поддерживаем путь с самостоятельно написанными HTTP-клиентами.
  • shadow_type, shadow_opacity, add_shadow и semitransparency принимаются и проверяются, но никогда не меняют результат — как в remove.bg для объектов, не являющихся автомобилями; отдельной модели для автомобилей здесь нет.
  • Каждый вызов засчитывается как одно изображение в лимит вашего ключа — 40 изображений в минуту (у remove.bg — 500). Обрабатывайте 429 с учётом Retry-After или напишите нам, чтобы повысить лимит.
2

До и после

Один и тот же запрос к каждому из сервисов.
remove.bg
1curl -X POST "https://api.remove.bg/v1.0/removebg" \2  -H "X-Api-Key: REMOVEBG_KEY" \3  -F "[email protected]" \4  -F "size=auto" \5  -o out.png
PixMiller
1curl -X POST "https://api.pixmiller.com/v1.0/removebg" \2  -H "X-Api-Key: PIXMILLER_KEY" \3  -F "[email protected]" \4  -F "size=auto" \5  -o out.png6# 200 OK → image bytes, written straight to out.png7# X-Credits-Charged: 1   X-Width: 1200   X-Height: 1600   X-Type: product
3

Поддержка параметров

Параметр Статус Примечания
image_file Так же Загрузка multipart. JPG / PNG / WebP, до 20 MB (remove.bg: 22 MB).
image_url Так же Публичный URL изображения, который мы загружаем на своей стороне с тем же лимитом 20 MB.
image_file_b64 Так же Изображение в base64 в теле запроса — так же, как в remove.bg.
size Отличается Те же значения, то же значение по умолчанию (preview) и те же ограничения по мегапикселям — но preview здесь это бесплатное изображение с водяным знаком до 640 px, а не 0.25 MP без водяного знака. medium / hd / 4k / full / 50MP стоят по 1 кредиту; auto использует платный уровень, пока на аккаунте есть кредиты.
format Так же auto / png / jpg / webp / zip — zip содержит color.jpg и alpha.png, как в remove.bg. Accept: application/json возвращает base64-конверт. Вывод PNG ограничен 10 мегапикселями.
type, type_level Отличается Принимается; type сопоставляется с нашими собственными моделями. X-Type возвращает грубый класс — person, product, animal, car или other — и type_level=2 / latest возвращают те же грубые классы.
crop, crop_margin Так же Обрезает по объекту с тем же синтаксисом отступов и тем же ограничением 50% / 500 px.
roi Так же Область интереса в пикселях или процентах — так же, как в remove.bg.
scale, position Так же Масштаб объекта (10%–100% или original) и позиция — так же, как в remove.bg.
channels Так же rgba (по умолчанию) или alpha — только маска.
bg_color Так же По умолчанию прозрачный; hex из 3 / 4 / 6 / 8 цифр с # или без него, либо название цвета.
bg_image_file, bg_image_url Так же Масштабируется так, чтобы закрыть весь вывод, и центрируется; нельзя сочетать с bg_color.
add_shadow, shadow_type, shadow_opacity Без эффекта Проверяется по значениям remove.bg, но тень никогда не отрисовывается.
semitransparency Без эффекта Принимается; полупрозрачные области всегда обрабатываются автоматически.
Каждый параметр проверяется по собственным диапазонам значений remove.bg, поэтому недопустимое значение даёт 400 invalid_parameter, а не тихо игнорируется — ровно так же, как отвечает remove.bg.
4

Что работает иначе

Код состояния 200 OK и байты изображения — так же, как в remove.bg: код, который проверяет == 200, продолжит работать. (Собственный эндпоинт PixMiller /api/v1/remove отвечает 201 и JSON; этот путь совместимости намеренно так не делает.)
Тело ответа Байты изображения — в точности как в remove.bg. Отправьте Accept: application/json, чтобы вместо этого получить base64-конверт remove.bg, или format=zip для color.jpg вместе с alpha.png.
Response headers X-Credits-Charged, X-Width, X-Height, X-Type, X-Foreground-Top / -Left / -Width / -Height и X-RateLimit-Limit / -Remaining / -Reset возвращаются все. X-Type — это грубый класс (person / product / animal / car / other), а не более детальный словарь remove.bg.
Ошибки Ошибки используют формат JSON:API от remove.bg: {"errors":[{"title":"…","code":"…"}]} — это массив, поэтому errors[0].title читается так же, как раньше. Отсутствующий ключ — это 403 auth_failed, неверный — 403 invalid_api_key, пустой баланс — 402, троттлинг — 429.
Кредиты preview бесплатен; каждый платный уровень стоит 1 кредит за изображение и списывается только после того, как результат получен, поэтому неудачный вызов никогда не стоит кредита. Ежемесячной бесплатной квоты нет.
Лимит частоты запросов 40 изображений в минуту на ключ (у remove.bg — 500). Каждый вызов засчитывается как одно изображение, и X-RateLimit-Limit / -Remaining / -Reset показывают именно эту квоту по изображениям; обрабатывайте 429 с учётом Retry-After.
5

Проверка баланса

Эндпоинт аккаунта сообщает остаток кредитов ключа в data.attributes.credits, поэтому проверка баланса, написанная под remove.bg, сохраняет свою форму. Ежемесячной бесплатной квоты нет, поэтому free_calls всегда равен 0.

GET /v1.0/account
1curl "https://api.pixmiller.com/v1.0/account" \2  -H "X-Api-Key: PIXMILLER_KEY"
6

Ошибки

400 invalid_parameter Значение вне диапазона remove.bg для size / format / crop / scale / … либо отсутствует источник изображения; в title указано, какой это параметр.
400 file_too_large Входное изображение превышает 20 MB.
400 unknown_foreground На изображении не удалось найти передний план.
402 insufficient_credits Запрошен платный уровень, но баланс пуст. Ничего не списывается.
403 auth_failed / invalid_api_key Заголовок X-Api-Key отсутствует (auth_failed) или неверен (invalid_api_key) — 403, как в remove.bg, а не 401.
429 rate_limit_exceeded Превышен лимит запросов. Повторите попытку после времени из заголовка Retry-After.
502 result_fetch_failed Не удалось получить результат из хранилища. Ничего не списано — повторите запрос.
Смысл несёт код состояния, а code использует собственный словарь remove.bg — switch по errors[0].code продолжит работать.
Перейдите на PixMiller, чтобы удалить фон Получите свой ключ API