API удаления фона

Переход с remove.bg

remove.bg объявил, что его самостоятельный сервис закрывается 1 декабря 2026 года и в тот же день прекращает принимать запросы самообслуживаемый API, который переходит в Leonardo.Ai. Если ваш код обращается к api.remove.bg, направьте его сюда:

Заголовок остаётся X-Api-Key, поля называются так же, ошибки — в формате remove.bg, поэтому клиентские библиотеки, где можно задать базовый URL, работают без изменений.

Получить ключ

1. Войдите через Google.
2. Откройте «Мой аккаунт» и создайте ключ в разделе «Ключи API удаления фона».
3. Скопируйте ключ, когда он появится. Он показывается только один раз.

Быстрый старт

Отправьте изображение файлом, в base64 или публичной ссылкой. Тело ответа — готовое изображение.

curl -H "X-Api-Key: $IMAGIC_API_KEY" \
  -F "image_file=@photo.jpg" \
  -F "size=auto" \
  -o no-bg.png \
  https://imagic-ai.com/api/v1.0/removebg

import os, requests

response = requests.post(
    "https://imagic-ai.com/api/v1.0/removebg",
    files={"image_file": open("photo.jpg", "rb")},
    data={"size": "auto"},
    headers={"X-Api-Key": os.environ["IMAGIC_API_KEY"]},
)
response.raise_for_status()
with open("no-bg.png", "wb") as out:
    out.write(response.content)

import { readFile, writeFile } from "node:fs/promises";

const form = new FormData();
form.append("image_file", new Blob([await readFile("photo.jpg")]), "photo.jpg");
form.append("size", "auto");

const res = await fetch("https://imagic-ai.com/api/v1.0/removebg", {
  method: "POST",
  headers: { "X-Api-Key": process.env.IMAGIC_API_KEY },
  body: form,
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
await writeFile("no-bg.png", Buffer.from(await res.arrayBuffer()));

Поля запроса

POST /api/v1.0/removebg принимает multipart/form-data, application/x-www-form-urlencoded или JSON. Передайте ровно одно из трёх полей изображения.

scale, position, roi, bg_image_url, bg_image_file и параметры тени не поддерживаются. Запросы с ними получают 400, а не молча другое изображение.

Ответ

По умолчанию тело ответа — само изображение со следующими заголовками: X-Width, X-Height, X-Type, X-Foreground-Top, X-Foreground-Left, X-Foreground-Width, X-Foreground-Height, X-Credits-Charged (всегда 1) и X-RateLimit-Limit / -Remaining / -Reset для дневного лимита. Чтобы получить JSON, отправьте Accept: application/json:

{
  "data": {
    "result_b64": "iVBORw0KGgo…",
    "foreground_top": 115,
    "foreground_left": 477,
    "foreground_width": 637,
    "foreground_height": 824
  }
}

Остаток лимита

GET /api/v1.0/account возвращает структуру аккаунта remove.bg. credits.total и api.free_calls — это число изображений, оставшихся на сегодня.

Ошибки

Ошибки имеют формат remove.bg, показанный ниже. Неудачный запрос не расходует изображения.

{"errors": [{"title": "Daily limit of 50 images reached. …", "code": "rate_limit_exceeded"}]}

Ограничения

• 50 изображений в день на аккаунт, общие для всех ключей. До 3 активных ключей на аккаунт, чтобы их можно было менять.
• Загрузка до 22 МБ. Результат до 25 Мп, для PNG — до 10 Мп.
• Запросы ставятся в очередь и обрабатываются по несколько. Рассчитывайте на несколько секунд на изображение, на больших фото — дольше.
• Платного тарифа пока нет, так что дневной лимит — это потолок.

Чего ждать от вырезки

Вырезку делает модель isnet-general-use — та же, что в инструменте «Удаление фона». Она надёжна на товарах, людях и животных на обычном фоне. Слабые места — тонкие волосы, стекло и объекты в цвет фона; там собственная модель remove.bg может справиться лучше. Перед переносом рабочего процесса проверьте несколько своих изображений.

Вопросы

Это официальная замена remove.bg?

Нет. Imagic AI не связана с remove.bg, Canva или Leonardo.Ai. API принимает формат запросов remove.bg, чтобы существующий код продолжал работать.

API бесплатный?

Да. У каждого аккаунта 50 бесплатных изображений в день. Любой размер, включая preview, считается одним изображением.

Работают ли официальные клиентские библиотеки remove.bg?

Библиотеки, где можно задать базовый URL, работают, если указать https://imagic-ai.com/api. Там, где api.remove.bg зашит в код, нужно поправить эту строку или написать небольшую обёртку.

Вы храните мои изображения?

Изображения, отправленные в API, обрабатываются и возвращаются в ответе. Они не попадают ни в какую галерею и не используются для обучения.