# Seedream 5.5 — разбор на слои

Разбор изображения на основу и отдельные PNG-слои с прозрачным фоном.

## Обзор

- **Modality:** Картинки
- **Modes:** Разбор на слои
- **Страница модели:** https://iskragen.ru/models/seedream-5-5-layers
- **`modelSlug` для API:** `seedream-5-5-layer-decomposition`

## Стоимость

- Базовая цена: 4–7 ₽ за `image`

| Тариф | Цена | Примечание |
| --- | --- | --- |
| 1K | 4 ₽ |  |
| 1.5K | 4 ₽ |  |
| 2K | 7 ₽ |  |
| Авто | 7 ₽ |  |

## Сценарии и параметры

### Разбор на слои

- Mode ID: `image-to-image`
- `modelSlug` для API: `seedream-5-5-layer-decomposition`
- Требуется загрузка: до 1 файлов (image/jpeg, image/png, image/webp, до 9.5367431640625 МБ)
- Как передать файл: загрузите его одним запросом `POST /v1/files` (multipart, поле `file`) и подставьте `url` из ответа в `params.image_url`. Прямая загрузка через presigned URL описана в [Generations API](https://iskragen.ru/docs/api-generations.md); для референс-видео Seedance она не подходит — только `POST /v1/files`.

```bash
curl -X POST https://api.iskragen.ru/v1/files \
  -H "Authorization: Bearer iskr_live_..." \
  -F "file=@reference.png"
```

| Поле | Тип | По умолчанию | Диапазон / опции | Описание |
| --- | --- | --- | --- | --- |
| `size` | select | `auto` | `1K`, `1.5K`, `2K`, `auto` |  |
| `output_format` | select | `png` | `png`, `jpeg` |  |
| `max_images` | number | 10 | 2–100 | Удерживаем за максимум, за неотданные картинки сразу вернём. Оплата — за входную картинку и за каждую отданную по тарифу разрешения. |
| `text_recognition` | toggle | false | true / false |  |

## Использование через API

Полный цикл интеграции: API-ключ → создание генерации → polling → результат. Базовый URL: `https://api.iskragen.ru/v1`.

### 1. Получите API-ключ

Личный кабинет → «API-ключи» (https://iskragen.ru/api-keys). Значение показывается один раз. Ключ передаётся в заголовке каждого запроса:

```
Authorization: Bearer iskr_live_<secret>
```

### 2. Создайте генерацию

```bash
curl -X POST https://api.iskragen.ru/v1/generations \
  -H "Authorization: Bearer $ISKRAGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "modelSlug": "seedream-5-5-layer-decomposition",
  "prompt": "Опишите, что вы хотите сгенерировать",
  "params": {
    "size": "auto",
    "output_format": "png",
    "max_images": 10,
    "text_recognition": false
  }
}'
```

Генерация асинхронная: ответ — `202 Accepted`, задача ставится в очередь, стоимость удерживается с баланса.

```json
{
  "id": "0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90",
  "status": "PENDING",
  "costRub": 4
}
```

### 3. Дождитесь результата (polling)

Опрашивайте `GET /v1/generations/{id}` раз в ~2 секунды, пока `status` не станет `SUCCEEDED` или `FAILED`:

```bash
curl https://api.iskragen.ru/v1/generations/$GENERATION_ID \
  -H "Authorization: Bearer $ISKRAGEN_API_KEY"
```

```json
{
  "id": "0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90",
  "status": "SUCCEEDED",
  "outputUrls": ["https://s3.twcstorage.ru/.../result.webp"],
  "costRub": 4,
  "errorCode": null,
  "errorMessage": null
}
```

- `outputUrls` — ссылки на готовые файлы; заполняются при `SUCCEEDED`.
- При `FAILED` средства возвращаются на баланс автоматически, причина — в `errorCode` / `errorMessage`.
- Лимит: 5 одновременных генераций (`PENDING` + `PROCESSING`), при превышении — `429`.
- Для длинных задач (видео, музыка) вместо polling'а используйте [Webhooks](https://iskragen.ru/docs/webhooks.md).

### Полная документация

- Generations API (все поля, image-to-image, ошибки): https://iskragen.ru/docs/api-generations.md
- Аутентификация: https://iskragen.ru/docs/authentication.md
- Ошибки: https://iskragen.ru/docs/errors.md
- Лимиты: https://iskragen.ru/docs/rate-limits.md
- Индекс всей документации для LLM: https://iskragen.ru/llms.txt
- Машиночитаемый каталог моделей (slug, params, цены): https://api.iskragen.ru/v1/catalog
