Seedream

​

1. Обзор

​

Поддерживаемые модели

​

2. Интерфейс и аутентификация

POST https://{api_domain}/v3/bytedance/api/v3/images/generations

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

​

3. Параметры запроса

​

3.1 Общие параметры

​

3.2 Параметры, специфичные для моделей

​

3.3 Пример генерации по тексту

curl -sS -X POST "https://{api_domain}/v3/bytedance/api/v3/images/generations" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -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 Пример генерации по изображению

{
  "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)

{
  "model": "seedream-5-0-260128",
  "prompt": "Создайте три постера с единым стилем для четырёх сезонов",
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": {
    "max_images": 3
  },
  "response_format": "url"
}

​

4. Ответ

{
  "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. Поиск ошибок