> ## Documentation Index > Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt > Use this file to discover all available pages before exploring further. # Seedream ## 1. Обзор API генерации изображений Seedream использует формат запросов генерации изображений в стиле OpenAI, поддерживает генерацию по тексту, генерацию по изображению и редактирование изображений. Четыре модели используют один и тот же интерфейс; клиенту достаточно выбрать модель в поле `model` тела запроса. ### Поддерживаемые модели | Клиентский ID модели | Модель | Способ вывода | | ------------------------------ | ----------------- | ------------------------------------- | | `seedream-4-0-250828` | Seedream 4.0 | Одно изображение или набор | | `seedream-4-5-251128` | Seedream 4.5 | Одно изображение или набор | | `seedream-5-0-260128` | Seedream 5.0 Lite | Одно изображение или набор | | `dola-seedream-5-0-pro-260628` | Seedream 5.0 Pro | Одно изображение или разделение слоёв | ## 2. Интерфейс и аутентификация ```http theme={null} POST https://{api_domain}/v3/bytedance/api/v3/images/generations ``` Заголовки запроса: ```http theme={null} Authorization: Bearer Content-Type: application/json ``` `{api_domain}` — домен API вашей платформы. Запрос должен быть POST, тело — JSON. ## 3. Параметры запроса ### 3.1 Общие параметры Используйте ID модели из таблицы выше. Описание изображения, поддерживаются китайский и английский языки. URL референсного изображения или Data URL в Base64. Можно передать одно изображение или массив. Конкретное количество и ограничения по изображениям зависят от выбранной модели. Используйте поддерживаемое моделью разрешение или формат `ширинаxвысота`. Если не указано, используется значение по умолчанию для модели. `url` или `b64_json`, по умолчанию `url`. Поддерживается только Seedream 5.0 Lite и 5.0 Pro: `jpeg` или `png`. Seedream 4.0 и 4.5 всегда выдают JPEG; передача `output_format` будет отклонена. Добавлять ли водяной знак о генерации AI. Интерфейс изображений не поддерживает потоковый вывод, не передавайте `true`. ### 3.2 Параметры, специфичные для моделей | Параметр | Доступные модели | Описание | | ------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `sequential_image_generation` | 4.0, 4.5, 5.0 Lite | Включает генерацию набора изображений. Для набора изображений используйте в соответствии с протоколом вышестоящей модели; если набор не нужен, опустите. | | `sequential_image_generation_options` | 4.0, 4.5, 5.0 Lite | Опции генерации набора, используется вместе с `sequential_image_generation`. | | Разрешения `size`: 1K, 1.5K, 2K | 5.0 Pro | Pro поддерживает эти разрешения, а также явный формат `ширинаxвысота`. Pro не поддерживает параметры набора изображений. В сценарии разделения слоёв поддерживаются только разрешения (включая auto), и активируется через `layer_decomposition: true` (подробнее см. ограничения модели). | Seedream 5.0 Pro не поддерживает `sequential_image_generation` и `sequential_image_generation_options`; передача любого из этих полей будет отклонена. Другие параметры, специфичные для моделей, не отправляйте для Pro. ### 3.3 Пример генерации по тексту Ниже приведён пример запроса для Seedream 5.0 Pro. Все четыре модели используют один и тот же интерфейс; при использовании Seedream 4.0 или 4.5 необходимо удалить `output_format`, это поле можно передавать только для Seedream 5.0 Lite/Pro: ```bash theme={null} curl -sS -X POST "https://{api_domain}/v3/bytedance/api/v3/images/generations" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "model": "dola-seedream-5-0-pro-260628", "prompt": "Золотистый ретривер в красном шарфе, на фоне горного озера при естественном освещении, кинематографичная фотография", "size": "2K", "response_format": "url", "output_format": "jpeg", "watermark": true }' ``` ### 3.4 Пример генерации по изображению `image` может быть отдельным URL, отдельным Data URL в Base64 или массивом строк: ```json theme={null} { "model": "seedream-4-5-251128", "prompt": "Поместите персонажа и одежду с референсного изображения в однородный городской ночной пейзаж, сохраняя согласованность черт", "image": [ "https://example.com/person.png", "https://example.com/outfit.png" ], "size": "2560x1440", "response_format": "url" } ``` ### 3.5 Пример набора изображений (только 4.0, 4.5, 5.0 Lite) Параметры набора применимы к первым трём моделям, пример: ```json theme={null} { "model": "seedream-5-0-260128", "prompt": "Создайте три постера с единым стилем для четырёх сезонов", "sequential_image_generation": "auto", "sequential_image_generation_options": { "max_images": 3 }, "response_format": "url" } ``` Уточните допустимые значения и ограничения по количеству для параметров набора в протоколе вышестоящей модели. ## 4. Ответ Пример успешного ответа: ```json theme={null} { "created": 1786000000, "model": "seedream-4-5-251128", "data": [ { "url": "https://example.com/generated-image.jpeg", "size": "2560x1440", "output_format": "jpeg" } ], "usage": { "generated_images": 1, "input_images": 0 } } ``` * При `response_format=url` возвращается `data[].url`; при `response_format=b64_json` возвращается `data[].b64_json`. * Seedream 4.0, 4.5, 5.0 Lite в режиме набора могут возвращать несколько элементов `data`. * Seedream 5.0 Pro в сценарии генерации изображения возвращает один элемент `data`; при включённом разделении слоёв возвращает несколько элементов `data` (одно базовое изображение + несколько слоёв), каждый дополнительно содержит порядок наложения `z_index` (у базового 0), имя `name`, описание `description` и ограничивающую рамку `bounding_box` (с координатами absolute / normalized, базовое изображение не возвращает это поле). * `model` возвращает использованный клиентский ID модели. * Срок действия URL изображения определяется платформой и вышестоящим сервисом; скачайте и сохраните изображение сразу после получения. ## 5. Ограничения моделей ### Seedream 4.0 / 4.5 / 5.0 Lite * Поддерживают генерацию по тексту, по изображению и набор изображений. * Набор изображений использует `sequential_image_generation` и его опции. * Количество входных изображений, их размер, разрешение и соотношение сторон определяются документацией вышестоящей модели. Seedream 4.0 и 4.5 всегда выдают JPEG, не поддерживают параметр `output_format`; Seedream 5.0 Lite поддерживает `jpeg` и `png`. ### Seedream 5.0 Pro * Поддерживает генерацию по тексту, по одному изображению и слияние нескольких изображений. * В сценарии генерации изображения возвращает одно успешное изображение. При включённом разделении слоёв (`layer_decomposition: true`) возвращает базовое изображение и до 16 слоёв, при этом `data` содержит несколько элементов. Не поддерживает набор изображений (`sequential_image_generation`). * Не поддерживает `sequential_image_generation` и `sequential_image_generation_options`. * `size` может быть 1K, 1.5K, 2K или явным `ширинаxвысота`. * При явных ширине и высоте соотношение сторон и общее количество пикселей должны соответствовать ограничениям модели; фактический размер выходного изображения указан в `data[].size` ответа. * Поддерживает разделение слоёв: при установке `layer_decomposition: true` одно входное изображение разбивается на базовое изображение и до 16 независимо редактируемых слоёв (каждый слой — PNG с альфа-каналом). В этом сценарии `image` обязателен и может содержать только одно изображение; передача нескольких вызовет ошибку. Разделение слоёв работает по принципу «всё или ничего»: если хотя бы один слой не удаётся, весь запрос завершается неудачей, частичный успех не поддерживается. * Правила `size` для разделения слоёв: разрешение базового изображения равно `size`; разрешение каждого слоя близко к `size`, но каждый слой сохраняет соотношение сторон соответствующей области в исходном изображении, поэтому фактические пиксели слоёв различаются. Это означает, что выходные изображения одного запроса могут попадать в разные ценовые категории по пикселям. `size` может быть 1K, 1.5K, 2K, auto, по умолчанию auto. ## 6. Тарификация и использование * 4.0, 4.5 и 5.0 Lite тарифицируются по количеству успешно сгенерированных изображений; для набора изображений — по фактическому количеству успешно выведенных. * 5.0 Pro тарифицируется по успешно выведенным изображениям; при нескольких входных изображениях первое референсное изображение бесплатно, дополнительные тарифицируются отдельно; разные выходные размеры соответствуют разным ценовым категориям. При включённом разделении слоёв базовое изображение и каждый слой считаются одним успешно выведенным изображением и тарифицируются по количеству пикселей `data[].size` в своей ценовой категории (например, базовое изображение может быть в категории высокого разрешения, а некоторые слои — низкого). Итоговый счёт — сумма по каждой категории. * Единица измерения — «шт.» или item. * Конкретные цены смотрите на странице цен вашей платформы. ## 7. Поиск ошибок | Сценарий | Рекомендация | | ------------------------ | ---------------------------------------------------------------------------------------------------- | | Модель не поддерживается | Проверьте, что `model` точно соответствует таблице выше. | | Отсутствует prompt | Тело запроса должно содержать непустой prompt. | | Изображение не читается | Проверьте доступность URL, формат, размер и ограничения по пикселям. | | `stream=true` | Интерфейс изображений не поддерживает потоковый вывод; удалите это поле или установите `false`. | | Pro переданы поля набора | Удалите оба поля `sequential_image_generation*`. | | Неверный `size` | Используйте поддерживаемое разрешение для выбранной модели или `ширинаxвысота` в рамках ограничений. |