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

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телопо умолчанию: 2K

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

image_urlsstring[]тело

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

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

imagestringтело

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

layer_decompositionbooleanтело

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

optimize_prompt_optionsobjectтело

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

metadataobjectтело

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

Свойства metadata

metadata.output_formatstringтелопо умолчанию: png

Формат результата: png или jpeg. Для прозрачного фона используйте png.

metadata.backgroundstringтело

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

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

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

metadata.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

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

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.

Перед запуском задайте переменную окружения 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,
  "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"
      }
    ]
  }
}