Skip to main content
POST

Авторизация

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

Тело запроса

string
по умолчанию:"seedream-5-0-lite"
обязательно
Название модели генерации изображенийПоддерживаемые модели: seedream-5-0-lite, seedream-5.0-lite, Seedream-5.0-liteПример: "seedream-5-0-lite"
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации изображения
string
по умолчанию:"1:1"
Соотношение сторон изображенияПоддерживаемые соотношения сторон:
  • 1:1 — квадрат (по умолчанию)
  • 4:3 — горизонтальный 4:3
  • 3:4 — вертикальный 3:4
  • 16:9 — горизонтальный широкоформатный
  • 9:16 — вертикальный
  • 3:2 — горизонтальный 3:2
  • 2:3 — вертикальный 2:3
  • 2:1 — Вытянутый горизонтальный формат
  • 1:2 — Вытянутый вертикальный формат
  • 21:9 — сверхширокий
  • auto — автоматически подбирать соотношение сторон по референсному изображению (требуется image_urls)
2x1 эквивалентно 2:1, а 1x21:2. Символ x должен быть строчным; пробелы не допускаются.
Примечание: Seedream-5.0-Lite не поддерживает соотношение 9:21
string
по умолчанию:"2K"
Разрешение изображенияПоддерживаемые разрешения:
  • 2K — стандартное разрешение (по умолчанию)
  • 3K — высокое разрешение
  • 4K — сверхвысокое разрешение
Примечание: Seedream-5.0-Lite поддерживает разрешения 2K, 3K и 4K, но не поддерживает 1K
Справочные размеры для разрешений:
integer
Количество генерируемых изображенийДиапазон: 1–15По умолчанию: 1Примечание:
  • Когда n > 1, режим последовательной генерации включается автоматически
  • Необходимо указывать обычное число (например, 1), не используйте кавычки, иначе это вызовет ошибку
Списание будет произведено заранее на основе количества
Количество референсных изображений в image_urls + итоговое количество генерируемых изображений, указанное в n, должно быть ≤ 15.
array
Список URL референсных изображений для генерации image-to-imageПоддерживаются два формата:1. Полный URL изображения
  • Публично доступный URL изображения (http:// или https://)
  • Пример: https://example.com/image.jpg
2. Формат Base64
  • Необходимо использовать полный формат Data URI
  • Формат: data:image/{format};base64,{base64-данные}
  • Поддерживаемые форматы изображений: jpeg, png
  • Пример: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • Внимание: префикс data:image/jpeg;base64, обязателен
Ограничения:
  • Форматы изображений: jpeg, png
  • Диапазон соотношения сторон (ширина/высота): [1/3, 3]
  • Ширина и высота (px) > 14
  • Размер: не более 10MB на изображение
  • Общее количество пикселей: не более 6000×6000 px
Количество референсных изображений в image_urls + итоговое количество генерируемых изображений, указанное в n, должно быть ≤ 15.
string
по умолчанию:"jpeg"
Формат выходного изображения
  • jpeg: формат JPEG (по умолчанию)
  • png: формат PNG, подходит для прозрачного фона и аналогичных случаев
Примечание: Параметр output_format является эксклюзивным для Seedream-5.0-Lite. Другие модели изображений игнорируют этот параметр.
string
по умолчанию:"disabled"
Режим последовательной генерации изображенийУправляет генерацией нескольких изображений:
  • disabled: отключить последовательный режим (по умолчанию)
  • auto: включить последовательный режим, можно генерировать несколько изображений
Заметки по использованию:
  • Когда n > 1, режим автоматически установится в auto
object
Параметры последовательной генерации изображенийДоступно, когда sequential_image_generation установлено в autoСвойства:
  • max_images (integer): задаёт количество генерируемых изображений
Пример:
boolean
по умолчанию:"false"
Добавлять ли водяной знак к сгенерированному изображению
  • true: добавить водяной знак
  • false: без водяного знака (по умолчанию)

Ответ

integer
Код состояния ответа
array
Массив данных ответа