Перейти к основному содержанию
Seedream 5.5 — модель изображений ByteDance из BytePlus ModelArk, вышедшая 12 ноября 2026 года. В отличие от Seedream 5.0, она сразу отдаёт PNG с прозрачным фоном и раскладывает готовую картинку на фон и до 99 слоёв, поэтому подходит для товарных фото, стикеров и редактируемых постеров. Генерация, правка по референсам и разбиение на слои идут через один и тот же эндпоинт: режим определяется полями запроса.
Ночная витрина книжного магазина с тёплым светом, кот спит на стопке книг, рукописная табличка OPEN LATE, создано Seedream 5.5

Пример генерации ниже: витрина книжного магазина ночью, кот спит на стопке книг, табличка «OPEN LATE». Размер 2K, на выходе 2496×1664

Керамическая кружка с синими цветами на прозрачном фоне, PNG от Seedream 5.5

Пример прозрачного PNG ниже: керамическая кружка с мелкими синими цветами. background transparent, 1K, на выходе 1024×1024 RGBA

Чем Seedream 5.5 отличается от 5.0

Как выбрать:
  • Seedream 5.5 — для прозрачных ассетов, детальных слоёв и постеров, где нужно распознать текст и шрифт.
  • Seedream 5.0 Flash — для дешёвой массовой генерации.
  • Seedream 5.0, 4.5 или 4.0 — если нужны 3K, 4K или групповая (последовательная) генерация. Они описаны на странице Seedream API.

Как подключить Seedream 5.5 API

1

Создайте ключ

В разделе Управление токенами создайте токен в группе default и выберите Режим оплаты (计费模式): «сначала по использованию» (按量优先, рекомендуется) или «оплата за вызов» (按次计费). Ключ с режимом «сначала по использованию» вызывает и модели с оплатой по использованию, и модели с оплатой за вызов.
2

Настройте окружение

Экспортируйте ключ и установите requests и Pillow для примеров на Python:
3

Сохраните скрипт для записи результата

Примеры на cURL записывают ответ в JSON-файл. Скрипт save_result.py скачивает каждое изображение из data[] и выбирает расширение по полю output_format из ответа:
save_result.py
Запуск: python3 save_result.py ответ.json имя_файла. Ссылки в url временные (по данным BytePlus, 24 часа), поэтому сохраняйте изображения сразу.

Генерация изображения по тексту

Запрос создаёт изображение 2K без водяного знака. Без size тоже получится 2K, а соотношение сторон модель выберет по содержанию промпта:
Ответ сокращён, ссылка заменена:
В поле model ответа указано имя модели BytePlus dola-seedream-5-5-261028, это нормально. Запрос 2K обычно выполняется 25–35 секунд, 1K — 12–20 секунд.

Генерация на Python

Пример сохраняет файл с расширением по output_format из ответа:
Чтобы зафиксировать соотношение сторон, передайте точные пиксели, например "size": "2848x1600" для 16:9 или "2048x2048" для квадрата. Ширину и высоту разделяет латинская буква x.

PNG с прозрачным фоном

Передайте "background": "transparent" и "output_format": "png", и модель вернёт RGBA-изображение без фона. Так сделан пример с кружкой выше:
В ответе у изображения будет "background": "transparent", а size равен 1024x1024. Значения background:
  • auto (по умолчанию): модель решает сама по промпту и output_format.
  • transparent: изображение RGBA с альфа-каналом.
  • opaque: обычное изображение RGB с фоном.
background работает и при генерации, и при правке по референсам. В формате jpeg альфа-канала не бывает, поэтому для прозрачности указывайте png. Вместе с разбиением на слои background передавать нельзя: такой запрос вернёт ошибку.

Правка по нескольким референсам

Чтобы отредактировать изображение или собрать новое из нескольких, передайте image: строку или массив до 10 изображений. Каждое изображение — публичный URL или data URL вида data:image/png;base64,... с форматом строчными буквами. В промпте ссылайтесь на них как image 1, image 2 в порядке массива. Пример отправляет два локальных файла как data URL:
Этот запрос стоит $0.051: $0.035 за изображение на выходе и по $0.008 за каждый из двух референсов. Ограничения на формат, размер и пиксели каждого референса те же, что у других версий Seedream, см. вопрос о локальных изображениях на странице Seedream API.

Разбиение изображения на слои

С "layer_decomposition": true Seedream 5.5 раскладывает одно изображение на непрозрачный фон (z_index 0) и прозрачные PNG-слои, по одному элементу на слой. Требования к запросу:
  • В image ровно одно изображение: png или jpeg, не меньше 512×512 пикселей всего, до 30 МБ.
  • background не передавайте.
  • Таймаут клиента — не меньше 300 секунд. Разбиение 1K обычно занимает 20–30 секунд, 2K — дольше.
