Skip to main content
POST

Авторизация

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

Тело запроса

string
по умолчанию:"seedream-4.5"
обязательно
Название модели генерации изображенийПоддерживаемые модели: seedream-4.5, Seedream-4.5, seedream-4-5Пример: "seedream-4.5"
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 — сверхширокий
  • 9:21 — сверхвысокий
  • auto — автоматически подбирать соотношение сторон по референсному изображению (требуется image_urls)
2x1 эквивалентно 2:1, а 1x21:2. Символ x должен быть строчным; пробелы не допускаются.
string
по умолчанию:"2K"
Разрешение изображенияПоддерживаемые разрешения:
  • 2K — стандартное разрешение (по умолчанию)
  • 4K — высокое разрешение
Примечание: Seedream-4.5 не поддерживает разрешение 1K
Справочные размеры для разрешений:
integer
Количество изображений для генерацииДиапазон: 1-15 (минимум 1, максимум 15)По умолчанию: 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
по умолчанию:"standard"
Режим оптимизации промпта
  • standard: стандартный режим, генерирует более качественный контент с увеличенным временем обработки
  • fast: быстрый режим, генерирует контент за меньшее время с обычным качеством
По умолчанию: standard
string
по умолчанию:"disabled"
Режим последовательной генерации изображений (специфическая функция Doubao)Управляет генерацией нескольких изображений:
  • disabled: отключить последовательный режим, генерирует только 1 изображение даже при наличии нескольких референсов (по умолчанию)
  • auto: включить последовательный режим, можно генерировать несколько изображений
Заметки по использованию:
  • Необходимо указать image_urls — требуется минимум 1 референсное изображение
  • Установите n: 3 или используйте sequential_image_generation: "auto" + max_images: 3
  • Будут сгенерированы 3 разных изображения на основе референсов
  • Когда n > 1, режим автоматически установится в auto
Ограничения:
  • Чистый text-to-image (без image_urls) не может генерировать несколько изображений — это ограничение Doubao API
object
Параметры последовательной генерации изображенийДоступно, когда sequential_image_generation установлено в autoСвойства:
  • max_images (integer): задаёт количество генерируемых изображений, диапазон: 1–15
Пример:
boolean
по умолчанию:"false"
Добавлять ли водяной знак к сгенерированному изображению
  • true: добавить водяной знак
  • false: без водяного знака (по умолчанию)

Ответ

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