Введение
Object Eraser убирает с фотографии то, что вам не нужно, и заполняет освободившееся место фоном, который сочетается с остальной сценой. Указать предмет можно двумя способами: описать его парой слов или закрасить белым на черной маске. В ответ приходит та же фотография в исходном размере, но уже без этого предмета.
Ключевые возможности и особенности
Указывайте словами или маской
Быстрее всего — короткое описание: «деревянная скамья слева», «вывеска над дверью», «второй человек справа». Лучше всего оно работает с отчетливыми предметами, вокруг которых есть свободное место; тонкие предметы и то, что стоит у края кадра, часто пропускаются, и фото, вернувшееся без изменений, — верный признак этого. Маска точно отмечает пиксели, поэтому в таких случаях это надежный путь, как и для одной из двух похожих чашек или только части забора. Оба способа можно отправить в одном запросе.
Заполнение, которое следует сцене
Удаленная область не размывается и не смазывается, а восстанавливается по окружению. Половицы продолжаются, стены сохраняют фактуру, свет по-прежнему падает с той же стороны, поэтому результат выглядит как нетронутая фотография.
Остальная часть фото остается прежней
Заменяется только выбранный предмет. Кадрирование, разрешение и все за пределами выделения возвращаются такими, какими вы их отправили, так что отредактированное фото можно сразу вернуть в макет, объявление или серию.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Фотография для очистки в формате JPEG, PNG или WebP. Не менее 1 символов |
prompt | Нет | Что убрать, в нескольких словах и с положением, если таких объектов несколько: «красная машина слева». Не менее 1 символов · Не более 1000 символов |
mask_url | Нет | Необязательное черно-белое изображение того же размера, что и фото: белое отмечает то, что нужно убрать, черное — то, что остается. Не менее 1 символов |
output_format | Нет | PNG сохраняет все края без потерь и используется по умолчанию; JPEG и WebP дают файлы меньшего размера. |
Стоимость
$0.03 / изображение
Оплата за каждое готовое изображение; количество предметов, удаленных за один запрос, на цену не влияет.
Сценарии использования
Чистые фото товаров и недвижимости
Уберите провода, ценники, забытую упаковку или прохожих с кадров, которые в остальном готовы, вместо того чтобы назначать новую съемку. Это самый быстрый способ исправить фото для объявлений, интерьеров и галерей недвижимости, где один лишний предмет портит весь кадр.
Аккуратные фото из поездок и с мероприятий
Уберите туристов, мусорные баки, строительные леса или других фотографов с фона портрета или достопримечательности, чтобы главный герой наконец остался в кадре один.
Подготовка кадров к дальнейшей обработке
Сначала освободите место, а затем расширьте всю сцену в Image Expander.
Руководство по промптам и практические советы
Описывайте видимое и указывайте, где оно
Пишите о предмете так, как показали бы его коллеге: существительное, цвет или материал и положение. «Скамья» сработает, но «деревянная скамья слева» надежнее, если таких в сцене несколько. Если назвать то, чего нет на изображении, ошибки не будет. Фото просто вернется без изменений, поэтому результат, идентичный исходнику, обычно означает, что описание не попало в цель.
Закрашивайте маски с запасом
Если используете mask_url, делайте маску того же размера, что и фото, белой поверх предмета и черной везде остальное. Заведите белое чуть дальше края предмета, чтобы исчезли и контур, и тень; маска, повторяющая силуэт впритык, часто оставляет легкий след.
Крупное убирайте по одному
Несколько мелких предметов можно убрать одним запросом, но для крупных или перекрывающихся удалений делайте отдельные проходы и проверяйте каждый результат. Каждый проход возвращает полноценное фото, поэтому результат одного запроса можно сразу передать в следующий.
Быстрый старт 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/object-eraser-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.
