ToAPIsToAPIs
Seedream-5.5

Seedream-5.5: генерация изображений

Генерация и редактирование в Seedream 5.5: 1K/1.5K/2K, прозрачный PNG и разложение на слои

POST
/v1/images/generations

Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.

Используйте doubao-seedream-5-5 для генерации по тексту, редактирования по референсам и разложения на слои. Запрос возвращает ID задачи; результат нужно получить отдельным запросом.

Обычная генерация возвращает одно изображение, а разложение на слои - базовое изображение и слои.

Authorizations

Authorizationstringзаголовокобязательно

Все API требуют аутентификации Bearer Token

Получите API Key на странице управления API Key

Добавьте в заголовок запроса:

Authorization: Bearer YOUR_API_KEY

Body

modelstringтелообязательнопо умолчанию: doubao-seedream-5-5

Название модели для генерации изображений

Пример: "doubao-seedream-5-5"

promptstringтело

Текстовое описание, обязательное для обычной генерации и редактирования. При включенном layer_decomposition его можно опустить, чтобы модель сама определила элементы для разделения.

sizestringтело

Допустимы уровни 1K, 1.5K, 2K или размеры в пикселях, например 2048x2048. Уровень не фиксирует пропорции; явный размер обычной генерации должен давать 921600-4624220 пикселей. Обычная генерация использует настроенное разрешение модели, либо 2K, если оно не настроено. При разделении на слои пропуск размера означает auto. В примерах явно указан 2K, это не значение по умолчанию для слоёв.

Разделение на слои принимает только auto, 1K, 1.5K или 2K и сохраняет пропорции исходного изображения. Явные размеры в пикселях в этом режиме не поддерживаются. Для обычной генерации отношение ширины к высоте должно быть от 1/16 до 16.

nintegerтелопо умолчанию: 1

Укажите 1 или опустите для одного обычного изображения. Это не число слоёв; при разделении также опустите или укажите 1.

image_urlsstring[]тело

URL референсных изображений для редактирования и работы с несколькими референсами.

  • До 10 референсных изображений.
  • Только общедоступные HTTP/HTTPS URL; передача base64 напрямую не поддерживается.
  • Локальные изображения сначала загрузите через API загрузки изображений.
  • Также поддерживаются массивы reference_images и images.
  • Максимальный размер каждого референса - 30 MB. Разделение на слои принимает только JPEG или PNG.
imagestringтело

Строка URL одного референса. Для нескольких изображений используйте image_urls, а не массив в поле image.

layer_decompositionbooleanтелопо умолчанию: false

Для обычной генерации и редактирования изображений опустите этот параметр или задайте false. Если опция включена, отсутствие референса или несколько референсов делают запрос недопустимым.

Значение true разделяет ровно один референс на слои. Поле prompt можно опустить. Не передавайте параметры последовательной генерации. Результат содержит базовое изображение и прозрачные слои PNG с z_index, сведениями о расположении и именами.

layer_decomposition_optionsobjectтело

Используйте только при layer_decomposition=true. max_images - целое число от 2 до 100, ограничивающее общее число результатов, включая базовое изображение. По умолчанию 30. Фактическое число определяет модель, оно может быть меньше лимита. text_recognition - логическое значение, по умолчанию false. Объект также можно передать в metadata.layer_decomposition_options.

optimize_prompt_optionsobjectтело

Настройки оптимизации промпта: {"mode": "standard"}. Seedream 5.5 отклоняет fast.

metadataobjectтело

Специфичные параметры для расширенной настройки модели Seedream 5.5

Свойства metadata
output_formatstringтелопо умолчанию: png

Допустимы png и jpeg, по умолчанию png. Прозрачность требует PNG, JPEG недопустим. При разделении параметр задаёт формат только базы; остальные слои всегда прозрачные PNG.

backgroundstringтело

При layer_decomposition=true полностью опустите background, даже значение opaque не поддерживается. Этот параметр доступен только для обычной генерации и редактирования изображений.

Допустимы auto, opaque и transparent. Прозрачный фон несовместим с output_format=jpeg. Если при transparent формат не указан, выбирается PNG.

