> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedream 5.5 API: прозрачный PNG, слои и цена $0.035

> Как подключить Seedream 5.5 через LaoZhang API без аккаунта BytePlus: генерация 1K–2K, PNG с прозрачным фоном, правка по 10 референсам и разбиение на слои с распознаванием текста.

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

| Пункт | Подробности |
| - | - |
| ID модели | `seedream-5-5-261028` |
| Эндпоинт | `POST https://api.laozhang.ai/v1/images/generations`, тело JSON |
| Цена | \$0.035 за изображение на выходе, одинаково для 1K, 1.5K и 2K |
| Размер | `1K`, `1.5K`, `2K` (по умолчанию) или точные пиксели; 3K и 4K нет |
| Ключ | Группа `default`, режим «сначала по использованию» (рекомендуется) или «оплата за вызов» |
| Доступна в LaoZhang API | С 13 ноября 2026 года, аккаунт BytePlus или Volcengine не нужен |

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

![Ночная витрина книжного магазина с тёплым светом, кот спит на стопке книг, рукописная табличка OPEN LATE, создано Seedream 5.5](https://mintcdn.com/laozhangai-edd05f2c/HEoMLhnyMjdf-Yvq/images/samples/seedream-5-5-en-generate.jpg?fit=max\&auto=format\&n=HEoMLhnyMjdf-Yvq\&q=85\&s=6cfd5e49315c9bf7a0a0e55119f13b35)

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

![Керамическая кружка с синими цветами на прозрачном фоне, PNG от Seedream 5.5](https://mintcdn.com/laozhangai-edd05f2c/HEoMLhnyMjdf-Yvq/images/samples/seedream-5-5-en-transparent.png?fit=max\&auto=format\&n=HEoMLhnyMjdf-Yvq\&q=85\&s=3f17d97dce5cc25f1d5710ed96d371f9)

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

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

| Возможность | Seedream 5.5 | Seedream 5.0 Flash / 5.0 Pro |
| - | - | - |
| Прозрачный фон | Параметр `background` при генерации и правке | Только через разбиение на слои |
| Слои | Фон и до 99 слоёв, `max_images`, распознавание стиля текста | Фон и до 16 слоёв |
| Цена за изображение | \$0.035 | Flash \$0.018, Pro \$0.12 |
| Плата за референс | \$0.008 за каждый | Flash бесплатно, Pro \$0.003 за каждый со второго |
| Формат по умолчанию | PNG | JPEG |

Как выбрать:

* **Seedream 5.5** — для прозрачных ассетов, детальных слоёв и постеров, где нужно распознать текст и шрифт.
* **Seedream 5.0 Flash** — для дешёвой массовой генерации.
* **Seedream 5.0, 4.5 или 4.0** — если нужны 3K, 4K или групповая (последовательная) генерация. Они описаны на странице [Seedream API](https://docs.laozhang.ai/ru/api-capabilities/seedream-image.md).

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

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

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

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

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

```bash theme={null}
export LAOZHANG_API_KEY="YOUR_LAOZHANG_API_KEY"
python3 -m pip install requests pillow
```

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

Примеры на cURL записывают ответ в JSON-файл. Скрипт `save_result.py` скачивает каждое изображение из `data[]` и выбирает расширение по полю `output_format` из ответа:

```python save_result.py theme={null}
import base64
import json
import sys
from pathlib import Path

import requests

response = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
if not response.get("data"):
    sys.exit(f"В ответе нет изображений: {response}")

for number, item in enumerate(response["data"], start=1):
    if item.get("b64_json"):
        value = item["b64_json"].split(",", 1)[-1]
        image = base64.b64decode(value + "=" * (-len(value) % 4))
    else:
        download = requests.get(item["url"], timeout=120)
        download.raise_for_status()
        image = download.content
    extension = "jpg" if item.get("output_format") == "jpeg" else "png"
    path = Path(f"{sys.argv[2]}-{number}.{extension}")
    path.write_bytes(image)
    print(f"Сохранено: {path} ({item.get('size')}, фон: {item.get('background')})")
```

Запуск: `python3 save_result.py ответ.json имя_файла`. Ссылки в `url` временные (по данным BytePlus, 24 часа), поэтому сохраняйте изображения сразу.

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

Запрос создаёт изображение 2K без водяного знака. Без `size` тоже получится 2K, а соотношение сторон модель выберет по содержанию промпта:

```bash theme={null}
curl --fail-with-body --max-time 180 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5-261028",
    "prompt": "A cozy bookstore window at night with warm light, a cat sleeping on a stack of books, and a hand-lettered sign that reads \"OPEN LATE\"",
    "size": "2K",
    "watermark": false
  }' \
  -o seedream55-generate.json

python3 save_result.py seedream55-generate.json bookstore
```

Ответ сокращён, ссылка заменена:

```json theme={null}
{
  "model": "dola-seedream-5-5-261028",
  "data": [
    {
      "url": "https://example.com/seedream-5-5.png",
      "size": "2496x1664",
      "output_format": "png",
      "background": "opaque"
    }
  ],
  "usage": {
    "input_images": 0,
    "generated_images": 1
  }
}
```

В поле `model` ответа указано имя модели BytePlus `dola-seedream-5-5-261028`, это нормально. Запрос 2K обычно выполняется 25–35 секунд, 1K — 12–20 секунд.

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

Пример сохраняет файл с расширением по `output_format` из ответа:

```python theme={null}
import base64
import os
from pathlib import Path

import requests

response = requests.post(
    "https://api.laozhang.ai/v1/images/generations",
    headers={"Authorization": f"Bearer {os.environ['LAOZHANG_API_KEY']}"},
    json={
        "model": "seedream-5-5-261028",
        "prompt": (
            "A cozy bookstore window at night with warm light, a cat sleeping on a "
            'stack of books, and a hand-lettered sign that reads "OPEN LATE"'
        ),
        "size": "2K",
        "watermark": False,
    },
    timeout=180,
)
response.raise_for_status()
item = response.json()["data"][0]

if item.get("b64_json"):
    value = item["b64_json"].split(",", 1)[-1]
    image = base64.b64decode(value + "=" * (-len(value) % 4))
else:
    download = requests.get(item["url"], timeout=120)
    download.raise_for_status()
    image = download.content

extension = "jpg" if item["output_format"] == "jpeg" else "png"
output = Path(f"bookstore.{extension}")
output.write_bytes(image)
print(f"Сохранено: {output}, {item['size']}")
```

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

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

Передайте `"background": "transparent"` и `"output_format": "png"`, и модель вернёт RGBA-изображение без фона. Так сделан пример с кружкой выше:

```bash theme={null}
curl --fail-with-body --max-time 180 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5-261028",
    "prompt": "A ceramic coffee mug with small blue flowers, product shot",
    "background": "transparent",
    "output_format": "png",
    "size": "1K",
    "watermark": false
  }' \
  -o seedream55-transparent.json

python3 save_result.py seedream55-transparent.json mug
```

В ответе у изображения будет `"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:

```bash theme={null}
IMG1=$(base64 < product.png | tr -d '\n')
IMG2=$(base64 < scene.jpg | tr -d '\n')

curl --fail-with-body --max-time 180 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- \
  -o seedream55-edit.json <<EOF
{
  "model": "seedream-5-5-261028",
  "prompt": "Place the product from image 1 on the table in the scene from image 2. Keep the product shape, label and colors.",
  "image": [
    "data:image/png;base64,$IMG1",
    "data:image/jpeg;base64,$IMG2"
  ],
  "size": "2K",
  "watermark": false
}
EOF

python3 save_result.py seedream55-edit.json product-scene
```

Этот запрос стоит \$0.051: \$0.035 за изображение на выходе и по \$0.008 за каждый из двух референсов. Ограничения на формат, размер и пиксели каждого референса те же, что у других версий Seedream, см. [вопрос о локальных изображениях](https://docs.laozhang.ai/ru/api-capabilities/seedream-image.md#как-передать-локальное-изображение-и-какие-есть-ограничения) на странице 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` с текстом и его стилем. Для художественных надписей и рукописного текста оно не возвращается.

```bash theme={null}
curl --fail-with-body --max-time 360 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5-261028",
    "image": "https://example.com/your-poster.jpg",
    "layer_decomposition": true,
    "layer_decomposition_options": {
      "max_images": 6,
      "text_recognition": true
    },
    "size": "1K",
    "watermark": false
  }' \
  -o seedream55-layers.json

python3 save_result.py seedream55-layers.json layer
```

Замените URL в `image` на своё изображение или передайте data URL. Так выглядит текстовый слой из разбиения постера (элемент `data[]`, сокращён):

```json theme={null}
{
  "size": "1616x649",
  "output_format": "png",
  "z_index": 2,
  "bounding_box": {"absolute": [0, 0, 836, 336], "normalized": [0, 0, 1000, 268]},
  "name": "Bold uppercase text \"SUMMER\"",
  "background": "transparent",
  "text_recognition": {
    "text": "SUMMER",
    "lines": [{"runs": [{"text": "SUMMER", "style": {"similar_font_family": "TikTok Sans", "foreground_color": "#FFFFFF", "bold": true, "italic": false}}]}]
  }
}
```

Что есть в слое:

* `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`. Описание всех полей — в разделе [Ответ с разбиением на слои](https://docs.laozhang.ai/ru/api-capabilities/seedream-image.md#ответ-с-разбиением-на-слои), а готовый скрипт на Pillow — в разделе [Сохранение слоёв и обратная сборка](https://docs.laozhang.ai/ru/api-capabilities/seedream-image.md#сохранение-слоёв-и-обратная-сборка) на странице Seedream API. Он подходит и для ответа Seedream 5.5.

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

| Параметр | Тип | Описание |
| - | - | - |
| `model` | string | `seedream-5-5-261028` или `dola-seedream-5-5-261028`, цена одна |
| `prompt` | string | Описание изображения или инструкция для правки |
| `image` | string или array | Референс или массив до 10; публичный URL или data URL. Для слоёв ровно один |
| `size` | string | `1K`, `1.5K`, `2K` (по умолчанию) или `WIDTHxHEIGHT` |
| `output_format` | string | `png` (по умолчанию) или `jpeg` |
| `background` | string | `auto` (по умолчанию), `transparent` или `opaque` |
| `layer_decomposition` | boolean | `true` — разбиение на фон и слои |
| `layer_decomposition_options` | object | `max_images` (2–100, по умолчанию 30) и `text_recognition` |
| `optimize_prompt_options.mode` | string | Только `standard` |
| `watermark` | boolean | По умолчанию `true` (метка «AI generated»); `false` — без неё |
| `response_format` | string | `url` (по умолчанию) или `b64_json` |

Ограничения `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, включая первый.

| Запрос | Изображений на выходе | Референсов | Списание |
| - | - | - | - |
| Генерация по тексту | 1 | 0 | \$0.035 |
| Правка по одному референсу | 1 | 1 | \$0.043 |
| Правка по двум референсам | 1 | 2 | \$0.051 |
| Правка по десяти референсам | 1 | 10 | \$0.115 |
| Разбиение на 6 изображений | 6 | 1 | \$0.218 |

* Ответы с кодом не 200 (ошибка параметров, блокировка модерацией) не оплачиваются.
* Таймаут клиента запрос не отменяет: если сервер успел создать изображение, оно оплачивается. Прежде чем повторять запрос, проверьте [журнал вызовов](https://docs.laozhang.ai/en/faq/call-logs.md) (на английском).
* Фактические списания по каждому запросу видны в журнале вызовов.

> [!WARNING]
>
> **Разбиение на слои оплачивается за каждое возвращённое изображение, включая фон.**
>
> * Сколько слоёв вернуть, решает модель, в пределах `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, и такой запрос не оплачивается. В тексте ошибки будет фрагмент:

```text theme={null}
must be standard for Seedream 5.5
```

Удалите поле или передайте `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](https://docs.laozhang.ai/ru/api-capabilities/seedream-image.md).

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

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

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

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

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

* [Seedream API](https://docs.laozhang.ai/ru/api-capabilities/seedream-image.md): Seedream 5.0 Flash, 5.0 Pro, 5.0, 4.5 и 4.0, обратная сборка слоёв
* [Сравнение API изображений](https://docs.laozhang.ai/ru/api-capabilities/image-generation-guide.md): Seedream рядом с другими моделями изображений
* [Images API](https://docs.laozhang.ai/ru/api-reference/images.md#сохранение-изображений-из-ответа): общий формат ответа и скрипт сохранения изображений
* [Цены на API моделей ИИ](https://docs.laozhang.ai/ru/models.md): актуальные цены и группы
* [Журнал вызовов](https://docs.laozhang.ai/en/faq/call-logs.md) (на английском): модель и списание по каждому запросу

### Источники

* [API генерации изображений BytePlus ModelArk](https://docs.byteplus.com/en/docs/ModelArk/1541523) (на английском): параметры запроса Seedream 5.5, `background` и разбиение на слои, проверено 13 ноября 2026 года
* [Список моделей BytePlus ModelArk](https://docs.byteplus.com/en/docs/modelark/model-list) (на английском): версии моделей Seedream


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.