Число слоёв и распознавание текста настраиваются в layer_decomposition_options:
  • max_images: сколько изображений вернуть максимум, считая фон. От 2 до 100, по умолчанию 30.
  • text_recognition: при true слои с обычным текстом получают поле text_recognition с текстом и его стилем. Для художественных надписей и рукописного текста оно не возвращается.
Замените URL в image на своё изображение или передайте data URL. Так выглядит текстовый слой из разбиения постера (элемент data[], сокращён):
Что есть в слое:
  • bounding_box.absolute: рамка слоя на фоне в пикселях, [left, top, right, bottom]; normalized — та же рамка в шкале 0–1000.
  • name и description: название и описание элемента на английском.
  • text_recognition.lines[].runs[].style: стиль фрагмента текста — похожий шрифт (similar_font_family), цвет (foreground_color) и признаки начертания: жирный, курсив, подчёркивание, зачёркивание, тень, полупрозрачность.
Размер PNG-файла слоя может не совпадать с рамкой: в примере файл 1616×649 ложится в рамку 836×336. При обратной сборке масштабируйте каждый слой под его рамку absolute. Описание всех полей — в разделе Ответ с разбиением на слои, а готовый скрипт на Pillow — в разделе Сохранение слоёв и обратная сборка на странице Seedream API. Он подходит и для ответа Seedream 5.5.

Параметры запроса

Ограничения size в пикселях:
  • Всего от 921 600 (1280x720) до 4 624 220 пикселей.
  • Соотношение сторон от 1/16 до 16.
  • 2048x2048 возвращает ровно 2048×2048.
Seedream 5.5 не поддерживает групповую генерацию (sequential_image_generation), потоковую передачу (stream) и веб-поиск. Не отправляйте эти поля в запросе.

Цена и списание

Цена за изображение не зависит от размера: $0.035 за 1K, 1.5K или 2K. Каждый референс добавляет $0.008, включая первый.
  • Ответы с кодом не 200 (ошибка параметров, блокировка модерацией) не оплачиваются.
  • Таймаут клиента запрос не отменяет: если сервер успел создать изображение, оно оплачивается. Прежде чем повторять запрос, проверьте журнал вызовов (на английском).
  • Фактические списания по каждому запросу видны в журнале вызовов.
Разбиение на слои оплачивается за каждое возвращённое изображение, включая фон.
  • Сколько слоёв вернуть, решает модель, в пределах max_images. По умолчанию это 30 изображений, то есть до $1.058 за один запрос.
  • Чтобы ограничить расход, задайте max_images: при значении 3 возвращается не больше 3 изображений.
  • 6 изображений из одного входного стоят 6 × $0.035 + $0.008 = $0.218.

Частые вопросы

Какой ID модели у Seedream 5.5 API?

seedream-5-5-261028. Имя BytePlus dola-seedream-5-5-261028 тоже работает напрямую и стоит столько же. В ответе поле model всегда показывает dola-seedream-5-5-261028.

Сколько стоит одно изображение Seedream 5.5?

$0.035 за изображение на выходе при любом размере: 1K, 1.5K или 2K. Каждый референс добавляет $0.008, а при разбиении на слои оплачивается каждое возвращённое изображение, включая фон. Примеры расчёта — в разделе «Цена и списание».

Почему Seedream 5.5 возвращает 400 на режим fast?

Seedream 5.5 принимает в optimize_prompt_options.mode только standard. Значение fast возвращает HTTP 400, и такой запрос не оплачивается. В тексте ошибки будет фрагмент:
Удалите поле или передайте standard. В семействе Seedream режим fast принимают только 5.0 Pro и 4.0.

Есть ли у Seedream 5.5 разрешение 4K?

Нет. Максимум — уровень 2K или до 4 624 220 пикселей в точном размере, например 2848x1600. Значений 3K и 4K нет. Для 3K используйте Seedream 5.0, для 4K — Seedream 4.5 или 4.0 со страницы Seedream API.

Можно ли получить несколько изображений одним запросом?

Нет, групповая генерация (sequential_image_generation) в Seedream 5.5 не поддерживается: один запрос генерации или правки возвращает одно изображение. Для нескольких вариантов отправьте несколько запросов. Несколько изображений в одном ответе бывает только при разбиении на слои.

Нужен ли аккаунт BytePlus для Seedream 5.5?

Нет. Аккаунт BytePlus или Volcengine не нужен: достаточно зарегистрироваться в LaoZhang API и создать токен в группе default с режимом «сначала по использованию» (рекомендуется) или «оплата за вызов».

Связанные материалы

Источники