Уже клиент? Войти
Самообслуживаемый API remove.bg перестаёт принимать запросы 1 декабря 2026 года. Если вы вызываете его из собственного HTTP-кода, переход на PixMiller обычно сводится к смене базового URL и ключа — эта страница точно показывает, что переносится без изменений, что работает иначе и что не даёт эффекта.
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
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
| Параметр | Статус | Примечания |
|---|---|---|
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
|
Без эффекта | Принимается; полупрозрачные области всегда обрабатываются автоматически. |
Эндпоинт аккаунта сообщает остаток кредитов ключа в data.attributes.credits, поэтому проверка баланса, написанная под remove.bg, сохраняет свою форму. Ежемесячной бесплатной квоты нет, поэтому free_calls всегда равен 0.
1curl "https://api.pixmiller.com/v1.0/account" \2 -H "X-Api-Key: PIXMILLER_KEY"
invalid_parameter
Значение вне диапазона remove.bg для size / format / crop / scale / … либо отсутствует источник изображения; в title указано, какой это параметр.
file_too_large
Входное изображение превышает 20 MB.
unknown_foreground
На изображении не удалось найти передний план.
insufficient_credits
Запрошен платный уровень, но баланс пуст. Ничего не списывается.
auth_failed / invalid_api_key
Заголовок X-Api-Key отсутствует (auth_failed) или неверен (invalid_api_key) — 403, как в remove.bg, а не 401.
rate_limit_exceeded
Превышен лимит запросов. Повторите попытку после времени из заголовка Retry-After.
result_fetch_failed
Не удалось получить результат из хранилища. Ничего не списано — повторите запрос.
Вы уверены, что хотите выйти?