Генерация, правка по референсам и разбиение на слои идут через один и тот же эндпоинт: режим определяется полями запроса.

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

Пример прозрачного 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:
Разбиение изображения на слои
С"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с текстом и его стилем. Для художественных надписей и рукописного текста оно не возвращается.
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) и признаки начертания: жирный, курсив, подчёркивание, зачёркивание, тень, полупрозрачность.
absolute. Описание всех полей — в разделе Ответ с разбиением на слои, а готовый скрипт на Pillow — в разделе Сохранение слоёв и обратная сборка на странице Seedream API. Он подходит и для ответа Seedream 5.5.
Параметры запроса
Ограничения
size в пикселях:
- Всего от 921 600 (
1280x720) до 4 624 220 пикселей. - Соотношение сторон от 1/16 до 16.
2048x2048возвращает ровно 2048×2048.
sequential_image_generation), потоковую передачу (stream) и веб-поиск. Не отправляйте эти поля в запросе.
Цена и списание
Цена за изображение не зависит от размера: $0.035 за 1K, 1.5K или 2K. Каждый референс добавляет $0.008, включая первый.- Ответы с кодом не 200 (ошибка параметров, блокировка модерацией) не оплачиваются.
- Таймаут клиента запрос не отменяет: если сервер успел создать изображение, оно оплачивается. Прежде чем повторять запрос, проверьте журнал вызовов (на английском).
- Фактические списания по каждому запросу видны в журнале вызовов.
Частые вопросы
Какой 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 с режимом «сначала по использованию» (рекомендуется) или «оплата за вызов».
Связанные материалы
- Seedream API: Seedream 5.0 Flash, 5.0 Pro, 5.0, 4.5 и 4.0, обратная сборка слоёв
- Сравнение API изображений: Seedream рядом с другими моделями изображений
- Images API: общий формат ответа и скрипт сохранения изображений
- Цены на API моделей ИИ: актуальные цены и группы
- Журнал вызовов (на английском): модель и списание по каждому запросу
Источники
- API генерации изображений BytePlus ModelArk (на английском): параметры запроса Seedream 5.5,
backgroundи разбиение на слои, проверено 13 ноября 2026 года - Список моделей BytePlus ModelArk (на английском): версии моделей Seedream