Введение
Слои Seedream 5.5 превращают готовый PNG или JPEG в непрозрачную основу и отдельные прозрачные элементы. Используйте разделение изображения на слои, если дизайн уже готов, а работать нужно с его частями по отдельности. Этот эндпоинт принимает один исходник; набор референсов используется в режиме редактирования.
ByteDance описывает основу и до 99 редактируемых прозрачных слоёв PNG. Мы разделили журнальную обложку, меню и постер с тремя строками. Результаты показывают, почему запрошенное число — верхний предел: некоторые изображения заполнили лимит, а постер дал меньше элементов, чем было разрешено.
Ключевые возможности и особенности
Основа и прозрачные элементы
Основа непрозрачна, выделенные элементы используют прозрачность PNG. Выбор jpeg в output_format меняет формат основы; слои по-прежнему приходят как прозрачные PNG. Учитывайте это при сохранении файлов для композиции. В полученном наборе основа и слои выполняют разные роли.
У каждого слоя есть название, ограничивающая рамка и zIndex для порядка наложения. У основы ограничивающей рамки нет. Храните эти сведения вместе с файлами, чтобы расположить выделенные элементы в графическом редакторе. Каждое полученное изображение сохраняет собственную форму.
Лимит с учётом основы
num_outputs принимает значения от 2 до 100, по умолчанию — 10. При планировании считайте основу одним результатом. Поэтому лимит шесть допускает основу и пять прозрачных слоёв. Большее значение обычно даёт более дробное разделение, но фактическое число изображений может быть меньше.
В наших тестах меню вернуло основу и пять слоёв при лимите шесть. Постер с тремя строками вернул основу и три текстовых слоя при лимите пять. Этот постер показывает, что увеличенный предел не обязывает модель заполнить все доступные места.
Английские названия по запросу
Примеры на странице просят вернуть название и описание каждого слоя по-английски. В наших тестах такая инструкция давала английские названия. Добавьте «Напишите все названия и описания слоёв на английском», если это нужно для вашей работы. Отделяйте запрос языка от списка выделяемых элементов.
Исходник и разрешение
Передайте один PNG или JPEG размером не менее 512 x 512 пикселей. Доступны auto, 1k, 1.5k и 2k, по умолчанию — auto. Это настройки эндпоинта слоёв; значение 4k, доступное для генерации и правки, здесь не предлагается.
| Параметр | Роль при разделении |
|---|---|
image_url | Передаёт готовое исходное изображение |
| prompt | Необязательно задаёт элементы или целевую область |
| resolution | Выбирает auto, 1k, 1.5k или 2k |
num_outputs | Ограничивает все полученные изображения, включая основу |
output_format | Выбирает PNG или JPEG для основы |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Пока действует модерация; версия без модерации появится скоро. Запросы, отклонённые модерацией, не оплачиваются. Не менее 1 символов |
prompt | Нет | Необязательное поле. Перечислите элементы для выделения в пределах 5 000 символов. Не менее 3 символов · Не более 5000 символов |
num_outputs | Нет | Ограничивает общее число изображений, включая основу: от 2 до 100, по умолчанию 10. Повышение лимита обычно даёт более дробные слои, но не гарантирует указанное количество. |
resolution | Нет | Выбирает auto, 1k, 1.5k или 2k; по умолчанию — auto. Каждое полученное изображение сохраняет собственную форму. |
output_format | Нет | Выбирает png (по умолчанию) или jpeg для непрозрачной основы. При любом выборе выделенные слои остаются прозрачными PNG. |
Стоимость
Расчёт зависит от разрешения и фактического числа полученных изображений, включая основу. Предварительная оценка резервирует максимум для заданного лимита; разница освобождается при окончательном расчёте. При auto резерв соответствует тарифу 2k.
| Спецификация | Стоимость |
|---|---|
| $0.0195 / изображение |
| $0.0195 / изображение |
| $0.027 / изображение |
| $0.027 / изображение |
Сценарии использования
Разделение журнальной обложки на элементы дизайна
Наша обложка NOIR при лимите шесть дала шесть изображений: фон, человека, название журнала, японскую строку, строку выпуска и штрихкод. Это конкретный пример слоёв Seedream 5.5 для обложки с фотографическим содержанием и надписями.
Ориентируйтесь на этот результат при планировании дизайна с отдельными элементами, которые нужны независимо друг от друга. Перечислите важные части в необязательной инструкции. Сохраните исходную картинку, чтобы сравнить полученные элементы с оригинальным макетом.
Разбор меню для дальнейшей композиции
Пример слоёв KAZE RAMEN начинается с готового изображения меню. При лимите шесть наши тесты вернули непрозрачную основу и пять прозрачных слоёв. Сохраните весь набор, если позже планируете снова расположить элементы меню вместе.
Выделение текстовых строк постера
Тест постера с тремя строками дал отдельный прозрачный слой для каждой строки и основу. Всего получилось четыре изображения при запрошенном лимите пять. Считайте реальные файлы после завершения: лимит не гарантирует определённый набор результатов.
Организация элементов по полученным метаданным
Используйте название для определения слоя, ограничивающую рамку — для его положения, zIndex — для порядка наложения. Храните эти значения с соответствующим файлом. Английские названия могут упростить организацию, если остальные обозначения в вашей работе тоже английские.
Руководство по промптам и практические советы
Выберите готовый исходник с понятными элементами
Сначала убедитесь, что файл имеет формат PNG или JPEG и размер не менее 512 x 512. Перед выбором количества решите, какие элементы нужны отдельно. Для обложки перечислите фон, человека, заголовок, дополнительный текст и штрихкод, если нужны именно они.
Опишите нужное разделение
Промпт необязателен: можно отправить исходник без списка элементов. Если важно определённое разделение, напишите короткую инструкцию: «Отделите название журнала, подзаголовок, строку выпуска и штрихкод». Так инструмент узнает, с чем вы хотите работать после разделения.
Явно попросите нужный язык названий
Добавьте «Верните названия слоёв на английском», если нужны английские обозначения. Примеры обложки и меню используют такую инструкцию. Наше наблюдение о языке относится к названиям слоёв: оно не означает, что печатный текст исходника нужно переводить или заменять.
Укажите область тегом ограничивающей рамки
Для целевой области используйте форму <bbox>x1 y1 x2 y2</bbox> с координатами от 0 до 1000. Например, <bbox>0 0 1000 300</bbox> обозначает область в верхней части картинки. После тега опишите выделяемый элемент, чтобы были понятны и область, и её назначение.
Выберите количество под нужные элементы
Для основы и пяти слоёв задайте лимит шесть. Если нужны более мелкие части, увеличение лимита обычно даёт более дробные слои. Настройка остаётся пределом, а не обещанным количеством. Перед следующим этапом сравните полученный набор с планом элементов.
Разделяйте формат основы и прозрачность слоёв
Выберите png или jpeg под нужный файл основы. Это не превращает выделенные слои в JPEG: при любом выборе основы они сохраняют формат прозрачных PNG. Сохраните непрозрачную основу, если полной композиции нужно исходное изображение под слоями.
Учитывайте число результатов при расчёте
Оплата слоёв зависит от разрешения и фактического числа изображений с учётом основы. Предварительная оценка резервирует максимум для заданного лимита, а разница освобождается при окончательном расчёте. Для разрешения auto резерв соответствует тарифу 2k. При выборе параметров ориентируйтесь на стоимость, показанную на странице.
Сохраните полный результат разделения
Скачайте основу, прозрачные PNG и сведения об их расположении вместе. Запишите рядом необязательную инструкцию и лимит результатов. Это сохранит связь между исходным дизайном, выделенными файлами, их названиями и порядком наложения для следующей композиции.
Быстрый старт 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.5/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"num_outputs": 10,
"output_format": "png",
"resolution": "auto"
}
}'
# 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.
