Введение
Seedream 5.0 Pro Разделение на слои разбивает одно готовое изображение на подложку и до шестнадцати прозрачных PNG-слоёв. У каждого слоя есть рамка положения и название, поэтому можно собрать исходную композицию заново или переставить слои на холсте.
Разработано ByteDance (ID модели dola-seedream-5-0-pro-260628). Берите его, когда слои должны вернуться ровно на своё место.
Выберите режим по исходному материалу
| Исходный материал | Режим |
|---|---|
| Готовое изображение, части которого нужны по отдельности | Seedream 5.0 Pro Разделение на слои |
| Письменная арт-дирекция или дизайн-бриф | Seedream 5.0 Pro Текст в изображение |
| Утверждённое исходное изображение, которое нужно доработать | Seedream 5.0 Pro Редактирование изображения |
| То же разделение, тоже с названиями и рамками положения, по меньшей цене за изображение | Seedream 5.0 Flash Разделение на слои |
Pro или Flash для слоёв
Обе ступени возвращают boundingBox и name для каждого слоя. На одной и той же киноафише без prompt Pro вернул девять изображений, а Flash — восемь. Различия — цена и одна граница по контенту. Pro стоит $0.042 за изображение на выходе в 1K и 1.5K и $0.084 в 2K; Flash — $0.026 на любой ступени. Pro отклоняет исходные изображения уровня «Очень сильный», а Flash разложил такое же изображение на отдельные фигуры. Заметно быстрее ни один из них в наших запусках не оказался.
Ключевые возможности и особенности
Рамки положения и названия
Каждый слой возвращает boundingBox в виде [x1, y1, x2, y2] в пикселях подложки и name, например «Woman in red trench coat». В нашем запуске на афише, если положить слои обратно по их рамкам, получалась исходная афиша. PNG слоя часто больше рамки, которую он занимает (рамке 671 на 139 соответствовал PNG 1233 на 256), поэтому при возврате на место масштабируйте его под рамку.
Чистая подложка
Разделённые элементы убраны, а фон достроен. После разделения рекламы парфюма на месте флакона, ленты и надписей остался пустой чёрный мрамор.
Управляйте словами или координатами
Назовите элементы или задайте их координатами <bbox>. Без prompt модель сама выбирает главные элементы.
Прозрачные PNG-слои
Слои всегда прозрачные PNG, что бы вы ни выбрали в output_format. Эта настройка меняет только подложку.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Одно изображение для разделения: png, jpeg, webp, bmp, tiff или gif, до 30 МБ, от 262 144 до 36 000 000 пикселей всего, соотношение сторон от 1:16 до 16:1. HEIC не поддерживается. Не менее 1 символов |
prompt | Нет | Необязателен, любой длины. Оставьте пустым — модель сама выберет главные элементы; назовите элементы — разделит их. Не менее 1 символов · Не более 5000 символов |
resolution | Нет | auto, 1k, 1.5k или 2k. Подложка сохраняет соотношение сторон входа, а каждый слой — пропорции своего элемента. |
output_format | Нет | jpeg или png только для подложки. Слои всегда прозрачные PNG, что бы вы ни выбрали. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.042 / изображение |
| $0.042 / изображение |
| $0.084 / изображение |
| $0.084 / изображение |
Сценарии использования
Поменять слова на афише
Достаньте слой с заголовком, замените или переоформите его и сложите всё обратно по возвращённым рамкам.
Заменить фон товара
Снимите с рекламы товар и его надписи, оставьте подложку или замените её и пересоберите композицию для новой кампании.
Собрать материалы для параллакса или анимации
Превратите иллюстрацию в упорядоченные слои с известными положениями, готовые для движения по глубине или для рига.
Выделить человека из сцены
Попросите только человека и получите один прозрачный слой и сцену без него.
Руководство по промптам и практические советы
Назовите нужные части
Для афиши перечислите их простыми словами: «Separate the diner building, the tagline, the LATE SHIFT title, the woman in the red trench coat and the ADMIT ONE ticket stub.» Этот запуск вернул шесть изображений: подложку и ровно эти пять слоёв.
Обведите элемент рамкой bbox
Добавьте <bbox>x1 y1 x2 y2</bbox> после названия элемента. Координаты нормированы к 0–1000 от левого верхнего угла, поэтому от размера изображения в пикселях не зависят.
Separate the title text <bbox>179 58 809 197</bbox> and the parrot <bbox>330 274 641 991</bbox> into independent layers
Выберите разрешение
1k и 1.5k стоят одинаково за изображение на выходе; 2k и auto считаются по ставке 2K, потому что auto может дать результат в 2K. Берите 1k или 1.5k, когда нужно только рабочее разделение.
Учитывайте резерв
Запрос резервирует стоимость 17 изображений и возвращает разницу, когда становится известно фактическое число слоёв. Обычно результат — несколько изображений.
Границы контента
Seedream 5.0 Pro · Разделение на слои. SpicyAPI не добавляет фильтр контента на стороне платформы на этом эндпоинте. Ограничения самой модели продолжают действовать, результат не гарантируется. В наших тестах он разделял все исходные изображения без фильтров, которые мы пробовали, кроме изображений уровня «Очень сильный», от которых модель отказалась без списания. Вы отвечаете за соблюдение нашей политики в отношении контента.
Быстрый старт 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": "bytedance/seedream-5.0-pro/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "1.5k"
}
}'
# 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.
