Seedream 5.0 Pro

Seedream 5.0 Pro — модель изображений от ByteDance. Один запрос создаёт одно изображение из промпта, из промпта и до 10 референсов либо разделяет одно изображение на фоновую подложку и до 16 прозрачных слоёв. Отправьте запрос, сохраните возвращённый идентификатор задачи и получите готовые изображения из задачи. Референсы передаются как URL.

ID моделей

Актуальные цены — на странице модели.

Краткий пример

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

Конечная точка

POST https://api.seedrouter.ai/v1/images/generations

В ответе приходит задача ({"id": "task_...", "status": "processing"}), а не готовое изображение. Результат получайте опросом GET /v1/tasks/{task_id}. Храните API-ключи в серверном коде. Референсы и разделение на слои передаются в том же запросе через image; /v1/images/edits для этой модели не используется и возвращает 400.

Параметры

Поля вне этого списка удаляются перед передачей запроса; они не вызывают ошибку и не меняют результат. n, stream, seed, response_format и последовательная генерация недоступны. callback_url недоступен; вместо этого опрашивайте задачу.

Размер вывода

Уровень задаёт масштаб, а промпт — форму кадра. Укажите соотношение сторон в prompt (например, «горизонтальный кадр 16:9»), и модель подберёт кадр:

Для фиксированного кадра отправьте точные размеры в пикселях вместо уровня. 1K и 1.5K стоят одинаково; 2K и любой размер свыше 2,61 миллиона пикселей стоят дороже (см. Факторы стоимости).

Референсы

Передайте одно изображение для правки или 2–10 для объединения и укажите в prompt, что сохранить и что изменить. Ссылайтесь на них по порядку («куртка с изображения 1»).

{
  "model": "seedream-5-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

Разделение на слои

Отправьте ровно одно изображение с layer_decomposition: true. Задача возвращает сначала фоновую подложку, затем каждый слой как прозрачный PNG.

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

Каждый слой содержит z_index (у фоновой подложки — 0; большие числа означают расположение выше), name, description и bounding_box. bounding_box.absolute — это [left, top, right, bottom] в пикселях фоновой подложки; bounding_box.normalized — та же рамка в тысячных долях ширины и высоты фоновой подложки. Чтобы собрать картинку заново, масштабируйте каждый слой до его рамки и поместите на фоновую подложку в порядке возрастания z_index.

При size: "auto" фоновая подложка и каждый слой сохраняют свой размер во входном изображении. Вход должен быть PNG или JPEG с общим числом пикселей (ширина × высота) от 262 144 (512 × 512) до 36 000 000 (6000 × 6000).

Прозрачный фон

Отправьте один PNG с альфа-каналом и background: "transparent", чтобы получить PNG с прозрачным фоном:

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

Медиавходы

Каждый референс — это публичный URL по HTTP(S). Data URI в base64 не принимаются: загрузите файл в собственное хранилище и передайте его URL. Принимаются JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC и HEIF, до 30 МБ каждый, с соотношением сторон от 1:16 до 16:1, шириной и высотой больше 14 пикселей и общим числом пикселей не более 36 000 000. Разделение на слои принимает только PNG или JPEG.

Факторы стоимости

Актуальные тарифы смотрите в разделе цен модели. Seedream 5.0 Pro оплачивается за выходное изображение по сценарию и пиксельному уровню, плюс каждый референс после первого:

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

• Нижний ценовой уровень охватывает изображения до 2,61 миллиона пикселей (1.5K и ниже); всё крупнее относится к верхнему уровню.
• При разделении на слои оплачиваются фоновая подложка и каждый слой. Для всего запроса действует один ценовой уровень: нижняя цена применяется, только если каждое возвращённое изображение укладывается в 2,61 миллиона пикселей.
• Сумма, резервируемая при приёме задачи, покрывает максимальный результат: одно изображение запрошенного уровня либо 17 изображений при разделении на слои (auto считается верхним уровнем). Затем списывается стоимость фактически возвращённых изображений, а разница освобождается.

Итоговые списания смотрите в истории использования своей учётной записи. Неудачные задачи не оплачиваются.

Схема вывода

При отправке возвращается задача:

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

Получение задачи

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Опрашивайте каждые 10–20 секунд, пока status не станет completed или failed. Сетевой тайм-аут во время опроса не означает, что генерация завершилась сбоем: сохраните идентификатор задачи и продолжите проверку. Не создавайте другую задачу, чтобы узнать ход выполнения.

Выполненная задача

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

Задача разделения на слои перечисляет сначала фоновую подложку, затем каждый слой:

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

В наших тестах изображение 1K занимало около 35–55 секунд, а разделение на слои в 1K, вернувшее фоновую подложку и 13 слоёв, — около 140 секунд.

Ошибки

Запросы, отклонённые до создания задачи, возвращают HTTP-ошибку вместе с объектом error и не оплачиваются. Задача, которая завершилась сбоем уже после приёма, при запросе возвращает HTTP 200 с status: "failed" и объектом error.

Коды, HTTP-статусы и рекомендации по повторным попыткам приведены в общем каталоге ошибок.

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Если тайм-аут произошёл при самой отправке, сначала проверьте свои задачи и только потом отправляйте повторно: первый запрос мог быть уже принят.

Советы

• Начните с 1K или 1.5K для пробных версий; 1.5K стоит столько же, сколько 1K.
• При выборе уровня указывайте форму кадра в промпте либо отправляйте точные размеры в пикселях для фиксированного макета.
• При нескольких референсах объясните, что взять из каждого, и ссылайтесь на них по порядку.
• Установите watermark: false, когда нужно изображение без отметки; по умолчанию отметка добавляется.
• Для разделения на слои перечислите нужные элементы, чтобы число слоёв оставалось небольшим.

Связанные материалы

• Playground и цены Seedream 5.0 Pro
• Скачать OpenAPI
• Markdown для копирования