Введение
Передайте image_url, чтобы получить объект из одной фотографии в прозрачном PNG. Для этой операции нет полей prompt, маски или качества.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Идентификатор модели | ideogram/remove-background |
| Вход одного запроса | Одна фотография |
| Открытый параметр |
|
| Текстовое задание | Параметра prompt нет |
| Результат фотографии | Одно вырезанное изображение |
| Формат результата | PNG |
| Полученный фон | Прозрачный |
| Принцип оплаты | Фиксированная цена за завершённое изображение |
| Запросы с ошибкой | Не оплачиваются |
| Хранение файлов | 14 дней с последующим удалением |
Ключевые возможности и особенности
Проверяйте рычаг, а не только звонок
Тест отделил латунный велосипедный звонок от верстака. Прозрачный PNG сохранил края рычага и хомута — конкретный пример тонких контуров для проверки. Оцените показанный результат, затем соответствующие детали своего товара перед каталожной вёрсткой.
Один URL запускает вырезку
Отправьте фото через image_url без письменной инструкции и маски. Готовое фото оплачивается по фиксированному тарифу за картинку и возвращается в прозрачном PNG. Обложка у бассейна иллюстрирует переход, но не является образцом эндпоинта. Проверенные результаты — звонок и красный атлас.
Красный атлас с чистыми краями
Студийное фото женщины в красном атласном платье без бретелей вернулось прозрачным PNG. Волосы и подол имели чистые границы. Рассмотрите эти области примера, затем свой портрет на контрастных фонах. Это свидетельство конкретной студийной вырезки, а не обещание для каждой причёски, одежды или места.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Передайте URL исходной фотографии для удаления фона; это обязательное поле без значения по умолчанию, каждая обработанная фотография оплачивается по одному фиксированному тарифу. Не менее 1 символов |
Стоимость
$0.012 / изображение
За готовый результат удаления фона Ideogram взимается фиксированная плата за изображение; неудачная обработка не оплачивается.
Сценарии использования
Каталоги металлических изделий
Подготовьте предметное фото к каталожной композиции. Латунный звонок демонстрирует сохранение рычага и хомута — деталей, которые стоит проверять у подобных мелких предметов.
Макеты модных портретов
Отделите сфотографированную одежду с её владельцем от студийного фона. Наш красный атлас дал чистые волосы и подол для проверки перед размещением.
Карточки профилей и спикеров
Используйте прозрачный портрет отдельным слоем профиля или карточки выступающего. Выберите разрешённую фотографию, затем добавьте имя и фон в редакторе.
Разные фоны рекламной кампании
Размещайте скачанный PNG на разных цветах и изображениях кампании. Фон добавляется в макете, поэтому храните прозрачный ресурс рядом с каждой готовой композицией.
Руководство по промптам и практические советы
Выберите исходную фотографию
Возьмите фото, герой которого нужен отдельным ресурсом. Для людей используйте разрешённый портрет совершеннолетнего без имитации личности.
Отправьте URL картинки
Передайте фотографию через
image_url. Текстовое задание может помочь подготовить источник в другом месте; сюда не передаются ни промпт, ни маска.Осмотрите полученный PNG
В редакторе проверьте вырезку на светлом и тёмном фоне. До размещения оцените тонкие контуры: волосы, подолы одежды и мелкие крепления.
Скачайте и разместите вырезку
Сохраните PNG в пределах 14 дней хранения. Добавьте фон в отдельной композиции, сохранив прозрачную копию для повторного использования.
Превратите фото в вырезку для повторного использования
Ideogram Remove Background отделяет объект фотографии от окружения и возвращает один прозрачный PNG. Используйте image-edit, когда фото уже есть, а объект нужен для каталога, портретного макета или кампании. Передаётся image_url; письменной инструкции для интерпретации нет.
Источник определяет доступное для вырезки. Выберите фото человека или товара для нового размещения и до отправки осмотрите контур. Для человека используйте разрешённую фотографию совершеннолетнего без имитации личности.
Параметр запроса
| Параметр | Обязательный вход | Назначение |
|---|---|---|
image_url | URL одной исходной фотографии | Фото для удаления фона |
Открытые параметры не включают prompt, mask, quality, выбор формата и разрешения. Настройки примера генерации не управляют этой операцией. Определённый результат — прозрачный PNG; просить прозрачность предложением не нужно.
В примере красного атласа image_url указывает на студийное фото. Запрос не описывал платье, причёску или фон: всё это уже было в картинке.
Оплата и сохранение результата
За каждую готовую вырезку взимается фиксированная плата; запрос с ошибкой бесплатен. Перед отправкой фотографий посмотрите тариф на странице Ideogram Remove Background; цена другого инструмента или подписки не определяет тариф эндпоинта.
Скачайте PNG за 14 дней. Затем файлы удаляются. Храните вырезку с исходным фото, чтобы будущая вёрстка не зависела от доступности размещённого результата.
Как пользоваться заданиями для исходного фото
Промпт для удаления не пишется. Примеры этой страницы — задания на выбор, съёмку или подготовку источника в другом месте. Они описывают одежду, настроение, освещение и обстановку для планирования фото; когда оно готово, отправьте URL.
Например, описание женщины тридцати с лишним лет в атласном вечернем платье помогает студийной съёмке. Добавление предложения к запросу вырезки не создаёт поддерживаемую настройку. Предметное задание аналогично может задать латунную поверхность, ракурс и мягкий свет мастерской до съёмки.
При подготовке:
- Сохраняйте в кадре части, нужные композиции.
- До выбора операции решите, нужен человек, товар или конкретный названный объект.
- Для портретов подтвердите разрешение на фото и совершеннолетие.
- Храните источник для сравнения тонких деталей с вырезкой.
Что показали наши примеры
Латунный велосипедный звонок
Тест вернул аккуратно отделённый звонок. Края рычага и хомута остались целыми после удаления верстака. Эти мелочи полезны для проверки: сравнивайте с оригиналом, а не оценивайте только общую форму звонка.
Студийный портрет в красном атласе
Пример начался со студийного фото женщины в платье без бретелей. Прозрачный PNG имел чистые края волос и подола. Это наблюдение конкретной фотографии, а не установленный результат для каждой причёски, ткани или фона.
Обложка у бассейна — иллюстрация, не сгенерированный пример и не ещё один замер. Свидетельства описанных результатов — две вырезки.
Проверка PNG перед размещением
Откройте скачанный файл в редакторе с поддержкой прозрачности. Подложите светлый и тёмный фон, осмотрите волосы, подолы и узкие металлические детали в масштабе использования. Шахматная подложка — вспомогательный просмотр; пригодность определяйте по самому PNG.
Прозрачная вырезка не включает новый белый фон или заменённую сцену. Добавьте нужный фон в редакторе композиции и храните прозрачную копию рядом с экспортом. Один ресурс сможет служить разным размещениям без попытки считать замену фона настройкой эндпоинта.
Ограничения и соседние инструменты
Запрос обрабатывает одно фото и выдаёт один прозрачный PNG. Открытого текстового поля для выбора объекта или изменения одежды, света и места нет. Выбирайте источник с уже принятыми решениями.
Background Remover V1 — ещё один вариант удаления фона. Object Extractor V1 подходит для выбора конкретного предмета письменным описанием.
Быстрый старт 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": "ideogram/remove-background/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.





