Введение
Background Remover отделяет главный объект фотографии от всего, что находится за ним, и возвращает его на полностью прозрачном фоне. Вы отправляете один URL изображения и получаете PNG с альфа-каналом той же ширины и высоты, что и оригинал, поэтому вырезка совпадает с исходником до пикселя, когда их нужно совместить.
Здесь нет ни промпта, ни маски, ни настроек: что считать передним планом, инструмент решает сам.
Ключевые возможности и особенности
Прозрачность, которую можно сразу ставить в макет
Пиксели фона не закрашиваются белым, а становятся полностью прозрачными, поэтому результат ложится на любой цвет, градиент или фото без рамки вокруг. Именно такой формат ждут маркетплейсы, презентации, графические редакторы и веб-страницы для вырезок товаров и портретов.
Нечего писать и нечего настраивать
Весь запрос — один URL изображения. Раз ничего не формулируется, не бывает неудачных слов и повторных попыток из-за двусмысленной инструкции, поэтому целую папку каталожных снимков легко прогнать в цикле.
Исходные размеры сохраняются
Вырезка возвращается в размере загруженного файла, а не в фиксированном квадрате, так что ее можно положить обратно на исходник, использовать как маску или передать на следующий этап обработки без масштабирования.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Фотография для вырезки в формате JPEG, PNG или WebP. Объект определяется автоматически, поэтому, если в кадре несколько кандидатов, сначала кадрируйте снимок. Не менее 1 символов |
Стоимость
$0.0048 / изображение
Оплата за каждое готовое изображение; размер отправленной фотографии на цену не влияет.
Сценарии использования
Каталог товаров и карточки на маркетплейсах
Снимайте товары на той поверхности, что есть под рукой, затем удаляйте фон и ставьте каждую позицию на один и тот же чистый цвет. Единый фон во всех карточках — самый быстрый способ визуально подтянуть магазин, и для него больше не нужна фотостудия под каждый товар.
Аватары, страницы команды и превью
Отделяйте людей от офисных стен, гостиных и уличных сцен, чтобы делать фото профиля, карточки спикеров и превью к видео с фоном в цветах бренда.
Первый шаг более долгой обработки
Вырежьте объект до того, как собирать коллаж: удалите фон здесь, соберите новую сцену в Image Expander и затем положите прозрачный PNG обратно сверху.
Руководство по промптам и практические советы
Выбирайте фото с четким объектом
Передний план инструмент выбирает сам. Надежнее всего он работает, когда в кадре явно доминирует один человек или предмет и он отделяется от фона цветом или светом. Если на снимке несколько одинаково заметных людей или предметов, перед отправкой кадрируйте его до нужного объекта, иначе инструмент может оставить больше, чем вы хотели.
Проверяйте тонкие края в полном размере
Волосы, мех, кружево, дым и стекло — самые сложные места для вырезки. Рассматривайте их с увеличением перед публикацией, особенно если цвета фона и объекта похожи. Пересъемка на более спокойном фоне исправит больше, чем повторный прогон того же снимка.
Сохраняйте файл в PNG
Прозрачность сохраняется только в форматах, которые ее поддерживают. Храните и передавайте результат в PNG; при конвертации в JPEG прозрачная область заливается сплошным цветом и возвращает тот самый прямоугольник, который вы только что убрали.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/background-remover-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