Для обычной генерации значение по умолчанию - auto: модель определяет прозрачность по промпту и формату вывода. JPEG всегда непрозрачен.

watermarkbooleanтелопо умолчанию: false

Управляет видимым водяным знаком AI generated. Значение false отключает его, true включает. Это не означает удаления метаданных происхождения или невидимых меток.

response_formatstringтелопо умолчанию: url

На этой странице используется режим url. URL изображений доступны в результате асинхронной задачи.

Ограничения параметров

Обычная генерация нескольких изображений не поддерживается. Не передавайте sequential_image_generation и sequential_image_generation_options: вышестоящий API отклоняет даже disabled. Значение stream=true не поддерживается. Опустите stream или используйте false. Текущий API не поддерживает веб-поиск через tools и параметр seed.

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

Успешная отправка не означает завершения генерации. Запрашивайте задачу с тем же API Key. Возможные статусы: pending, queued, in_progress, completed, failed. При завершении читайте result.data, при ошибке - error.

curl "https://toapis.com/v1/images/generations/TASK_ID" \
  -H "Authorization: Bearer $TOAPIS_API_KEY"

Response

idstring

Уникальный идентификатор задачи для запроса статуса

objectstring

Тип объекта, всегда generation.task

modelstring

Название используемой модели

statusstring

Статус задачи

  • pending, queued - В очереди
  • in_progress - Обрабатывается
  • completed - Успешно завершена
  • failed - Ошибка
progressinteger

Прогресс задачи в процентах (0-100)

created_atinteger

Временная метка создания задачи (Unix timestamp)

metadataobject

Метаданные задачи

result.dataarray

Список готовых изображений: один элемент для обычной генерации, несколько для разложения на слои.

result.data[]object

URL изображения, фактический размер в пикселях и формат.

result.data[].z_indexinteger

Порядок наложения слоев. 0 обозначает базовое изображение. Остальные слои могут содержать bounding_box, name, description.

result.data[].backgroundstring

Фактический тип фона, если его вернул поставщик: opaque или transparent. При разделении база имеет фон opaque, остальные слои - transparent. Поле опущено для старых задач и моделей, не возвращающих эти сведения.

result.data[].text_recognitionobject

Результат распознавания текста для этого слоя, если его вернул поставщик. Поле может отсутствовать даже при включенном text_recognition.

Объект содержит полный text и массив строк lines. Каждая строка содержит bounding_box и runs; runs[].style сохраняет шрифт, цвет и другие сведения поставщика.

Перед запуском задайте переменную окружения TOAPIS_API_KEY. Замените адреса референсов на example.com доступными URL изображений.

Пример запроса

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedream-5-5",
  "prompt": "A red toy sailboat and a small yellow sun, isolated objects, no text.",
  "size": "2K",
  "metadata": {
    "output_format": "png",
    "background": "transparent",
    "watermark": false,
    "response_format": "url"
  }
}'
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedream-5-5",
  "prompt": "Combine the subjects from both references into one product illustration.",
  "size": "2K",
  "image_urls": [
    "https://example.com/reference-front.png",
    "https://example.com/reference-side.jpg"
  ],
  "metadata": {
    "output_format": "png",
    "watermark": false,
    "response_format": "url"
  }
}'
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedream-5-5",
  "image": "https://example.com/composition.png",
  "layer_decomposition": true,
  "layer_decomposition_options": {"max_images": 30, "text_recognition": true},
  "size": "2K",
  "metadata": {
    "output_format": "png",
    "watermark": false,
    "response_format": "url"
  }
}'

Пример ответа

{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "doubao-seedream-5-5",
  "status": "pending",
  "progress": 0,
  "created_at": 1794300000,
  "metadata": {}
}
{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "doubao-seedream-5-5",
  "status": "completed",
  "progress": 100,
  "created_at": 1794300000,
  "metadata": {},
  "result": {
    "type": "image",
    "data": [
      {
        "url": "https://files.toapis.com/images/example/seedream-5-5.png",
        "size": "2512x1680",
        "output_format": "png"
      }
    ]
  }
}