# API Seedream 5.5 (https://wanapi.app/ru/docs/seedream-5-5)





Seedream 5.5 создаёт одно изображение по тексту или с использованием до 10 референсных изображений. Разделение на слои принимает одно изображение и возвращает основу и прозрачные слои с необязательным результатом распознавания печатного текста.

[Попробовать Playground](/ru/models/seedream-5-5#playground) · [OpenAPI JSON](/models/seedream-5-5/openapi.json) · [Руководство по интеграции](/ru/blog/seedream-5-5-api-guide)

## Аутентификация и конечные точки [#аутентификация-и-конечные-точки]

Используйте ключ Wan API как токен Bearer. Один ключ открывает доступ ко всем доступным моделям и группам; выбирать группу для ключа не требуется.

| Метод | URL                                                       | Назначение                        |
| ----- | --------------------------------------------------------- | --------------------------------- |
| POST  | `https://api.wanapi.app/seedream55/v1/images/generations` | Отправить одну задачу изображения |
| GET   | `https://api.wanapi.app/seedream55/v1/tasks/{id}`         | Прочитать эту задачу              |

ID модели — &#x2A;*`seedream-5-5`**. Это асинхронные конечные точки. Отправьте запрос один раз, сохраните ID задачи и опрашивайте её до `completed` или `failed`. Неопределённый сетевой ответ не даёт оснований повторять отправку.

## Создание изображения [#создание-изображения]

```bash
curl https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
    "size": "1K"
  }'
```

Принятый запрос возвращает задачу, а не байты изображения:

```json
{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
```

```bash
curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
  -H "Authorization: Bearer $WAN_API_KEY"
```

Опрашивайте тот же ID каждые несколько секунд. Сохраните его, если приложение прекращает ожидание, чтобы возобновить опрос позднее. ID задач и временные метки в этом руководстве приведены для примера.

## Параметры [#параметры]

| Параметр                                       | Тип                | По умолчанию              | Правила                                                                                                   |
| ---------------------------------------------- | ------------------ | ------------------------- | --------------------------------------------------------------------------------------------------------- |
| `model`                                        | строка             | обязателен                | `seedream-5-5`                                                                                            |
| `prompt`                                       | строка             | обязателен для генерации  | Необязателен для разделения на слои.                                                                      |
| `image`                                        | URL или массив URL | нет                       | До 10 референсов; ровно один для слоёв. Каждый референс оплачивается.                                     |
| `size`                                         | строка             | `2K` или `auto` для слоёв | См. правила размеров ниже.                                                                                |
| `output_format`                                | строка             | `png`                     | `png` или `jpeg`. Для слоёв определяет только основное изображение.                                       |
| `background`                                   | строка             | `auto`                    | `auto`, `opaque`, `transparent`. Для прозрачности требуется PNG. Полностью исключите поле в режиме слоёв. |
| `layer_decomposition`                          | логический         | `false`                   | Разделить один референс на основное изображение и прозрачные слои PNG.                                    |
| `layer_decomposition_options.max_images`       | целое число        | `30`                      | Общий лимит 2–100 изображений, включая основное. Только для режима слоёв.                                 |
| `layer_decomposition_options.text_recognition` | логический         | `false`                   | Запросить метаданные печатного текста в слоях. Только для режима слоёв.                                   |
| `optimize_prompt_options.mode`                 | строка             | `standard`                | Поддерживается только режим `standard`.                                                                   |
| `watermark`                                    | логический         | `false`                   | Запросить водяной знак о генерации ИИ.                                                                    |
| `content_filter`                               | логический         | `true`                    | Клиентский API принимает false. В Playground отключать проверку могут только администраторы.              |

Параметры `n`, `seed`, `stream`, `resolution`, `aspect_ratio`, `image_urls` и `response_format` не поддерживаются. Недокументированные поля отбрасываются и не включают эти возможности. Загрузка multipart, Base64 и data URI отклоняются.

## Размер результата [#размер-результата]

Генерация принимает `1K`, `1.5K`, `2K` или точные размеры `WIDTHxHEIGHT` в пикселях. Общая площадь должна составлять **921 600–4 624 220 пикселей**, а соотношение сторон — от **1:16 до 16:1**. Например, `2048x1152` допустимо. Соотношение вроде `16:9` не является значением размера.

Разделение на слои принимает `auto`, `1K`, `1.5K` или `2K`; точные размеры в пикселях в этом режиме не поддерживаются. `auto` следует исходному размеру и резервирует стоимость по большему тарифу результата. Готовых размеров 3K и 4K у модели нет.

<span id="reference-images-and-editing" />

## Референсные изображения и редактирование [#референсные-изображения-и-редактирование]

Передавайте общедоступные HTTP(S) URL размещённых вами файлов без встроенных учётных данных. Поддерживаются JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC и HEIF, до 30 МБ на изображение и не более 36 000 000 пикселей всего. AVIF и JP2 не поддерживаются. URL должен отдавать изображение напрямую, без входа в аккаунт или браузерной проверки.

```json
{
  "model": "seedream-5-5",
  "prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
  "image": "https://your-cdn.example/lighthouse.jpg",
  "size": "2K"
}
```

Для нескольких референсов передайте массив URL и объясните роль каждого изображения в промпте. Результатом по-прежнему будет одно изображение. URL референсов в примерах — заполнители: замените их своими доступными файлами.

## Разделение на слои и распознавание текста [#разделение-на-слои-и-распознавание-текста]

```json
{
  "model": "seedream-5-5",
  "image": "https://your-cdn.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  }
}
```

Лимит включает основное изображение; `4` означает не более четырёх полученных изображений, а не четыре слоя плюс основа. Модель может вернуть меньше. Не передавайте `prompt` для автоматического разделения или назовите элементы для отделения. Промпт может подавить исключённый им текст.

Слои — это файлы PNG с прозрачностью. Восстанавливайте изображение по возрастанию `z_index`, с основой на 0. Если задан ограничивающий прямоугольник, перед размещением измените размер слоя под него: пиксельные размеры файла слоя могут отличаться от размеров его размещения.

Необязательное поле `text_recognition` содержит полный `text` и `lines`. Каждая строка может включать `bounding_box` и оформленные фрагменты `runs`. Поле `style` фрагмента может включать `similar_font_family`, `foreground_color` (`#RRGGBB`), `bold`, `italic`, `underline`, `strikethrough`, `shadow` и `translucent`. Это оценки модели. Для художественных или рукописных надписей текстовый результат может отсутствовать; считайте поле необязательным.

## Ответ завершённой задачи [#ответ-завершённой-задачи]

```json
{
  "id": "task_example",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794432000,
  "output": {
    "data": [
      {
        "url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
        "size": "1248x832",
        "output_format": "png"
      }
    ]
  }
}
```

У каждого изображения есть `url` и `size`. Другие поля могут включать `output_format`, `background`, `z_index`, `name`, `description`, `bounding_box` и `text_recognition`. `bounding_box.absolute` — это `[left, top, right, bottom]` в пикселях основного изображения. `bounding_box.normalized` использует те же координаты в масштабе 0–1000. Не считайте, что необязательные метаданные есть у каждого изображения.

Считайте URL изображений приватными ссылками для скачивания и сохраняйте нужные файлы. URL с токеном `access` можно открыть, не раскрывая ключ API аккаунта.

## Цены [#цены]

<Seedream55ModelPricing />

Граница тарификации результата — **2 610 000 пикселей**. Рассчитывайте стоимость так:

```text
lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rate
```

Каждый референс оплачивается, включая первый и исходное изображение для слоёв. Генерация и слои используют одинаковые тарифы результата. При отправке резервируется стоимость одного результата или лимита слоёв `max_images` плюс референсов. При завершении используются собственные пиксельные размеры каждого полученного изображения, а неиспользованный резерв освобождается. Принятая задача сохраняет снимок цен, даже если тарифы изменятся во время выполнения. Для неудачных задач средства возвращаются.

## Ошибки и повторные попытки [#ошибки-и-повторные-попытки]

Некорректные параметры отклоняются до отправки. Недостаточный баланс или квота ключа препятствуют генерации. Аутентификация и проверка владельца применяются и к отправке, и к опросу. Неудачная задача возвращает `status: "failed"` с объектом `error`.

Повторяйте неудачное чтение статуса с тем же ID задачи. **Не повторяйте POST генерации автоматически**, в том числе после тайм-аута: запрос уже мог быть принят. Пока вышестоящий сервис сообщает о нормальном ходе выполнения, задача остаётся в ожидании. Если три часа подряд нет нормального статуса вышестоящего сервиса или успешной доставки, задача завершается ошибкой с возвратом средств.

В [руководстве по Seedream 5.5](/ru/blog/seedream-5-5-api-guide) приведён цикл приложения, который сохраняет ID задачи и возобновляет работу с ним.
