Интеграция Seedream 5.0 Pro Layer Decomposition API
Используйте Seedream 5.0 Pro Layer Decomposition через Rivya Public API v1: ID модели seedream-5-pro-layer-decomposition, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.
seedream-5-pro-layer-decomposition
file
Требуется для референсных режимов
per_image · 1K=7 · 1.5K=7 · 2K=14 · auto_reserve=14 · ⌈total⌉
Изображение
FIXED
5000 символов
Контракт запроса
Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.
| Ключ | Тип | Обязательно | По умолчанию | Описание |
|---|---|---|---|---|
| model | string | Да | seedream-5-pro-layer-decomposition | Используйте seedream-5-pro-layer-decomposition как ID модели API. |
| prompt | string | Нет | - | Максимум 5000 символов для этой модели. |
| params | object | Нет | - | Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже. |
| client_request_id | string | Нет | - | Необязательный клиентский id для трассировки запросов в вашей системе. |
Параметры модели
| Ключ | Тип | Обязательно | По умолчанию | Диапазон | Варианты | Описание |
|---|---|---|---|---|---|---|
| size | select | Нет | auto | - | auto, 1K, 1.5K, 2K | Размер результата |
| output_format | select | Нет | jpeg | - | jpeg, png | Эта настройка определяет формат базового изображения. Отделенные слои возвращаются как PNG-файлы. |
Политика загрузки
Сначала загрузите референсные файлы, затем поместите возвращенный URL и токен длительности в params.referenceMediaItems.
Исходное изображение: Загрузите ровно один файл PNG, JPEG, WebP, BMP, TIFF или GIF размером до 30 MB; HEIC и HEIF не поддерживаются.
1
image
Видео- и аудио-референсы должны передавать поле durationToken из /api/v1/files, когда требуется проверка длительности.
| kind | Макс. размер | MIME-типы |
|---|---|---|
| image | 30 MB | image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff |
Минимальный запрос
{
"model": "seedream-5-pro-layer-decomposition",
"params": {
"size": "auto",
"output_format": "jpeg"
}
}Запрос с референсным файлом
{
"model": "seedream-5-pro-layer-decomposition",
"params": {
"size": "auto",
"output_format": "jpeg",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png",
"width": 1024,
"height": 1024,
"sizeBytes": 1048576,
"imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
}
]
}
}Ответ создания
Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.
{
"id": "task_seedream_5_pro_layer_decomposition_example",
"status": "queued",
"model": "seedream-5-pro-layer-decomposition",
"reserved_credits": 7,
"final_credits": 0,
"settlement_status": "RESERVED",
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Распространенные ошибки
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Некоторым режимам нужны референсные файлы, загруженные через Files API.