Skip to main content
POST
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
  • Seedream 5.0 Pro — модель высококачественной генерации изображений от команды ByteDance Seed
  • Используйте параметр model для выбора модели doubao-seedream-5-0-pro
  • Параметры в основном совпадают с Seedream-5.0, отличие в том, что Pro поддерживает разрешения 1K и 2K
  • Поддерживает генерацию по тексту, по изображению и с несколькими референсами
  • Правила оплаты: первое референсное изображение бесплатно, оплата начисляется со второго референсного изображения
  • Асинхронное управление задачами, запрос результатов по ID задачи
Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 напрямую в image_urls. Пожалуйста, сначала используйте API загрузки изображений для загрузки изображений и получения URL, а затем вызывайте этот эндпоинт.

Авторизация

string
обязательно
Все API требуют аутентификации Bearer TokenПолучите API Key на странице управления API KeyДобавьте в заголовок запроса:

Тело запроса

string
по умолчанию:"doubao-seedream-5-0-pro"
обязательно
Название модели генерации изображенийПример: "doubao-seedream-5-0-pro"
string
обязательно
Текстовое описание для генерации изображения
string
по умолчанию:"1:1"
Соотношение сторон изображенияПри включённом layer_decomposition в этом поле передаётся готовый пресет разрешения 1K или 2K.Поддерживаемые соотношения:
  • 1:1 - Квадрат (по умолчанию)
  • 4:3 - Горизонтальный 4:3
  • 3:4 - Вертикальный 3:4
  • 16:9 - Горизонтальный широкоэкранный
  • 9:16 - Вертикальный длинный
  • 3:2 - Горизонтальный 3:2
  • 2:3 - Вертикальный 2:3
  • 21:9 - Ультраширокий
  • 9:21 - Ультравысокий
integer
по умолчанию:1
Количество генерируемых изображенийДиапазон: 1-10 (минимум 1, максимум 10)По умолчанию: 1Примечание:
  • Суммарное количество референсных изображений + генерируемых изображений должно быть ≤ 15
  • Вводите только число (например 1), не добавляйте кавычки, иначе возникнет ошибка
Предварительное списание выполняется по количеству генерируемых и референсных изображений, при этом первое референсное изображение бесплатно
boolean
по умолчанию:false
Включить уникальную для Seedream 5.0 Pro возможность разделения на слои.
  • false: возвращается обычное плоское изображение (по умолчанию)
  • true: возвращается базовое изображение и несколько независимых PNG-слоёв с альфа-каналом
После включения каждый элемент result.data[] в результате запроса задачи дополнительно возвращает z_index; независимые слои дополнительно возвращают bounding_box, name и description. Параметр поддерживается только в Seedream 5.0 Pro.
string[]
Список URL референсных изображений для изображения-в-изображение или редактирования изображений⚠️ Только формат URL (base64 больше не поддерживается)
  • Публично доступный URL изображения (http:// или https://)
  • Можно использовать API загрузки изображений для загрузки локальных изображений и получения URL
Ограничения:
  • Количество изображений: 1-10
  • Форматы изображений: jpeg, png
  • Диапазон соотношения сторон (ширина/высота): [1/3, 3]
  • Ширина и высота (px) > 14
  • Размер: не более 10 МБ
  • Общее количество пикселей: не более 6000×6000 px
Оплата:
  • Первое референсное изображение бесплатно
  • Со второго референсного изображения оплата начисляется по обычным правилам
object
Специфичные параметры канала для передачи расширенной конфигурации модели Seedream 5.0 Pro

Ответ

string
Уникальный идентификатор задачи для запроса статуса
string
Тип объекта, всегда generation.task
string
Используемое имя модели
string
Статус задачи
  • queued - В очереди на обработку
  • in_progress - Обработка
  • completed - Успешно завершено
  • failed - Не удалось
integer
Процент выполнения задачи (0-100)
integer
Временная метка создания задачи (временная метка Unix)
object
Метаданные задачи
integer
Временная метка завершения задачи (временная метка Unix). Возвращается только после завершения задачи.
integer
Временная метка истечения срока хранения файла результата (временная метка Unix). Скачайте или сохраните файл результата до истечения срока.
object
Результат генерации после успешного завершения задачи. Возвращается только когда status равен completed.
string
Тип результата, для задач изображений всегда image.
array
Список результатов-изображений. При включённом разделении на слои первый элемент обычно является базовым изображением, остальные — независимыми PNG-слоями с альфа-каналом.
string
Публично доступный адрес базового изображения или независимого слоя.
integer
Порядок наложения слоёв. При включённом layer_decomposition базовое изображение обычно 0, а независимые слои идут по возрастанию.
string
Размер текущего базового изображения или независимого слоя в пикселях, например 2048x2048.
string
Формат файла текущего результата. Базовое изображение может быть в запрошенном формате, прозрачные независимые слои — в png.
object
Положение независимого слоя на базовом изображении: содержит absolute (абсолютные координаты) и normalized (нормализованные координаты).
array
Абсолютные пиксельные координаты слоя на базовом изображении в формате [x1, y1, x2, y2], где указаны координаты левого верхнего и правого нижнего углов.
array
Нормализованные координаты слоя в формате [x1, y1, x2, y2], диапазон координат 0-1000.
string
Название слоя.
string
Описание содержимого слоя.